一、用途 本技能用于通过企查查 OpenAPI 查询中国企业的公开经营与风险数据。用户以自然语言提出需求（如"查 XX 公司"、"XX 法人是谁"、"有没有官司"、"有没有商标专利"、"是不是空壳"），AI 识别意图后调用脚本，再把结果用自然语言回复用户，用户无需自己输入命令。
二、主要能力 技能内置 scripts/api_registry.py 注册了 45 个接口（默认 opened 为 False），按用途分为以下几类：
- 工商基础（最高频）：410 工商基本（0.20 元）、735 工商详情（2.00 元）、731 股东（2.00 元）、732 主要人员（0.50 元）、733 分支机构（0.50 元）、734 变更记录（1.00 元）、213 年报（1.00 元）、271 开票税号（1.00 元）、855 二要素核验（0.10 元）、856 三要素核验（0.20 元）、886 模糊搜索（0.10 元）。
- 关联族谱：884 对外投资（1.00 元）。实控人、股权穿透、企业图谱、控制企业、受益所有人等为企查查面议类接口，需联系企查查商务（400-088-8275）单独开通。
- 司法风险：740 失信（0.30 元）、741 被执行（0.30 元）、742 限高（0.50 元）、752 股权冻结（0.50 元）、761 破产重整（0.50 元）、887 裁判文书（0.30 元）、888 开庭（0.50 元）、889 立案（0.50 元）、758 终本（1.00 元）、988 限制出境（1.00 元）、882 法院公告（0.50 元）、744 司法拍卖（0.50 元）。资料给出"信贷尽调司法包"预设：740+741+742+752+887+888+889，约 3.0 元。
- 经营风险：739 经营异常（0.50 元）、748 严重违法（0.50 元）、865 行政处罚（0.50 元）、747 动产抵押（0.50 元）、745 土地抵押（0.50 元）、751 股权出质（0.50 元）、753 股权质押（0.50 元）、756 税收违法（0.50 元）、757 欠税（0.50 元）、1024 对外担保（1.00 元）、980 清算（1.00 元）。
- 知识产权：231 商标（0.30 元）、514 专利（0.30 元）、233 软著（0.50 元）、515 网站备案/ICP（0.50 元）。
- 经营信息：958 招投标（1.00 元）、255 资质证书（0.30 元）、691 税务信用（0.50 元）、892 行政许可（0.50 元）。
- 企业发展：701 舆情（0.50 元）、950 融资（0.50 元）。
此外提供 scripts/duediligence.py 批量编排器，输入企业名后自动跑全部已开通接口，输出 markdown 原料包、JSON 原始数据与调用日志；接口全开通时全套约 ¥27，缓存命中后第二次约 ¥0，单家全套耗时约 50 秒。其 _build_risk_summary() 提供风险信号汇总口径（🔴 极高：740/988/748/980；🟠 高：741/742/752/761/758/739；🟡 中：865/756/757/745/747/751/753/1024，或 887 裁判文书被告≥3 且被告比≥70%；⚪ 提示性：882/744/888/889），该口径为信贷/担保业务视角，其他场景可直接改 _build_risk_summary()。
三、使用方式 技能目录位于 ~/.claude/skills/kaiyu-qichacha-fetcher/（Windows 为 %USERPROFILE%.claude\skills\kaiyu-qichacha-fetcher\），凭证文件位于 ~/.config/qichacha/credentials.json，缓存目录为 ~/.cache/qichacha/<MD5(企业名)[:16]>/。首次配置见 SETUP.md，可用 python setup.py 一键完成；排错见 TROUBLESHOOTING.md。
setup.py 提供以下管理命令：python3 setup.py（交互式录入凭证）、diagnose（查看安装状态）、mark-opened 410 740 ...（标记接口已开通）、mark-closed（取消开通标记）、list-opened（查看已开通接口）、probe（扣 ¥0.1 真实请求验证凭证）、reset（重置，需确认）。mark-opened 会修改 api_registry.py 的 opened 字段，写入前做 Python 语法校验。
调用方式有两种：Python 内联（推荐，避免子进程开销），通过 sys.path 引入 scripts 后 from client import fetch, check_account, QccError，再调用 fetch("410", keyword="...")；或使用 CLI，如 python3 ~/.claude/skills/kaiyu-qichacha-fetcher/scripts/qcc.py fetch 410 "企业名"，以及 check-account、list --opened --md 等子命令。
签名规则已封装在 client.py：Header Token = MD5(appkey + Timespan + SecretKey).upper()，Header Timespan 为 Unix 秒，Query key 为 appkey，全部为 GET 请求。
缓存默认开启，TTL 按数据时效分级（工商 30-60 天、司法 7 天、舆情 3 天），同一企业同一接口 TTL 内二次起免费；用户要求拉最新时使用 use_cache=False；负结果不写缓存。错误通过 QccError.kind 分类（creds、not_opened、no_result、rate_limit、network、unknown），可用 e.friendly() 返回带中文 label 与行动建议的提示。
自然语言意图与 ApiCode 的映射已在资料中按"用户最可能怎么说"列出，多个接口可叠加。用户未说明企业全称时，先用 886 模糊搜索拿到完整工商全称再调具体接口。
四、注意事项与限制 接口需在企查查后台 https://openapi.qcc.com/dataApi 逐个申请开通，未开通接口调用返回 not_opened 错误；开通后需运行 python setup.py mark-opened <code> 通知技能，不应手动编辑 api_registry.py。企业全称需精确，模糊匹配在不同接口表现不同，可用统一社会信用代码兜底。缓存目录名为 MD5 截断，不可反查企业名。实控人、股权穿透、企业图谱、受益所有人、财税数据等为面议类接口，需联系企查查商务单独议价。单次调用超 1 元的接口多个叠用前应先告知用户预估金额。脚本零第三方依赖，跨平台，拷贝整个技能目录与凭证文件即可运行。官方文档为 https://openapi.qcc.com/dataApi，控制台为 https://openapi.qcc.com/console。