技能介绍

要解决的问题

企业尽职调查、风控审核、合作方背景审查等场景中，往往需要核查目标企业的司法风险：是否存在未了结的裁判文书、是否被列入失信被执行人名单、是否有执行公告或司法拍卖记录。手工逐一到裁判文书网、执行信息公开网等渠道检索不仅耗时，而且难以结构化整合。法海风控司法查询大数据技能将这一过程封装为两步 API 调用，帮助开发者把企业司法数据查询集成到自动化流程中。

核心能力与工作流

技能提供两个核心脚本，分别对应列表检索与详情查询：

列表查询（scripts/fahai_query.py）：按企业名称或统一社会信用代码等关键词搜索，返回 allList 数组，其中每条记录包含 entryId 字段，可用于下一步详情查询。可通过 --domain 指定领域（如 sifa 司法）、--data-type 限定维度（如 cpws 裁判文书、zxgg 执行公告、sswdjg 失信被执行人），还支持分页与每页条数控制。
详情查询（scripts/fahai_details.py）：拿到列表中的 entryId 和对应 dataType 后，可获取单条记录的完整详情。--detail-api 默认使用 export 路径。

标准工作流为：先确认授权码 → 查询列表拿到 entryId → 用 entryId 查询详情。两个脚本均支持 --pretty 参数输出人类可读格式，默认则输出 JSON 以便程序解析。

适用边界与注意点

该技能运行于正式环境的 VIP 高精版接口，调用前必须通过 --auth-code 传入法海风控授权码；脚本本身不再内置授权码，若用户未提供则直接输出开通联系方式（010-62502608）并终止流程，不会发起请求。接口超时时间为 30 秒，查询失败时脚本会将包含 code: "error" 的 JSON 输出到 stderr 并以非零状态码退出，便于上层程序捕获错误。完整的领域代码与维度代码组合需参考 references/api_reference.md。