fahai-judicial-data

查询法海风控企业司法数据。通过法海风控 API 查询企业司法风险数据列表(裁判文书、执行公告、失信被执行人、司法拍卖等)并获取案件详情。适用于企业背调、司法风险评估、风控审查等场景。触发词:法海、法海风控、企业司法数据、裁判文书查询、执行公告、失信被执行人、司法风险、企业涉诉查询、案件详情查询、fahai。

SKILL.md

GitHub

法海风控企业司法数据查询

概述

通过法海风控 API(VIP 高精版 · 正式环境)查询企业司法数据。支持两大功能:

  1. 企业司法数据列表查询 — 按企业名称/关键词搜索,返回裁判文书、执行公告、失信被执行人等司法风险数据列表
  2. 案件详情查询 — 通过列表返回的 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 "北京某某科技有限公司"

# 未提供授权码时,脚本输出:
# {"code": "auth_required", "msg": "授权码开通可联系我们010-62502608"}

关键返回字段: 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,并以非零状态码退出