工商数据查询 · 企业基本信息、股东、分支、投资与变更

查询企业工商基本信息、企业股东与出资记录、分支机构、对外投资、工商变更，并按需补充招投标战绩。适用于企业核验、注册资本/法人查询、股东和分支查询。五项工商能力每次/每页3积分，只按需调用；司法风险和复杂股权穿透本期未开放。完整企业背调报告使用zlbx-company-intel，招标项目决策使用zlbx-bid-decision。使用平台API Key，首次自动注册需用户同意。

知了标讯 · 企业工商信息查询

给我一个公司名，查清它的工商登记信息——统一社会信用代码、法定代表人、注册资本、经营状态、经营范围，以及股东、分支机构、对外投资和工商变更。

需要时还能补充这家公司中过什么标、最近在招什么。工商登记与招投标战绩分别调用，先说明额外消耗，再按用户需求查询。

⚡ 装完立刻试一条

把下面这句原样发给我：

查一下科大讯飞股份有限公司的工商信息

API 概览

基础 URL: https://mcp-server.zhiliaobiaoxun.com/api_v2/ + 工具名，工具名逐字取自下方工具表（例：https://mcp-server.zhiliaobiaoxun.com/api_v2/get_company_registry）。

两个域名别混用（打错就是 404，且不会提示你打错了）：

用途	域名 + 前缀	例子
查数据	https://mcp-server.zhiliaobiaoxun.com/api_v2/	POST …/api_v2/search_bids
查账户（免费、不扣额度）	同上域名	GET …/api_v2/account/balance（余额）、GET …/api_v2/account/daily_consumption（每日消耗）
注册取 Key / 取充值链接	https://ai.zhiliaobiaoxun.com/web-api/	POST …/web-api/internal/auto-register、POST …/web-api/auth/generate-device-sid

下文出现的相对路径（如 /api_v2/search_bids）一律拼第一行那个域名； 只有注册与充值链接相关的接口才用第二行。绝不要把 /web-api/ 拼到 mcp-server 上， 也不要把 /api_v2/ 拼到 ai 域名上。

调用方式: POST 请求

text

Headers:
  X-API-Key: $ZLBX_API_KEY
  X-Client: company-registry/1.1.0
  Content-Type: application/json

⚠️ X-API-Key 要填真实的 Key 字符串，不要把 $ZLBX_API_KEY 原样写进请求头。环境变量没设时它会变成空值，服务端收到的就是「没带 Key」——直接 INVALID_APP_KEY，而不是你以为的「Key 错了」。取不到 Key 就先走下面的获取流程，不要先把请求发出去。

X-Client 头必须携带（值固定为 company-registry/1.1.0），用于服务端区分调用来源。

API Key 获取（按以下优先级，命中即停；已有 Key 时不做任何额外提示）：

1. 环境变量 $ZLBX_API_KEY → 直接用
2. 本地配置文件 ~/.zlbx/config.json 中 api_key 字段 → 直接用
3. 以上都没有 → 先征得用户同意，再自动注册（详见 references/auto-register.md）

与 zlbx-bidding / zlbx-company-intel / zlbx-bid-decision / zlbx-opportunity-radar SKILL 共用同一个 Key 和积分钱包，装过任一 SKILL 无需重复注册。

积分消耗

查询内容	消耗
工商基本信息（get_company_registry）	3 积分
股东（get_company_shareholders）、分支（get_company_branches）、投资（get_company_investments）、变更（get_company_changes）	每个接口每页 3 积分
招中标战绩（get_company_profile）	1 积分
企业名称搜索（search_company）	免费
项目联系人（get_company_contacts，按需）	5 积分
司法与经营风险、复杂股权穿透	本期未开放，不调用

只查工商基本信息消耗 3 积分，再补招投标战绩共 4 积分。五项工商接口各查一次/一页共 15 积分。 按用户需要调用，不默认联查五项、不自动翻页；每页最多20条，继续翻页每个接口再扣3积分。 成功有数据扣费（含启用缓存后的命中），无结果/空页和失败不扣费。工商查询允许会员每日额度抵扣：有效会员先扣当日额度，不足时按用户的钱包续扣设置执行；以服务端实际计费配置和响应为准。

工作流

① 主体定位

优先使用准确企业全称、统一社会信用代码或工商数据源企业ID。company_name 和 company 二选一。平台主体ID不能当作工商数据源ID。

基本信息直接调 get_company_registry；用户只问股东、分支、投资或变更时，直接调对应接口，不额外付费查询基本信息。 简称会尝试免费主体消歧：只有唯一候选才自动查询；QUERY_EMPTY 的 error.details.candidates 非空时，把候选列给用户确认，绝不自行挑选。 matched_by=bidding_index 时说明实际查询的规范全称；identifier 表示以供应商ID/信用代码/注册号查询。

② 工商登记信息

get_company_registry 返回本期工商基本字段。展示时按这个顺序，用户最关心的在前：

