技能介绍

做企业尽调或自动化流程时，最头疼的往往是接口对接：关键字传错了格式、手写的循环在解析 JSON 时疯狂报错、或者用户的 API Key 不小心暴露在日志里。这些脏活累活其实没必要手写。这个技能把“企业工商信息标准版”接口封装成了一条干净的执行链路，专门帮你根据公司名全称、注册号或统一社会信用代码，快速拉回注册资本、法人、经营范围等结构化数据。

核心能力与执行步骤

底层脚本 scripts/query_business_info.py 负责处理参数校验与 API 请求。你只需要把目标关键字丢进去，它就能做三件事：

多维检索：支持输入企业名称全称、18位注册号或统一社会信用代码 creditNo。
结构化返回：输出标准 JSON，包含法人 legalPerson、成立日期 establishDate、经营状态 companyStatus 等字段。
失败拦截：遇到鉴权失败或额度用尽时，明确告诉你是 Key 过期了还是额度不够，而不是给你返回一堆空数据。

适用边界与注意点

虽然调用简单，但在工程化落地时仍需遵守几条硬性约束：

接口仅限标准版工商查询，别拿它去查企业知识产权或司法风险，这里不覆盖那些场景。
一次只查一条。如果要做批量尽调，必须自己写循环逐条发，不能单次请求传数组。
数据源自第三方，可能存在更新延迟，请务必以官方数据源为准，这个结果仅供业务参考。
如果返回了 missing_api_key，技能会引导用户去配置环境变量 CHINAZ_BUSINESS_INFO_API_KEY，而不会反复重试导致无意义扣费。

这本质上就是一个封装好的信息搬运工：你给对的关键字，它给你干净的工商档案，适合嵌在你的后台服务或数据分析脚本里。