Kaiyu Qichacha Fetcher

企查查 OpenAPI 数据查询

企查查 API 工具。用户用自然语言提需求，AI 在后台调脚本——用户不需要打命令。

你（AI）的工作方式

用户说的话 → 你识别意图 → 你调脚本 → 你把结果用人话回给用户。

自然语言里没说明企业全称时：先用 886（模糊搜索，0.10 元）拿到完整工商全称，再调具体接口。别让用户打全称。

金额提醒原则（默认推荐口径，可调整）：单次调用超 1 元的接口（735/731/213/271/884/758/988/1024/980/958）多个叠用前，先口头说"这几项加起来约 X 元，跑吗"；2 元以下随便跑不用问。

资源位置

• 接口注册表: scripts/api_registry.py（45 个接口，默认 opened: False）
• 官方文档: https://openapi.qcc.com/dataApi
• 控制台: https://openapi.qcc.com/console
• 首次配置: 见 SETUP.md（用 python setup.py 一键完成）
• 排错手册: TROUBLESHOOTING.md

setup.py 管理命令（用户管理 skill 状态的入口）

用户不需要手编辑任何文件。所有维护操作都通过这些命令完成——当用户问相关问题时，你（AI）应主动跑这些命令：

mark-opened 会修改 scripts/api_registry.py 中的 opened 字段；写入前会做 Python 语法校验，失败拒绝写入。用户不应该手编辑这个文件——出问题都用 mark-opened / mark-closed。

你怎么调脚本（内部实现）

Python 内联（推荐，避免子进程开销）：

import os, sys
# 用 expanduser 自动展开 ~ / %USERPROFILE%，跨平台
sys.path.insert(0, os.path.expanduser("~/.claude/skills/kaiyu-qichacha-fetcher/scripts"))
from client import fetch, check_account, QccError

r = fetch("410", keyword="腾讯科技（深圳）有限公司")
if r.ok:
    data = r.data  # 工商详情字典
    # 用 r.data 里的字段写自然语言回复
elif r.status == "":
    pass  # QccError 已经被抛
else:
    # r.ok==False 但没抛——通常是无结果
    pass

Bash / CMD 调 CLI（备用，输出 JSON 自己解析）：

# Mac/Linux
python3 ~/.claude/skills/kaiyu-qichacha-fetcher/scripts/qcc.py fetch 410 "腾讯科技（深圳）有限公司"
python3 ~/.claude/skills/kaiyu-qichacha-fetcher/scripts/qcc.py check-account
python3 ~/.claude/skills/kaiyu-qichacha-fetcher/scripts/qcc.py list --opened --md

:: Windows
python %USERPROFILE%\.claude\skills\kaiyu-qichacha-fetcher\scripts\qcc.py fetch 410 "腾讯科技（深圳）有限公司"
python %USERPROFILE%\.claude\skills\kaiyu-qichacha-fetcher\scripts\qcc.py check-account

自然语言意图 → ApiCode 映射

按"用户最可能怎么说"组织。多个接口可叠加。

注意：用户必须先在企查查后台 https://openapi.qcc.com/dataApi 逐个申请开通对应接口，开通后跑 python setup.py mark-opened <code1> <code2> ... 告诉 skill（不要让用户手编辑 api_registry.py）。未开通的接口调用会返回 not_opened 错误。

工商基础（最高频）

关联族谱

实控人、股权穿透、企业图谱、控制企业、受益所有人——这些都是企查查面议类接口，需联系企查查商务（400-088-8275）单独开通。

司法风险（信贷尽调必查）

推荐预设——信贷尽调司法包：用户说"看 XX 司法风险"时，默认跑 740+741+742+752+887+888+889（共约 3.0 元，前提是这些接口已开通），高级别尽调再加 761+758+988+882+744。

经营风险

知识产权

经营信息

企业发展

高阶用法：一键批量尽调取数

scripts/duediligence.py 是批量编排器——输入企业名，自动跑全部"已开通"的接口，输出 markdown 原料包 + JSON 原始数据 + 调用日志。

import os, sys
sys.path.insert(0, os.path.expanduser("~/.claude/skills/kaiyu-qichacha-fetcher/scripts"))
from duediligence import run_full_dd, render_markdown

report = run_full_dd("腾讯科技（深圳）有限公司")
print(render_markdown(report))
# 或直接 CLI：python3 ~/.claude/skills/kaiyu-qichacha-fetcher/scripts/duediligence.py "企业名" --out ./output

成本预估（接口全开通的话）：

• 全套约 ¥27（45 个接口，886 + 410 在 build_context 阶段已调）
• 缓存命中后第二次跑：约 ¥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() 即可。

签名规则（已封装到 client.py，不用手算）

• Header Token = MD5(appkey + Timespan + SecretKey).upper()（32 位大写）
• Header Timespan = Unix 秒
• Query key = appkey
• 全部 GET

缓存策略

• 默认开启；TTL 按数据时效分级（工商 30-60 天 / 司法 7 天 / 舆情 3 天）
• 同一企业的同一接口在 TTL 内第二次起免费
• 用户说"重新查 / 拉最新 / 不要缓存"时用 use_cache=False
• 负结果（关键词无匹配）不写缓存，避免长期缓存"没查到"

错误归类（QccError.kind）

捕获到 QccError 后优先用 e.friendly() ——会返回带中文 label + 行动建议的字符串，可直接转给用户：

try:
    r = fetch("741", keyword="腾讯")
except QccError as e:
    user_message = e.friendly()  # 例如：
    # [接口未开通] [741 被执行人核查] Status=403 接口未开通
    # → 这个接口在企查查后台还没申请开通。去 https://openapi.qcc.com/dataApi/741
    #   点'申请开通'，通过后跑 `python setup.py mark-opened 741`。

注意事项

1. 企业全称要精确：模糊匹配在不同接口表现不同，先用 886 拿 KeyNo 或完整全称再调其他接口
2. 统一社会信用代码兜底：企业名含全角括号等特殊字符匹配不稳时，用信用代码代替 keyword
3. 缓存哈希不可逆：目录名是 MD5 截断，反查不到企业名；按企业清缓存得自己记录映射
4. 面议类接口：实控人/股权穿透/企业图谱/受益所有人/财税数据等需联系 400-088-8275 单独议价
5. 接口开通是逐个申请的：企查查不是开通就能用全部 45 个接口——每个接口要在 openapi.qcc.com/dataApi/{code} 点"申请开通"，可能涉及二次审核或加价。开通后用 python setup.py mark-opened <code> 告诉 skill
6. 跨平台：脚本零第三方依赖，拷贝整个 skill 目录 + 凭证文件即可在 Mac/Windows/Linux 跑