| name | fahai-judicial-data |
| description | 查询法海风控企业司法数据。通过法海风控 API 查询企业司法风险数据列表（裁判文书、执行公告、失信被执行人、司法拍卖等）并获取案件详情。适用于企业背调、司法风险评估、风控审查等场景。触发词：法海、法海风控、企业司法数据、裁判文书查询、执行公告、失信被执行人、司法风险、企业涉诉查询、案件详情查询、fahai。 |
法海风控企业司法数据查询
概述
通过法海风控 API（VIP 高精版 · 正式环境）查询企业司法数据。支持两大功能：
- 企业司法数据列表查询 — 按企业名称/关键词搜索，返回裁判文书、执行公告、失信被执行人等司法风险数据列表
- 案件详情查询 — 通过列表返回的 entryId 获取某一条数据的完整详情
典型工作流：先查询列表获取 entryId，再用 entryId 查询详情。
前置条件
- Python 3.8+
- 依赖库：
requests
- 安装依赖：
pip install requests
- 法海风控授权码（authCode）：调用接口前必须提供授权码。如用户未提供授权码，提示"授权码开通可联系我们010-62502608"，不执行接口调用。
工作流
授权码判断（第一步）
在调用任何接口之前，确认用户是否提供了授权码（authCode）：
- 用户提供了授权码 → 将授权码传入
--auth-code 参数，正常调用接口
- 用户未提供授权码 → 输出提示信息"授权码开通可联系我们010-62502608"，不执行接口调用，流程终止
查询企业司法数据列表（第二步）
运行 scripts/fahai_query.py 查询企业司法数据列表。
python3 scripts/fahai_query.py --auth-code "授权码" --keyword "企业名称" [选项]
参数说明：
| 参数 | 必填 | 默认值 | 说明 |
|---|
| --auth-code | 是 | — | 法海风控授权码。未提供时提示开通联系方式，不执行查询 |
| --keyword | 是 | — | 搜索关键词（企业名称/统一社会信用代码等） |
| --domain | 否 | sifa | 领域代码（sifa=司法, sat=税务, epb=环保 等） |
| --data-type | 否 | 空 | 维度代码（cpws=裁判文书, zxgg=执行公告 等），留空查全部 |
| --page-no | 否 | 1 | 页码 |
| --range | 否 | 10 | 每页条数 |
| --pretty | 否 | false | 输出人类可读格式（默认输出 JSON） |
示例：
python3 scripts/fahai_query.py --auth-code "你的授权码" --keyword "北京某某科技有限公司"
关键返回字段： allList 数组中每个条目包含 entryId 字段，用于下一步详情查询。
查询案件详情（第三步）
从列表查询结果中获取 entryId 和对应的 dataType（维度代码），运行 scripts/fahai_details.py 查询详情。
python3 scripts/fahai_details.py --auth-code "授权码" --entry-id "entryId" --dimension cpws [选项]
参数说明：
| 参数 | 必填 | 默认值 | 说明 |
|---|
| --auth-code | 是 | — | 法海风控授权码。未提供时提示开通联系方式，不执行查询 |
| --entry-id | 是 | — | 从列表查询结果中获取的 entryId |
| --dimension | 是 | — | 维度代码，需与列表条目的 dataType 一致 |
| --detail-api | 否 | export | 接口路径类型（VIP 版所有领域均用 export） |
| --pretty | 否 | false | 输出人类可读格式（默认输出 JSON） |
示例：
python3 scripts/fahai_details.py --auth-code "你的授权码" --entry-id "xxx" --dimension cpws
输出格式
- 默认：输出 JSON 格式，便于程序化处理和解析
- --pretty：输出人类可读格式，包含字段标签和摘要截断
授权码缺失时的输出
当 --auth-code 未提供时，脚本不执行接口调用，直接输出：
{"code": "auth_required", "msg": "授权码开通可联系我们010-62502608"}
--pretty 模式下输出：
⚠️ 授权码开通可联系我们010-62502608
领域与维度代码
完整的领域代码和维度代码列表详见 references/api_reference.md。常用组合：
| 场景 | domain | data-type |
|---|
| 裁判文书 | sifa | cpws |
| 执行公告 | sifa | zxgg |
| 失信被执行人 | sifa | sswdjg |
| 司法拍卖 | sifa | sfpm |
| 开庭公告 | sifa | ktgg |
注意事项
- 当前配置为正式环境 · VIP 高精版
- 授权码不再内置于脚本，每次调用必须通过
--auth-code 参数传入
- 如用户未提供授权码，提示"授权码开通可联系我们010-62502608"，不调用接口
- 接口超时时间：30 秒
- 查询失败时脚本会输出包含
code: "error" 的 JSON 到 stderr，并以非零状态码退出
