使用说明
工商云MCP服务
描述
面向企业尽调、供应商准入、客户信用评级、投资研究与风险监控场景的企业情报 MCP 工具集,覆盖工商注册、股东治理、经营动态、司法涉诉、税务风险、环保处罚、供应链上下游、投融资及舆情监测等多个维度,共 33 个工具。
标签
工商信息 股权穿透 司法涉诉 税务风险 供应链图谱 投融资 舆情监测 企业尽调 供应商准入 风险监控
数据源:市场监管、税务、法院、海关等权威官方公开数据,覆盖全国企业法人及个体工商户
数据指标
| 指标 | 数值 |
|---|---|
| 工具数量 | 33 个 |
| 数据维度 | 30+ 维度 |
| 覆盖主体 | 中国大陆境内企业法人、个体工商户 |
| 数据更新 | 工商、司法等核心数据 T+1 更新 |
| 传输协议 | MCP Streamable HTTP |
什么是工商云 MCP 服务?
工商云 MCP 服务是一套面向 AI Agent 的企业情报查询工具集,基于 Model Context Protocol(MCP)协议,让大模型能够直接调用企业工商登记、股权治理、经营动态、司法涉诉、税务风险等全维度结构化数据能力。
核心价值:将原本需要多个系统、多次查询、人工汇总的企业背调工作,转化为 AI Agent 一键完成的自动化流程——从单一主体核验到股权穿透,从供应商准入到存量客户风险扫描。
关键特性
- 全维数据覆盖:工商、经营、司法、税务、环保、供应链、投融资、舆情等 30+ 维度,33 个工具一次注册、全量可用
- 主体身份核验:统一社会信用代码、企业名称、法定代表人、注册资本、成立日期、登记状态、照面信息一站获取
- 股权与治理穿透:股东结构、出资比例、主要人员、董监高任职、工商变更记录、分支机构层层穿透
- 风险扫描能力:司法涉诉、被执行、失信、经营异常、欠税、非正常户、环保处罚、税务黑名单一键扫描
- 供应链图谱:上游供应商、下游客户、对外投资、关联企业与集团关系清晰呈现
- 统一调用参数:全部工具统一使用
companyName/creditcode二选一入参,支持统一社会信用代码精准定位 - 远程 HTTP 协议:原生支持 Streamable HTTP 长连接远程调用,无需本地部署,即开即用
接入配置
1. 获取 AppKey
登录工商云 MCP 数据智能体平台,进入账户控制台,在「我的AppKey」中创建应用并获取 AppKey,用于服务调用鉴权。
- 服务管理端:
https://mcpops.yunyucloudai.com - 接入文档:
https://mcpops.yunyucloudai.com/docs
2. 配置 MCP 客户端
主流 AI 客户端的 MCP 配置示例(推荐)
{
"mcpServers": {
"mcp-data-nexus": {
"type": "streamableHttp",
"url": "https://mcp.yunyucloudai.com/data-nexus/mcp",
"headers": {
"X-App-Key": "your_app_key_here"
}
}
}
}
通用 HTTP (curl)
curl -X POST https://mcp.yunyucloudai.com/data-nexus/mcp \
-H "Content-Type: application/json" \
-H "X-App-Key: your_app_key_here" \
-d '{
"jsonrpc": "2.0",
"method": "tools/list",
"id": 1
}'
curl -X POST https:"comment">//mcp.yunyucloudai.com/data-nexus/mcp \
-H "Content-Type: application/json" \
-H "X-App-Key: your_app_key_here" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "entinfo",
"arguments": {
"companyName": "腾讯科技(深圳)有限公司"
}
},
"id": 1
}'
将
your_app_key_here替换为管理端申请到的 AppKey;
3. 调用参数说明
所有 33 个工具均支持以下统一参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
companyName |
String | 否 | 企业完整名称,如「宇树科技股份有限公司」 |
creditcode |
String | 否 | 统一社会信用代码 / 注册号,如「91310000MA1FL3xxxx」 |
companyName和creditcode只需传一个值,优先使用统一社会信用代码(查询更精确)。
4. 调用示例
查询企业工商照面信息:
{
"companyName": "宇树科技股份有限公司"
}
查询企业司法风险:
{
"creditcode": "91310000MA1FL3xxxx"
}
错误码说明
当请求发生错误时,响应中的 error 字段会包含以下错误码:
| 错误码 | 说明 | 解决方案 |
|---|---|---|
APPKEY_MISSING |
请求头中缺少 AppKey | 请在请求头中添加 X-App-Key |
APPKEY_INVALID |
AppKey 无效或已禁用 | 请检查 AppKey 是否正确,或联系管理员 |
BALANCE_INSUFFICIENT |
账户余额不足 | 请充值后重试 |
QUOTA_EXHAUSTED |
免费额度或套餐次数已用完 | 请充值或购买套餐 |
PROVIDER_TIMEOUT |
数据源响应超时 | 请稍后重试 |
PROVIDER_ERROR |
数据源返回错误 | 请检查请求参数是否正确 |
TOOL_NOT_FOUND |
指定的工具不存在 | 请检查工具名称是否正确 |
PARAM_INVALID |
请求参数格式错误 | 请参考文档检查参数格式 |
RATE_LIMIT_EXCEEDED |
请求频率超限 | 请降低请求频率 |
INTERNAL_ERROR |
服务器内部错误 | 请稍后重试或联系客服 |
工具完整清单
共 33 个工具,按功能分为 4 大类。
一、基本信息(base,6 个工具)
| 工具名 | 功能 | 参数 |
|---|---|---|
entinfo |
【企业工商照面信息】查询企业的核心注册档案。返回:企业名称、统一社会信用代码、法定代表人、注册资本、成立日期、经营状态、登记机关、注册地址、经营范围、企业类型、营业期限等。适用于首次查询某家企业、了解注册资本/法人/成立时间/经营范围等场景;问"查工商信息""查一下企业信息"时可组合调用全部基础工具进行全面查询。 | companyName / creditcode(二选一) |
shareholder |
【股东信息】查询企业的股东及出资情况。返回:股东名称/姓名、股东类型(自然人/企业法人)、认缴出资额、实缴出资额、出资比例(持股比例)、出资方式、出资日期等。适用于查询股东是谁、股权结构、大股东、实际控制人、持股比例、国资背景、股东变更等。 | companyName / creditcode(二选一) |
person |
【主要管理人员】查询企业的董事、监事、高级管理人员等关键人员信息。返回:姓名、职务(董事长/总经理/财务负责人等)、任职状态、兼任其他企业职务情况等。适用于查询法人、董事长、高管名单、董监高、管理团队、核心人员等。 | companyName / creditcode(二选一) |
alter |
【工商变更信息】查询企业历史工商登记变更记录。返回:变更事项(名称/法人/注册资本/经营范围/地址/股东等)、变更前内容、变更后内容、变更日期等。适用于查询法人更换、注册资本变化、经营范围调整、股权变更历史、历史名称、迁址记录、增资记录等。 | companyName / creditcode(二选一) |
filtation |
【分支机构】查询企业下设的分公司、子公司、办事处等分支机构信息。返回:分支机构名称、统一社会信用代码、负责人、成立日期、经营状态、注册地址、经营范围等。适用于查询分公司/子公司分布、全国布局等。 | companyName / creditcode(二选一) |
annual_report |
【企业年报信息】查询企业每年向市场监管部门提交的年度报告。返回:资产总额、负债总额、营收、净利润、纳税总额、社保参保人数、网站/网店信息、对外投资、股权变更记录等。适用于查询年报数据、参保人数、营收规模、资产状况、纳税情况等。注意:年报数据由企业自主申报,非实时财务审计数据。 | companyName / creditcode(二选一) |
二、经营信息(business,8 个工具)
| 工具名 | 功能 | 参数 |
|---|---|---|
cncaquery |
【资质认证信息】查询企业获得的行政许可与资质证书。返回:CCC 认证、ISO 体系认证、建筑业企业资质、食品经营许可证、医疗器械许可证、高新技术企业认定等各类资质证书信息。 | companyName / creditcode(二选一) |
customer |
【客户信息】查询企业披露的主要客户(下游)及销售依赖情况。返回:主要客户名称、销售金额、销售占比等。适用于分析下游客户、销售集中度等。 | companyName / creditcode(二选一) |
supplier |
【供应商信息】查询企业披露的主要供应商(上游)及采购依赖情况。返回:主要供应商名称、采购金额、采购占比等。适用于分析上游供应链、采购依赖等。 | companyName / creditcode(二选一) |
gaccttrade_query |
【海关进出口信息】查询企业的进出口贸易记录与报关数据。返回:进出口商品名称、贸易方式(一般贸易/加工贸易等)、报关口岸、贸易国别、进出口金额等。 | companyName / creditcode(二选一) |
issuebond |
【企业债券信息】查询企业发行债券及债务融资工具的情况。返回:债券名称、债券类型(公司债/企业债/中期票据等)、发行规模、票面利率、到期日期、信用评级、募集资金用途等。 | companyName / creditcode(二选一) |
land_purchase |
【土地购置信息】查询企业参与土地招拍挂、获取土地使用权的情况。返回:地块位置、面积、成交价格、土地用途(住宅/商业/工业)、出让方式(拍卖/挂牌/协议)、签订日期等。 | companyName / creditcode(二选一) |
tax_credit_query |
【纳税信用等级】查询企业税务部门的年度纳税信用评级。返回:纳税信用等级(A/B/C/D/M 级)、评价年度、主管税务机关等。 | companyName / creditcode(二选一) |
invevents |
【投融资事件】查询企业参与的融资、投资、并购、IPO 等资本运作事件。返回:融资轮次、融资金额、投资方、投后估值、并购标的、上市板块等。 | companyName / creditcode(二选一) |
三、经营风险(risk,9 个工具)
| 工具名 | 功能 | 参数 |
|---|---|---|
double_rand |
【双随机抽查信息】查询市场监管部门对企业开展的"双随机、一公开"抽查检查结果。返回:抽查日期、抽查事项、检查结果(正常/责令整改/发现问题待处理等)。 | companyName / creditcode(二选一) |
ent_pubip_info |
【知识产权出质信息】查询企业将专利、商标等知识产权质押融资的记录。返回:出质知识产权名称/号、质权人、出质期限、登记日期等。 | companyName / creditcode(二选一) |
environmental_punish |
【环保处罚信息】查询企业因环境违法行为受到的行政处罚记录。返回:处罚日期、违法行为、处罚金额、处罚机关、整改要求等。 | companyName / creditcode(二选一) |
mortgage_info |
【动产抵押信息】查询企业将机器设备、车辆、原材料等动产进行抵押融资的记录。返回:抵押物描述、抵押权人、抵押金额、登记日期、履约状态等。 | companyName / creditcode(二选一) |
quick_cancel |
【简易注销公告】查询企业发布的简易注销公告及异议信息。返回:公告期、公告日期、异议状态、是否完成注销等。 | companyName / creditcode(二选一) |
tax_arrears |
【欠税公告信息】查询企业被税务机关公告的欠税情况。返回:欠税税种、欠税金额、欠税所属期、公告日期、税务机关等。 | companyName / creditcode(二选一) |
tax_improper |
【税务非正常户信息】查询企业被税务机关认定为非正常户(走逃失联)的记录。返回:认定日期、认定机关、非正常户原因等。注意:非正常户是严重税务失信状态,通常意味着企业已失联或停止纳税申报。 | companyName / creditcode(二选一) |
opinion_list |
【舆情列表】查询与企业相关的公开新闻报道、网络舆情、负面事件等。返回:舆情标题、来源媒体、发布时间、情感倾向(正面/负面/中性)等列表。注意:舆情是新闻/社交媒体信息,不是官方工商/司法数据。 | companyName / creditcode(二选一) |
opinion_detail |
【舆情详情】查询单条舆情的详细内容与上下文。返回:完整正文、原文地址、相关图片、关联企业等。通常需先调用 opinion_list 获取舆情 ID,再调用本工具查详情。 |
companyName / creditcode(二选一) |
四、司法风险(judicial,10 个工具)
| 工具名 | 功能 | 参数 |
|---|---|---|
tax_punish |
【税收违法案件信息】查询企业因偷税、逃税、骗税、抗税等被税务机关查处的重大案件。返回:违法事实、处罚决定、罚款金额、案件性质、处罚日期等。注意:本工具查询的是重大税收违法案件(黑名单级别),与普通的欠税公告不同。 | companyName / creditcode(二选一) |
final_case |
【终本案件信息】查询企业作为被执行人,因无财产可供执行而被法院裁定"终结本次执行程序"的案件。返回:案号、执行法院、立案日期、终本日期、执行标的金额、未履行金额等。注意:终本 ≠ 结案,只是暂时中止执行,发现财产后可恢复。 | companyName / creditcode(二选一) |
judicialaid |
【司法协助信息】查询法院要求市场监管等部门协助执行的记录,主要是股权冻结。返回:被执行人、冻结股权数额、冻结期限、执行法院、解冻日期等。 | companyName / creditcode(二选一) |
judgment_documents |
【裁判文书】查询企业涉及的已审结判决书、裁定书等裁判文书。返回:案号、案由、案件身份(原告/被告)、审理法院、裁判日期、判决结果等。 | companyName / creditcode(二选一) |
court_notice |
【法院公告】查询企业涉及的法院公告(送达、破产、清算、执行等类型)。返回:公告类型、公告内容、刊登日期、发布法院等。 | companyName / creditcode(二选一) |
judicial_sale |
【司法拍卖】查询企业名下财产被法院司法拍卖的记录。返回:拍卖标的(房产/土地/股权/设备等)、起拍价、评估价、拍卖时间、拍卖结果等。 | companyName / creditcode(二选一) |
delivery_notice |
【送达公告】查询法院向企业公告送达法律文书的记录。返回:送达文书类型、受送达人、送达方式、公告日期等。 | companyName / creditcode(二选一) |
limit_high |
【限制高消费】查询企业或其法定代表人被法院发布限制高消费令的记录。返回:限制内容、发布日期、申请执行人、关联案号等。 | companyName / creditcode(二选一) |
case_filing |
【立案信息】查询企业作为当事人被法院立案受理的诉讼案件。返回:案号、案由、立案日期、受理法院、案件身份(原告/被告)等。 | companyName / creditcode(二选一) |
trial_notice |
【开庭公告】查询企业涉及案件的即将开庭审理公告。返回:案号、开庭时间、开庭地点(法院/法庭)、案由、案件身份等。 | companyName / creditcode(二选一) |
使用案例
入门级 ⭐
场景一:单主体工商核验
需求:快速确认一家企业的注册档案是否真实、是否存续
调用工具:entinfo
输入:
宇树科技股份有限公司 工商信息
输出:企业名称、统一社会信用代码、法定代表人、注册资本、成立日期、经营状态、经营范围等
标准级 ⭐⭐
场景二:企业基础背调
需求:对目标企业做常规尽调,摸清"谁在控制、有没有变更"
调用工具链:
entinfo → shareholder → person → alter → filtation → annual_report
输入:
宇树科技股份有限公司 背调报告
输出:工商照面 + 股权结构 + 董监高名单 + 变更沿革 + 分支机构布局 + 年报数据
场景三:供应商 / 客户准入核查
需求:合作前确认对方是否存在诉讼、处罚、经营异常
调用工具链:
entinfo → environmental_punish → tax_arrears → tax_improper → double_rand
→ final_case → limit_high → case_filing
输出:✅ 无风险记录 / ⚠️ 存在风险点(列出具体事项)
进阶级 ⭐⭐⭐
场景四:股权穿透与实际控制人识别
需求:识别目标企业的实际控制人与关联方网络
调用工具链:
shareholder → person → invevents → alter
→ 对每个法人股东:shareholder(继续向上穿透)
→ 结合 person 兼任情况判断实际控制人
输入:
宇树科技股份有限公司 实际控制人穿透
输出:股权层级图 + 出资比例链 + 实际控制人判断依据
场景五:供应链上下游关系分析
需求:判断目标企业在产业链中的位置与依赖度
调用工具链:
entinfo → customer → supplier → gaccttrade_query → cncaquery
输出:下游客户集中度、上游供应商集中度、进出口结构、资质门槛
专家级 ⭐⭐⭐⭐
场景六:存量客户持续风险监控
需求:对存量客户或关联方做持续风险扫描,出现信号即时预警
调用工具链:
定期扫描:environmental_punish + tax_arrears + tax_punish + final_case
→ 结合 alter 监控股权/法人变动
→ 结合 quick_cancel 监控简易注销动向
输出:风险变化清单 + 预警提示
场景七:投资尽调风险总览
需求:投前对目标企业做完整风险画像
调用工具链:
entinfo → shareholder → alter → invevents → issuebond → land_purchase
→ tax_punish → final_case → judicialaid → judgment_documents
→ court_notice → judicial_sale → delivery_notice → limit_high
→ case_filing → trial_notice → opinion_list → opinion_detail
输出:主体真实性 + 股权稳定性 + 涉诉全景 + 税务合规 + 舆情面,形成投资风险总览
最佳实践
- 精准查询优先:有统一社会信用代码时优先使用
creditcode,避免因企业名称相似导致查询偏差。 - 组合调用:企业尽调场景建议组合调用
entinfo+shareholder+alter+ 司法类工具(tax_punish、final_case、judicialaid、judgment_documents、court_notice、judicial_sale、delivery_notice、limit_high、case_filing、trial_notice)+tax_credit_query+customer+supplier,形成完整画像。 - 风险扫描:定期调用
environmental_punish、tax_arrears、final_case、alter、tax_punish、judgment_documents等工具监控存量客户风险。 - 先列表后详情:舆情类工具遵循
opinion_list→opinion_detail两步调用,先取 ID 再查正文。 - 异常处理:若查询结果为空,请核对名称准确性;新注册企业可能存在 T+1 数据同步延迟。
常见问题
Q:数据权威性? A:源自市场监管、税务、法院、海关等官方公开数据,经清洗对齐,以官方登记为准。
Q:数据更新频率? A:工商照面、司法风险等核心数据 T+1 更新;年报、舆情等按官方发布周期同步。
Q:包含注销企业吗? A:包含,并标注经营状态(存续/注销/吊销等),便于区分主体有效性。
Q:支持个体工商户查询吗? A:支持,可通过企业名称或统一社会信用代码查询个体工商户的登记与风险信息。
Q:查询不到企业怎么办? A:请核对名称准确性或尝试使用统一社会信用代码;若为新注册企业,可能存在数据同步延迟。
Q:数据覆盖哪些维度? A:覆盖工商注册、股东治理、年报、资质认证、供应链、司法涉诉、税务风险、环保处罚、投融资及舆情等 30 余个维度。
Q:会涉及个人隐私吗? A:不会。本服务仅提供公开可查的企业信息,不涉及个人隐私、企业内部未公开财务数据或实时股价。
Q:调用需要传 AppKey 吗? A:不需要。AppKey 在接入配置阶段完成绑定,由服务端在每次工具调用时自动注入。
售后支持范围
一、服务范围
| 项目 | 说明 |
|---|---|
| 数据查询服务 | 提供企业工商、经营、司法、税务、环保、供应链、投融资、舆情等全维度信息查询 |
| API 接入支持 | 提供 MCP SDK 接入指导、接口调试、鉴权配置等技术支持 |
| 数据质量保障 | 对查询结果缺失、明显错误等数据质量问题提供核实与修正 |
| 使用咨询 | 提供工具选型建议、调用策略优化、场景化解决方案咨询 |
二、时间范围
| 服务类型 | 支持时间 |
|---|---|
| 在线技术支持 | 工作日 9:00 - 18:00(北京时间),法定节假日除外 |
| 工单响应 | 工作日 24 小时内响应 |
| 紧急故障 | 7×24 小时值班响应(P0 级故障) |
三、业务范围
| 支持项 | 具体内容 |
|---|---|
| 接入指导 | MCP 服务开通、AppKey 配置、SDK 集成、调试排错 |
| 接口咨询 | 工具功能说明、参数释义、返回字段解析、调用示例 |
| 数据答疑 | 数据来源说明、更新周期、覆盖范围、异常结果核实 |
| 故障处理 | 服务不可用、接口超时、鉴权失败、返回异常等技术故障 |
| 计费咨询 | 调用量查询、费用明细、套餐升级、发票申请 |
四、费用范围
| 项目 | 说明 |
|---|---|
| 技术支持 | 标准技术支持服务免费(含接入指导、接口咨询、数据答疑) |
| 定制开发 | 超出标准接口范围的定制需求,按人天评估报价 |
| 专属服务 | 私有化部署、数据定制清洗、批量导出等增值服务,另行商务洽谈 |
| 费用不包含 | 客户自有系统的开发、运维、服务器资源及第三方接口费用 |
服务限制
- 本服务仅提供中国大陆境内企业的公开信息查询,不支持境外企业
- 数据来源于官方公开渠道,不保证 100% 实时同步,存在 T+1 至 T+7 的合理延迟
- 不支持涉及个人隐私、企业内部未公开财务数据、实时股价等敏感信息查询
- 单次查询结果仅供商业决策参考,不构成法律、投资或合规专业意见
- 严禁将本服务用于非法爬虫、数据倒卖、骚扰营销等违规用途
版本信息
- 协议:MCP Streamable HTTP
- 鉴权:AppKey
- 工具数量:33 个 / 4 大类
- 服务管理端:https://mcpops.yunyucloudai.com
- 接入文档:https://mcpops.yunyucloudai.com/docs