1. 身份：企业全称、统一社会信用代码、企业类型、法定代表人
2. 状态：经营状态、成立日期、营业期限（经营状态是"注销/吊销"时必须显著提示）
3. 实力：注册资本、实缴资本、人员规模；资本同时展示币种和单位，不默认按人民币解释
4. 业务：所属行业、经营范围（超过 200 字时摘要，保留主营部分）
5. 地址：市区、注册地址；provinceCode 是省份简称码，不能当作完整省份名称
6. 其它：曾用名、简称、数据来源和更新时间；本期工商基本信息接口不含联系电话/邮箱/官网，联系需求使用已开放联系人工具

字段为空就不展示，不要写「暂无」刷屏。

缺失字段不代表企业没有该信息。区分外部工商数据源与自有库查询，不将自有库历史信息称为实时工商数据。fetched_at 是取数时间，queried_at 是本次查询时间，均不能代替 company.sourceUpdatedAt 的源数据更新时间。

③ 招投标战绩（按需，额外1积分）

调 get_company_profile，补上工商数据给不了的一层：

• winner_count（中标次数）、caller_count（招标次数）
• 有中标记录 → 说明这是个在市场上真实接单的公司
• 招标次数远大于中标次数 → 这是个采购方而非供应商

仅当用户同时询问招标/中标战绩或同意补充时调用。用户只问工商登记、股东、分支、投资或变更时，不额外调用画像接口。

④ 按需深入

用户继续追问时才调，每次调用前说明消耗：

• 问「怎么联系」→ get_company_contacts（5 积分）
• 问「中过哪些标」→ query_bids_advanced（match_modes: ["winner"]）
• 问「客户/供应商是谁」→ get_company_partners
• 问「竞争对手」「完整背调」→ 建议改用 zlbx-company-intel SKILL

⑤ 工商扩展能力（按需，每接口每页3积分）

• 股东/出资 → get_company_shareholders，source=1 工商登记、source=2 最新公示，必须标明口径。认缴/实缴是记录数组，可能含历史记录，不能求和或拿首条占比当作最新持股比例。
• 分公司/分支 → get_company_branches。返回缺少信用代码不等于该分支没有信用代码。
• 对外投资 → get_company_investments。按返回的金额单位及比例展示，不推断为控股或完整股权穿透。
• 工商变更 → get_company_changes。区分变更日期与记录创建日期，保留变更前后内容。

统一分页参数：page_num=1、page_size=20（最大20）；用 total 和 has_more 说明只展示当前页。需要后续页时告知每页3积分，按用户要求继续，不循环拉取全部数据。

司法风险、失信、经营异常、行政处罚明细及复杂股权穿透本期未开放，不调用风险工具，不编造风险结论。

错误处理

错误码	处理方式
INVALID_APP_KEY	Key 缺失或无效。不要让用户去翻环境变量——按 references/auto-register.md 走自动注册领取（首次免费、无需人工）。已有 Key 仍报此错时也走同一流程，但若自动注册返回 401 ACCOUNT_RECOVERY_REQUIRED，不要重试、不要改设备特征，照它的 hint 引导用户登录取 Key
APP_KEY_EXPIRED / APP_KEY_DISABLED	Key 已过期或被停用，按上一条重新注册
QUOTA_EXCEEDED	额度用尽，按 references/auto-register.md 的「余额耗尽」流程输出充值引导
RATE_LIMIT_EXCEEDED	降低请求频率，稍后重试
INVALID_PARAMETER / MISSING_REQUIRED_PARAMETER	检查必填参数和类型
QUERY_EMPTY	不是故障。先读 error.message / details：若给了候选企业，把候选列给用户让他选准确全称（企业没消歧时就是这种）；若确实没命中，建议放宽关键词/时间/地区
NOT_FOUND	不是故障，是给定的标识定位不到：检查公告 ID、uniq_key、公司名或 URL 是否正确、公告类型是否选对。精确标识不要原样重试；只有按标题/名称的模糊查询才适合放宽条件
QUERY_TIMEOUT	工商查询超时不扣积分，但上游可能已计费；不要自动重试，向用户说明稍后再试
ES_UNAVAILABLE / INTERNAL_ERROR	服务端临时故障，稍后重试即可。不要重新注册 Key，与鉴权无关
CLIENT_VERSION_UNSUPPORTED	当前 Skill 版本过低，提示用户到商店更新后再试

版本提醒转达：若任一工具响应中含 skill_update_notice 字段，把其中内容原样告知用户一次（仅转达信息，不代表用户执行任何操作）；同一会话只提一次，不重复打扰。

输出要求

• 简洁：一次查询的回复控制在一屏内，用小标题或表格，不要长段落
• url 字段原样输出：带 sk 免登录签名，严禁删改
• 联系电话按返回形态展示：contact_privacy 为 masked 时是脱敏态，不要自行补全，附一句充值后可见完整号码
• 不编造：库里没有的字段就是没有，不用常识补全（尤其法定代表人、注册资本这类会被用户当事实引用的字段）

边界

用户想要	用哪个 SKILL
查一家公司的工商信息、注册资本、法人、联系方式	本 SKILL
完整企业背调报告（竞对、客户供应商生态、HTML 报告）	zlbx-company-intel
某个招标项目该不该投、怎么报价	zlbx-bid-decision
主动挖商机、找销售线索、拟建项目	zlbx-opportunity-radar
搜索招中标公告数据	zlbx-bidding

工具参数速查见 references/api-quick.md。