风鸟企业速查
给 Agent 的操作手册。核心价值：一个公司名进去，一张速查卡出来，不必在浏览器里翻十几个页面。
When to Use
命中以下任一情形时使用：
- 用户给出单个公司名称，想知道法人、注册资本、成立时间、注册地址、经营状态、参保人数
- 用户问"这家公司靠谱吗""有没有诉讼/被执行""能不能合作"——先查基础面与司法风险面
- 用户在做合同相对方、供应商、客户、投资标的的初步尽调
- 用户明确提到 风鸟 / Riskbird / riskbird.com
不适用：批量名单（>5 家）、招投标数据、舆情、知识产权深度分析。
Procedure
- 确认主体。用户给的是简称时脚本会返回候选列表。不要替用户猜，把候选企业名列给用户选（entid 只用于下一步，不要念给用户），除非只有一个候选。
- 确认 Key。脚本从环境变量
FN_API_KEY读取；报"未配置"时按SETUP.md引导。任何情况下不要把 Key 写进对话、日志或文件。 - 执行查询（路径用技能目录的绝对路径，避免工作目录不一致导致找不到脚本）：
bash
python "<skill_dir>/scripts/riskbird.py" "公司全称"
按需裁剪维度（省额度）：
bash
python "<skill_dir>/scripts/riskbird.py" "公司全称" --dims basic_info,shareholders,executed,dishonest
python "<skill_dir>/scripts/riskbird.py" "公司全称" --json # 需要二次加工时
python "<skill_dir>/scripts/riskbird.py" --entid <entid> --dims basic_info
- 组装输出。脚本已内置卡片：首行「状态 · 法人 · 注册资本 · 成立」，随后统一社会信用代码、企业类型、注册地址、电话、邮箱、参保人数、经营期限、经营范围，再往下是各维度「N 条（首条摘要）」。直接引用脚本输出，不要自行改写字段名。
- 给结论，但不越界。可以指出"被执行 285 条，首条（2026）皖0603执恢462号，标的 2.81 亿"这类事实，不要下"该公司不可合作"的判断；措辞用"从公开数据看…，建议进一步核实…"。
额度成本
每个维度消耗 1 次接口额度，默认组合 6 个维度 = 每次查询 6 次。额度按账号按天计。
- 只想确认是不是真公司、法人和注册资本 →
--dims basic_info（1 次） - 签合同前初筛 →
--dims basic_info,executed,dishonest,limit_consumption（4 次） - 不要为了"更全"把 11 个维度全拉一遍
示例
真实输出（恒大地产集团有限公司，9 个维度）：
【恒大地产集团有限公司】
在营 · 法定代表人 赵长龙 · 注册资本 393979.6387万元人民币 · 成立 1996-06-24
统一社会信用代码：91440101231245152Y
企业类型：有限责任公司（自然人投资或控股）
参保人数：117
经营期限：1996-06-24 至 长期
股东信息：21 条（共青城美投步阳投资合伙企业（有限合伙） 机构股东）
主要人员：6 条（梁伟康 董事长）
工商变更：55 条（2023-11-30 主要人员变更：赵长龙（董事长） → 梁伟康（董事长））
对外投资：194 条（恒大地产集团济南置业有限公司 100% 在营）
被执行人：285 条（（2026）皖0603执恢462号 281,075,072.00 2026-11-02 安徽…）
失信被执行人：358 条（（2026）豫0291执恢652号 全部未履行 2026-04-16）
限制高消费：3295 条（（2026）湘01执1639号 恒大地产集团有限公司 2026-07-20）
行政处罚：6 条（穗天人社监字（2025）06012号 2000.00 2025-05-19 天河区…）
数据来源：风鸟 Riskbird 公开数据…
名称有歧义时（脚本会带出 entid，回话时只列企业名）：
「腾讯」匹配到 5 个主体，请确认后用 --entid 继续：
757HLcSHedY 腾讯云计算（北京）有限责任公司 在营
nU5oY6rkTjj 深圳市腾讯网域计算机网络有限公司 在营
…
Pitfalls
未查询≠无记录：维度接口失败或额度不足时脚本标注"未查询"，必须原样保留。写成"无风险"是最严重的错误。- 名称歧义：简称常命中多家（"腾讯""中建"）。先取 entid 再查维度，不要用名称直接查维度。
- 额度用尽（code=9999 + 访问已达上限）：当天不要再重试，告知用户次日再查或换自己的 Key。脚本退出码为 4。
- entid 会失效：企业改名、合并后旧 entid 可能查不到（code=8888），重新搜索，不要重复重试同一 entid。
- 模糊搜索只匹配中文名：用户给英文名时先转成中文官方名称。
- 企业改名会让精确匹配落空：如"字节跳动有限公司"已更名为"抖音有限公司"，此时列出候选让用户确认，不要认定"查不到"。
- 合规红线：只做公开工商数据查询，不批量爬取，不用于骚扰或营销。
Verification
一次成功查询应同时满足：
- 输出首行是企业全称，且"状态 · 法人 · 注册资本 · 成立"至少三项有值
- 每个请求的维度都出现，要么给条数、要么标"未查询"
- 结尾带数据来源声明
只拿到"未检索到"时，先用更短的关键词重试一次（去掉括号内容、地区前缀），仍失败再告知用户名称可能有误。
