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