内容
# sudact-mcp
通过访问公开网站 [sudact.ru](https://sudact.ru)（СудАкт）来搜索俄罗斯联邦司法实践的MCP服务器。 СудАкт 没有官方的API —
服务器像浏览器一样工作（User-Agent + 会话cookie + 异步搜索网站查询）
并解析HTML输出。
## 工具列表
| 工具 | 用途 |
|---|---|
| `search_court_practice` | 按文本 / 法律条款 / 案件编号搜索判决。 `scope`: `all`（最高法院 + 仲裁 + 普通法院 + 基层法院）或单个部分：`vsrf`，`arbitral`，`regular`，`magistrate`，`law`. 日期参数：`date_from`，`date_to`（ДД.ММ.ГГГГ）。 |
| `get_court_decision` | 按URL或文档ID获取判决全文。 |
## 安装
```powershell
py -m pip install --user -r requirements.txt
```
检查所有功能是否正常（向sudact.ru发出实际请求）：
```powershell
py -X utf8 selftest.py
```
## 连接到Claude Code
在 `~/.claude.json` 中添加 `"mcpServers"` 块：
```json
"sudact": {
"command": "C:\\Users\\USER\\AppData\\Local\\Programs\\Python\\Python312\\python.exe",
"args": ["C:\\Users\\USER\\Documents\\Veritas\\Code\\sudact-mcp\\server.py"],
"env": { "PYTHONUTF8": "1" }
}
```
编辑后 - 重新启动Claude Code以使服务器生效。
## `sudact-stats` 技能（在MCP上分析实践）
`sudact-stats/` 目录中包含一个Claude技能，构建在此MCP之上。 它以两种模式运行：
- **A - 证据统计：** 诚实（随机/按日期分层）抽样决定→编码每个→汇总报告，附有关于样本偏差的强制性声明。 后端 - `stat_corpus.py`.
- **B - 定向捕获：** 通过多个查询搜索特定的罕见/特定决定（例如，依据该条款的无罪判决）→模型检查每个候选者→带有引用的报告。 后端 - `find_candidates.py`.
安装：复制 `skill/sudact-stats/` 到 `~/.claude/skills/`. 编码器 -
Sonnet（针对Opus进行了校准）。 详细信息和限制 - 在 `SKILL.md` 中。
## 免费搜索的限制
服务器关闭了“查找实践 - 阅读文本 - 总结”的场景。
但这是一个免费的公共来源，它有局限性。 了解free在哪里结束是有用的。
### 数据限制（这是 СудАкт 本身的限制）
- **并非所有内容都已发布。** СудАкт 是法院公开的汇总，但部分法令不公开或延迟发布；
不能保证完整性。
- **匿名处理。** 个人数据已被删除（“ПАО Совкомбанк к ФИО1 ФИО5”），
因此几乎无法按特定个人搜索实践。
- **仲裁落后于原始来源** （kad.arbitr.ru），在更新和文本完整性方面。
### 搜索质量限制（主要限制）
- **按字面意义搜索，无语义和同义词。** 搜索词匹配，而不是想法。 示例：`снижение неустойки` → 100,000+ 结果，而
`снижение неустойки 333 ГК` → 0. 长短语会破坏输出 - 需要简短而有意义的查询。
- **没有智能排序。** 按日期 / 简单相关性排序；最高法院的决定和地方法院的决定混杂在一起。
- **筛选条件有限。** 无法按法院层级、结果、金额、法官进行筛选 -
只能按文本、部分和日期筛选。
- **没有现成的法律立场。** 返回原始决定；由LLM在文本上生成摘要，而不是服务本身。
### 原则上不存在的内容
- 统计数据和趋势（“在N％的案件中，法院降低了罚款”），法官简介。
- 上级法院立场的引用链接，“案件”在各级法院的进展，
与当前法规版本的绑定。
### 包装的技术限制
- 每页10个结果；`scope=all` 模式 = 4个连续查询。
- 解析器很脆弱：如果 СудАкт 更改布局，则需要编辑 `server.py`.
- 没有官方限制，但如果频繁请求，IP地址可能会被限制。 服务器连续运行，无并行轰炸。
### 达到限制 → 付费服务
当需要以下功能时，连接Caselook / Casebook / cyberjustice（使用相同的MCP接口）是有意义的：
- 按含义 / 法律立场而非确切词语进行搜索；
- **分析和预测** （申诉频率，典型追偿金额）；
- 按法院层级 / 结果 / 法官和按TIN分析对手的**筛选条件**；
- 完整性保证和快速更新。
粗略地说：**免费 = 快速搜索和带有AI总结的文本阅读；付费 = 智能搜索 + 分析 + 完整性。**
