失信被执行人查询

面临的业务痛点

在企业尽职调查、合作方背景审查或金融风控场景中，核实目标对象是否被纳入“失信被执行人”名单（俗称老赖黑名单）是一项高频且关键的核查任务。传统方式需登录执行信息公开网等官方渠道逐一检索，不仅存在数据割裂、查询入口分散的问题，也难以直接集成到自动化评估流水线中。

技能工作原理

该 Skill 封装了第三方提供的全国失信被执行人黑名单接口，对外暴露一个可执行的查询脚本 scripts/query_credit_blacklist.py。核心运行流程分为三步：

• 鉴权与参数组装：要求用户提供从接口购买页获取的专属 API Key。脚本支持通过环境变量 CHINAZ_CREDIT_BLACKLIST_API_KEY 注入密钥，或直接通过 --api-key 参数传入。
• 单点查询执行：通过 --realname 传入必填的姓名或公司名称，--idcard 传入选填的身份证号或组织机构代码。脚本底层封装了接口通信细节，输出结构化 JSON。
• 字段解析与反馈：成功响应包含 status 状态码。当 status 为 0 时，返回数据涵盖 caseno（案号）、filingdate（立案时间）、court（执行法院）、performance（履行情况）及 description（失信具体情形）等字段。Agent 依据返回字段生成核查结论。

适用边界与注意点

• 严格的单次查询：接口不支持批量并发，realname 每次仅能查询单条记录。若需批量核查，必须编写外部循环逐条调用。
• 额度与时效性：接口提供新手调试免费额度，额度耗尽需前往购买页升级。返回数据来源于第三方数据源，可能存在同步延迟，最终判定需以官方渠道为准。
• 密钥安全：Agent 被严格限制仅能在单次对话上下文中使用密钥，严禁输出、复述或持久化保存完整的 API Key。