china-company-search-fengniao

# 企业查询 | 工商查询 | 风鸟 Fengniao 风鸟是一个以商业数据为核心的中国企业查询 skill，适合“查公司”“查法人”“查老板”“企业尽调”“合作方背景调查”“供应商风险筛查”等常见场景。通过 `discover` 发现所需工具，通过 `call` 获取结构化数据。 **设置**：开箱即用，无需配置。Skill 内置公用 API Key，安装后可直接使用。如有自己的付费账号，可将私有 Key 配置为环境变量 `FN_API_KEY`，会优先使用。发布包会在内部固定传入 `channel`，用户无需填写；切换发布平台时只需修改 `scripts/env.mjs` 中的 `CHANNEL`。实际请求通过 URL 参数 `apikey` 和 `channel` 传递，不通过 Headers 传递。 **额度说明**：内置公用 Key 每日有使用上限（1000 次），具体剩余额度以 https://www.riskbird.com/skills 页面实时展示为准。当返回 `code=9999` 且 `msg` 包含”访问已达上限”时，表示当日公用额度已用完，可配置私有 Key 或次日再用。 ## 当前版本支持范围 当前版本已支持以下维度，未来会持续扩展： - 企业模糊搜索：企业简称/全称匹配，返回 `entid` - 企业基本信息：法人、注册资本、成立日期、统一社会信用代码、注册地址、经营范围等 - 企业股东信息 - 企业高级职员：董事、监事、高管、法定代表人 - 企业对外投资 - 企业工商变更 - 被执行人 - 失信被执行人 - 限制高消费 - 经营异常 - 严重违法 - 行政处罚 - 企业尽调报告生成：基于当前已支持维度整合输出 当前可用能力以 `tools.json` 为准，字段细节以 `references/field_definitions_*.md` 为准。 ## 关于搜索命中 这个 skill 面向“企业查询”“工商查询”“查公司”“查法人”“企业尽调”“企业风险筛查”等大类需求，因此用户或 agent 用这些上位意图词搜索时，应该优先命中本 skill。 如果用户问的是企业相关但当前尚未接入的细分维度，例如专利、招投标、招聘、舆情等： - 仍可以先命中本 skill，因为它属于企业查询大类 - 但执行时必须明确说明“当前版本暂未支持该维度” - 必要时可转 WebSearch 补充公开信息，并明确标注“以下为公开网页整理，不是风鸟结构化数据返回” - 不要把未接入维度写成已支持能力，也不要编造结果 ## 使用流程 1. 先识别用户要查的维度，不要一上来就搜企业主体。 2. 先用 `discover` 找维度工具，例如 `”企业股东信息”`、`”企业经营异常”`、`”行政处罚”`。 3. 确认该维度有可用工具后，再调用 `biz_fuzzy_search` 获取 `entid`。 4. **主体消歧（必须）**：如果企业名称是简称或存在多义（如”信数””雷军”），必须先询问用户确认是哪家企业，再执行查询。不能假设唯一性直接查。 5. 所有维度查询都使用 `entid`，不直接传企业名称或信用代码。 6. 如果是”做尽调””查风险”这类多维度需求，只做一次主体解析，然后复用同一个 `entid` 查询多个维度。 7. **按人名查企业**：若用户提供的是人名（如”雷军有哪些公司”），应理解为”以该人为法定代表人的企业”，并在结果中说明此限定。若存在同名人，需询问用户确认。 ## 结果与边界 - 仅展示真实返回的数据，不要编造 - 风鸟结构化接口结果与 WebSearch 结果必须明确区分来源 - 若某维度无记录，可直接说明”未查询到相关记录” - 若某维度未接入，明确说明”当前版本暂不支持，未来会持续扩展” - **不向用户输出 `entid`**：entid 是内部查询 ID，对用户无意义，结果中不展示 - **企业名称始终用全称**：结果列表中统一使用企业工商登记全称，不用简称 ## 错误恢复 - `code=9999` 且非”访问已达上限”：检查内置 Key 是否有效，或配置私有 `FN_API_KEY` - `code=9999` 且 `msg` 包含“访问已达上限”：告知用户当日公用额度已用完，并引导其查看页面实时额度 - `code=8888`：通常是 `entid` 或参数错误，重新获取企业主体后再试 - `code=20000` 且无记录：直接说明该企业在该维度下无记录 - `discover` 无匹配：先尝试同义词；仍无结果时，说明当前版本暂不支持该维度 故障排查优先级：本地配置（API Key/额度/网络）→ 服务端状态（entid/无数据）→ 更新 Skill（`openclaw skills update china-company-search-fengniao`）。 ## 快速开始 ```bash # 1. 先按维度发现工具 node scripts/tool.mjs discover "企业股东信息" # 2. 再模糊搜索企业，获取 entid node scripts/tool.mjs call biz_fuzzy_search --params '{"key":"腾讯"}' # 3. 用 entid 查询具体维度 node scripts/tool.mjs call biz_shareholders --params '{"entid":"AerjZTfkSh0"}' ```