API + MCP · Beta

把裁判文书接进你的法律 AI

两种接入方式 —— REST API 或 MCP server。curl 一行能验证,Claude / Cursor 一分钟接通。数据 source_url 全部回链中国裁判文书网,结果可溯源、可呈堂。

01 / curl

先用 curl 验证

拿到 key 后 30 秒能跑通。Beta 阶段返回 sample 字段名与 GA 一致,代码不用改。

GET /api/v1/health
curl https://peilema.wenshucha.com/api/v1/health
POST /api/v1/cases/search
curl -X POST https://peilema.wenshucha.com/api/v1/cases/search \
  -H "X-API-Key: wsc_trial_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "经济性裁员 工龄7年 拒签合同",
    "province": "北京市",
    "term_reason": "layoff"
  }'
GET /api/v1/stats?dimension=term_reason
curl -H "X-API-Key: wsc_trial_xxxxxxxxxxxxxxxx" \
  "https://peilema.wenshucha.com/api/v1/stats?dimension=term_reason"
02 / MCP

接进 Claude Desktop / Cursor / Claude Code

MCP server 走 stdio,把检索能力变成 AI 助手的工具。 安装一次,模型自动看到 search_cases /get_case /case_stats 三个 tool。

安装(trial 阶段:git clone)
git clone https://github.com/wenshucha/wenshucha-mcp ~/wenshucha-mcp
cd ~/wenshucha-mcp && npm install
Claude Desktop · ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "wenshucha": {
      "command": "node",
      "args": ["/Users/<you>/wenshucha-mcp/bin/wenshucha-mcp.mjs"],
      "env": { "WENSHUCHA_API_KEY": "wsc_trial_xxxxxxxxxxxxxxxx" }
    }
  }
}
Cursor · ~/.cursor/mcp.json
{
  "mcpServers": {
    "wenshucha": {
      "command": "node",
      "args": ["/Users/<you>/wenshucha-mcp/bin/wenshucha-mcp.mjs"],
      "env": { "WENSHUCHA_API_KEY": "wsc_trial_xxxxxxxxxxxxxxxx" }
    }
  }
}
Claude Code · 一行加入
claude mcp add wenshucha \
  --env WENSHUCHA_API_KEY=wsc_trial_xxxxxxxxxxxxxxxx \
  -- node /Users/<you>/wenshucha-mcp/bin/wenshucha-mcp.mjs
03 / 端点

完整端点

REST,JSON in / out。所有写操作均无,只读。

MethodPathAuth说明
GET/api/v1/health(无)服务健康检查。
POST/api/v1/cases/searchX-API-Key混合检索:案情文本 + 结构化字段 → Top 20 类案 + 金额分位 + 胜诉率 + 关键裁判因素。
GET/api/v1/cases/{doc_id}X-API-Key依 doc_id 取单条判决详情。doc_id 来自 search 返回结果。
GET/api/v1/stats?dimension=provinceX-API-Key按维度切片聚合(省份 / 解雇原因 / 工龄分桶)。

只统计、不生成

每个数字都来自真实判决统计,不是模型推测。每条结果挂中国裁判文书网原文链接。

结构化字段已抽好

工龄、月薪、解雇原因、判付金额、胜负 —— 规则引擎抽取,直接可查询,不用自己再清洗。

常见问题

数据集多大?
Beta 阶段开放 110 万+ 结构化劳动争议判决(覆盖 1985 至今,持续同步更新)。正式 GA 开放 1.5 亿+ 全量裁判文书 + 法规,数据有渠道实时跟进,客户需求即可对齐到最新。
返回的数据怎么验证?
每条判决都带 source_url(中国裁判文书网原文链接),客户端可直接回链验证、引用至代理意见。
限流?
默认 60 次 / 分钟 per key。超出回 429 + Retry-After header。正式合作可调高。
key 多久有效?
试用 key 90 天。正式合作签约后换长期 key。
数据合规?
全部来自中国裁判文书网公开判决书,无个人隐私字段(姓名已做脱敏处理)。

申请试用 key

发邮件告诉我们团队名称、用途、预计调用量。一个工作日内回复 key + 接入支持。

发邮件申请
或拨商务电话 131-6872-7779 · 文书查 · 深圳星谱网络科技有限公司