将最高法院司法实践直接置于您的代码中
将最高法院司法实践作为外部工具进行语义搜索。可连接到基于任何 LLM 的应用或任何 HTTP 客户端。一次请求即可返回带有案卷信息、引文和全文链接的真实法律文书。
促销访问权限（10天内300次请求）已结束 2026年6月27日。 新密钥目前不会自动发放，API付费套餐暂时尚未提供。以下条件介绍的是该活动，现保留作为参考：访问权限由人工开通——请通过 @CasusLegalBot 或进入 “消息” 个人账户中的相应栏目联系管理员。文档和代码示例仍然有效。
简而言之：连接器已经能够在您的 Claude、ChatGPT、Grok 或 Hermes 内部完成的操作，现在可以集成到您自己的产品中。
API 密钥是一串很长的秘密字符串，开头为 cl_live_ （例如 cl_live_QZbj…）。将其插入您的代码后，它会为您的服务器或应用开通访问俄罗斯宪法法院、最高法院和最高仲裁法院司法实践的权限。这些内容包括自1992年至今约27,000份原始法律文书。
您发送普通的 HTTP 请求，即可获得真实法律文书作为响应：案卷信息、逐字引文以及全文链接。不会有任何虚构的裁判文书。
密钥创建时仅显示一次，因此请立即保存。我们只保存密钥的哈希值，无法恢复密钥本身。请将其保存在您自己的服务器上，不要将其硬编码到网站、移动应用或公共代码仓库中。如果密钥泄露，请在个人账户中撤销该密钥，并通过“消息”栏目联系管理员协商更换。
促销期间适用统一的免费额度。 活动已于2026年6月27日结束——以下数字仅保留作为参考。
API 适用单独的访问条件。机器人和网页聊天的请求套餐不适用于支付 API 费用。目前不销售 API 付费套餐；访问权限和额度通过个人账户的“消息”栏目人工协商确定。
活动不消耗费用，但300次请求的余额按以下方式计算。
仅当请求成功处理时才会扣除请求：如果我方发生故障或余额不足，则不会消耗任何额度。请求速度受到约每分钟20次的软限制：该限制不消耗余额，而是用于平滑请求峰值。
为了做到诚实透明、让人放心。
客户输入问题，即可看到带有链接的真实法律文书集合。搜索基于语义运行，因此非法律专业人士也可以使用。
机器人不是凭空作答，而是提供具体案件的链接。它解决了最主要的痛点：虚构的裁判文书。
将法律文书全文以 Markdown 格式提取出来，作为法律意见、文件草案和答复的上下文。
找到法律文书，将案件集合导出为 DOCX，然后插入起诉状、答辩状或备忘录。无需再花数小时手动复制。
按主题、法律规范和年份批量请求，统计语料库，并定期跟踪审判合议庭的最新立场。
将司法实践置于知识库、法务部门 CRM 或合同审批系统中，直接在工作所在的位置使用。
连接、端点、错误处理和您的 LLM 配置。语料库：俄罗斯联邦宪法法院（1992–2026）、俄罗斯联邦最高法院（2014–2026）、俄罗斯联邦最高仲裁法院（1992–2014），约27,000份原始法律文书。
这是 REST API。可连接到基于任何 LLM 的应用或任何 HTTP 客户端，作为外部工具供您的模型调用，以搜索司法实践。
Base URL: https://lk.casus.legal
身份验证： 请求头 Authorization: Bearer cl_live_…
格式： 基于 HTTPS 的 JSON。
地址 https://mcp.casus.legal/one/mcp — 这是面向 AI 助手（Claude、ChatGPT、Grok、Hermes）的独立 MCP 连接器。它与 REST API 和密钥 cl_live_ 没有任何关系。
cl_live_… 请立即保存：密钥无法恢复。购买聊天套餐不会开通 API。现有密钥及其计数器可在个人账户的“API”部分查看。拥有密钥本身并不意味着当前具有有效访问权限。请通过“消息”协商续期和更换密钥；撤销密钥不会自动开通新密钥。
curl -X POST https://lk.casus.legal/v1/search \
-H "Authorization: Bearer $CASUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "договор энергоснабжения, фактическое потребление", "limit": 15}'
import os, httpx
client = httpx.Client(
base_url="https://lk.casus.legal",
headers={"Authorization": f"Bearer {os.environ['CASUS_API_KEY']}"},
timeout=60,
)
r = client.post("/v1/search", json={
"query": "снижение неустойки по статье 333 ГК",
"limit": 15,
"mode": "hybrid",
})
r.raise_for_status()
data = r.json()
for hit in data["results"]:
print(hit["court"], hit["date"], hit["case_number"], hit["url"])`
混合搜索。仅在成功返回结果时扣除 1 个请求。
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
query | string | 必填 | 俄语查询。为空时返回 400. |
limit | int 1–30 | 10 | 返回结果数量。概览建议使用 15–20。 |
mode | hybrid / bm25 / semantic | hybrid | hybrid （BM25 和语义搜索）建议使用。 |
court | string | – | 筛选器：宪法法院 / 最高法院 / 最高仲裁法院 / 经济纠纷审判庭 / 民事案件审判庭 / 全体会议 / 概览。 |
act_type, tag, article | string | – | 其他筛选器（article，例如《俄罗斯联邦民法典》第 333 条）。 |
year_from, year_to | int | – | 年份范围。 |
deduplicate | bool | true | 合并同一案件的多次审理。 |
expand | bool | true | 使用同义词扩展查询。 |
响应结构按法院层级提供现成区块。请从这些区块中组装响应，不要分别为每个法院发起请求。
{
"_response_format_hint": "…директива формата ответа…",
"constitutional_context": { "items": [ … ] }, // КС
"vs_guidance": { "items": [ … ] }, // Пленумы и обзоры ВС
"latest_practice": { "items": [ … ] }, // свежие определения коллегий ВС
"vas_history": [ … ], // история: практика ВАС
"results": [
{
"id": 12345, "court": "СКЭС", "date": "10.05.2024",
"case_number": "305-ЭС24-12345", "title": "…", "snippet": "…",
"score": 0.87,
"url": "https://lk.casus.legal/case/12345?t=<токен>"
}
],
"_supersession_alert": "…", // при наличии отменённого и действующего акта
"expansion": { … }
}
每份裁判文书的 url 字段中都包含带访问令牌的完整文本现成链接 ?t=…。请原样使用该链接：不要从 id 中重新拼接链接，也不要删除令牌。
裁判文书卡片：基本信息、 sections （按章节提供的文本）、 articles, hashtags 以及链接 url / url_md / url_docx。对于重要裁判文书，请使用该字段获取逐字引文。不消耗配额。
curl https://lk.casus.legal/v1/cases/12345 \ -H "Authorization: Bearer $CASUS_API_KEY"
所有错误均以 JSON 形式返回 {"error": "<код>", "message": "…"}.
| HTTP | error | 何时 | 如何处理 |
|---|---|---|---|
| 400 | bad_request | 没有 query 或 JSON 格式错误 | 修正请求正文 |
| 401 | unauthorized | 没有密钥、密钥错误或已被撤销 | 检查标头和密钥 |
| 402 | quota_exhausted | 推广访问已结束（在正文中 reason, message, contact_url) | 联系管理员，发送至 @CasusLegalBot 以续期 |
| 403 | forbidden | 该密钥无权访问搜索 | 通过账户中的“消息”协商访问权限 |
| 404 | not_found | 没有找到具有该 id 的裁判文书 | – |
| 429 | rate_limited | 超过每分钟请求限额 | 指数退避 |
| 500 | internal_error | 我方发生故障 | 采用退避策略重试，不扣除请求 |
| 503 | engine_not_ready | 重新部署或预热索引 | 1–3 分钟后重试 |
POST /v1/search 仅在返回结果时扣除 1 个请求 200：错误不计费。 GET /v1/cases/{id} 免费。每分钟请求限额按密钥计算（试用期间每分钟 20 次）。剩余配额可在个人账户的“API”部分查看。
429 和 5xx 之间以递增的等待时间重试：2 秒、4 秒、8 秒。GET /v1/cases/{id} 稳定，且调用免费。url 带有有效期约 30 天的令牌签名。请原样传递。API 提供原始材料：裁判文书卡片、主题区块以及格式提示 _response_format_hint。最终答案的质量由您的 LLM 系统指令决定。以下是两种场景的原则，而不是现成的提示词。
/v1/search ，配合有意义的查询和 limit 15–20：法院层级已经按区块返回。不要针对每个法院将主题拆分成多个请求。_response_format_hint. 这是内置的格式指令，遵循该指令会使答案明显接近标准概览。url. 禁止从 id 中构造地址或删除令牌 ?t=：没有令牌，链接将无法打开文本。/v1/cases/{id} 获取，仅限 3–5 份关键裁判文书。宪法法院所需引文已经位于内联字段 position中。这是多余令牌的主要来源。目标：编制用于导出的案件汇编或清单，不进行法律分析。
court / act_type / tag / article / year_from–year_to：目录将更具相关性且更加精简。id基本信息（法院、类型、日期、案件编号）以及 url。在此模式下不要复述或引用裁判文书。/v1/search 请求，分别针对子主题、年份或法院，并合并结果，依据 id.url，由用户自行筛选。