智收云(debtop.com)沉淀 30 万+ 不良资产(NPA)债权转让与处置公告数据, 数据源覆盖报纸电子版、AMC 官网、产权交易所、阿里资产、京东法拍等。 服务以 MCP(Model Context Protocol)托管服务形式提供,无需本地部署,开箱即用。
https://agent.debtop.com/mcp/debt/stream
Authorization: Bearer <PAT>
debtop-debt(客户端配置中的 server 标识)
debtor 列出的企业可查到;
用 creditor(AMC / 银行等出让方)名称查询返回 0 命中属正常现象
登录智收云后进入 控制台, 在「连接配置」中即可看到你的访问令牌。令牌默认以掩码显示, 点击「显示」查看明文,点击「复制」可直接复制含真实令牌的完整配置。
将下面的配置粘贴到客户端的 MCP 配置文件中,并把 <你的 PAT> 替换为上一步复制的令牌:
{
"mcpServers": {
"debtop-debt": {
"type": "streamableHttp",
"url": "https://agent.debtop.com/mcp/debt/stream",
"headers": {
"Authorization": "Bearer <你的 PAT>"
},
"timeout": 30000
}
}
}
部分客户端只需填写服务地址与请求头,字段名可能略有差异(如 headers、auth),
按客户端说明对应填写即可。
保存配置后在客户端中调用一次工具列表;也可以用下面的命令自测(把 <你的 PAT> 换成真实令牌):
curl -X POST https://agent.debtop.com/mcp/debt/stream \
-H "Authorization: Bearer <你的 PAT>" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
在其他客户端中使用
任何支持 Streamable HTTP 的 MCP 客户端都可以接入,只需「服务地址 + 请求头」两项信息:
| 客户端 | 填写方式 |
|---|---|
| Claude Desktop / Claude Code | 在 MCP 配置中新增 server,type 选 http / streamableHttp,填入服务地址与 Authorization 请求头 |
| WorkBuddy | 连接器配置中填入服务地址与访问令牌(PAT) |
| Cursor | Settings → MCP → Add new MCP server,URL 模式填服务地址,请求头填 Authorization: Bearer <PAT> |
| Cherry Studio | 添加 MCP 服务器,类型选 Streamable HTTP,填服务地址与请求头 |
| 扣子 / 自研脚本 | 以 HTTP 请求调用服务地址,携带 Authorization 请求头即可 |
| 约定 | 说明 |
|---|---|
| 参数命名 |
入参统一 snake_case:page_size / notice_id / enterprise_id。
旧的驼峰写法(pageSize / noticeId / enterpriseId)仍可被接受,
但新代码请一律使用下划线(驼峰仅作过渡,后续可能移除)。
|
| ID 为纯数字(int64) |
公告 ID(notice_id)、企业 ID(enterprise_id)都是纯数字,
须从上一步搜索结果中取得,不要臆造或加前缀;ID 参数整数与字符串都可传,搜索结果里是整数,直接回传即可。
|
| 分页 |
列表类接口返回统一分页结构 { total, page, page_size, total_page, items };
page_size 默认 10,工具接受 1–100,但上游按 20 截断
(传更大值只会拿到 20 条,响应里 page_size 回显 20)。需要更多结果请翻页。
|
| 金额字段成对返回 |
每个金额都有两个字段:*_yuan(number,精确数值,用于比较、求和、换算)与
*_text(string,已格式化文本,如 "1.2万元")。
需要计算/排序时用 *_yuan,直接展示给用户时用 *_text,两者不要混用或自行换算。
|
| 返回包装 |
所有接口返回 { success, code, message, data }。
success=false 时 data 可能为 null,应读取 code / message 判断原因(见「6 错误处理」)。
注意:工具级错误仍以 HTTP 200 返回,需读取返回体内的 isError / code 才能发现。
|
| 条件字段可能整体缺失 |
guarantor(保证人)、collateral(抵押物)、original_creditor(原债权人)
仅在公告披露时才出现,可能整个 key 不存在(不是 null)。
取值前先判断字段是否存在;未披露时展示为「公告未披露」,不要编造。
|
debtor 是多主体串 |
一条公告常含多个债务人,debtor 以逗号分隔(如 甲公司,乙公司),
debtor_num 即主体个数。做关联方延伸或按主体统计时,先按逗号拆分再逐个使用,不要把整串当作一个企业名。
|
| 关联方只返回前 3 |
related_creditors / related_debtors 各只返回前 3 个;
完整数量以 related_creditor_count / related_debtor_count 为准,不要以数组长度冒充总数。
|
| 详情链接 |
detail_url 为智收云站内详情页链接,形如 …/notice/<公告ID> 或 …/debtor/<企业ID>;
引用公告或企业时务必附上。全部按接口返回值原样使用,不要改写、缩短或猜测。
|
链接来源标识 source |
输出链接时需追加查询参数 source=<客户端标识>(这是对 detail_url 唯一允许的改动):
无查询参数用 ?source=…、已有参数用 &source=…、已有 source 则覆盖其值,同一链接内不得出现两个 source。
取值为小写英文 + 短横线(如 workbuddy、qwen-office、cursor),判断不出时用 mcp。
|
| 调用节奏 | 按「企业搜索 → 债务概要 → 公告搜索 → 详情」顺序串行执行,相邻调用间隔至少 1 秒; 配额为共享资源,不要并发突发或压测。 |
共 4 个 MCP 工具,均可通过客户端暴露的名称(如 mcp__debtop-debt__*)调用。
按关键词分页搜索债权转让/处置/招商等公告,返回公告列表。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
keyword |
string | 是 | 搜索关键词(企业名称、债权人、债务人均可);空值报 PARAM_INVALID: keyword 不能为空 |
page |
integer | 否 | 页码,默认 1 |
page_size |
integer | 否 | 每页数量,默认 10;工具接受 1–100,上游按 20 截断 |
data.items[] 字段| 字段 | 类型 | 说明 |
|---|---|---|
notice_id | integer | 公告 ID(详情查询用) |
title | string | 公告标题 |
notice_type | string | 公告类型代码,见下方枚举 |
notice_type_name | string | 公告类型中文名 |
source | string | 公告来源 |
notice_date | string | 公告日期,yyyy-MM-dd |
creditor | string | 债权人(受让方) |
original_creditor | string | 原债权人(转让方)。条件字段:转让类公告常见,可能整体缺失 |
debtor | string | 债务人,逗号分隔的多主体串(如 甲公司,乙公司),使用前先拆分 |
debtor_num | integer | 债务人主体个数(户数) |
area | string | 归属地 |
principal_amount_yuan / principal_amount_text | number / string | 公告债权本金(数值 / 展示文本) |
total_amount_yuan / total_amount_text | number / string | 公告债权总额(数值 / 展示文本) |
detail_url | string | 公告详情页链接(形如 …/notice/<公告ID>);引用时附上并带 source |
| 代码 | 含义 |
|---|---|
transfer | 转让公告 |
deal | 处置公告 |
market | 招商公告 |
collect | 催收公告 |
correct | 更正公告 |
trade | 处置挂牌 |
按公告 ID 查询单条公告的完整详情。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
notice_id |
integer | string | 是 | 公告 ID,取自 search_debt_notice 返回的 notice_id(整数或字符串均可) |
等于列表项全部字段,额外增加下列条件字段——仅在公告披露时才出现,可能整体缺失(key 不存在,不是 null):
| 字段 | 类型 | 说明 |
|---|---|---|
guarantor | string | 保证人(催收类公告通常有) |
collateral | string | 抵押物(催收类公告通常无,需判空) |
original_creditor | string | 原债权人(转让类公告常见) |
字段差异提示:催收类公告通常有 guarantor 而无 collateral;
转让类公告两者都可能缺失,但常多出 original_creditor。取值前先判断 key 是否存在。
按关键词分页搜索债务企业(企业画像的入口工具)。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
keyword |
string | 是 |
单一企业名称(不要传逗号分隔的多主体串);过宽的词会被拒
(PARAM_INVALID: 搜索内容过于宽泛),请用企业全称或较完整的简称
|
page |
integer | 否 | 页码,默认 1 |
page_size |
integer | 否 | 每页数量,默认 10;工具接受 1–100,上游按 20 截断 |
data.items[] 字段| 字段 | 类型 | 说明 |
|---|---|---|
enterprise_id | integer | 债务企业 ID(概要查询用) |
enterprise_name | string | 债务企业名称 |
detail_url | string | 债务企业详情页链接(形如 …/debtor/<企业ID>);引用时附上并带 source |
creditor(AMC / 银行等出让方)名称查询通常 0 命中,属正常现象,不是故障。
按企业 ID 查询该债务企业的公告债务汇总(转让类 + 处置招商类分别统计)。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
enterprise_id |
integer | string | 是 | 债务企业 ID,取自 search_debt_enterprise 返回的 enterprise_id(整数或字符串均可) |
| 字段 | 类型 | 说明 |
|---|---|---|
enterprise_id | integer | 债务企业 ID |
enterprise_name | string | 债务企业名称 |
transfer_notice_count | integer | 转让公告数量 |
transfer_principal_total_yuan / _text | number / string | 转让公告债务本金合计 |
transfer_interest_total_yuan / _text | number / string | 转让公告债务利息合计 |
disposal_notice_count | integer | 处置招商公告数量 |
disposal_principal_total_yuan / _text | number / string | 处置招商公告债务本金合计 |
disposal_interest_total_yuan / _text | number / string | 处置招商公告债务利息合计 |
related_creditors | string[] | 相关债权人,最多返回 3 个 |
related_creditor_count | integer | 相关债权人总数(可能大于数组长度) |
related_debtors | string[] | 相关债务人,最多返回 3 个 |
related_debtor_count | integer | 相关债务人总数(可能大于数组长度) |
related_sources | string | 相关公告来源,最多展示 2 个,超出以「等」结尾 |
related_notice_period | string | 相关公告时段,yyyy-MM-dd ~ yyyy-MM-dd |
detail_url | string | 债务企业详情链接 |
related_creditors / related_debtors 仅返回前 3 个;
若需完整数量请以 related_creditor_count / related_debtor_count 为准。
5.1 企业公告债务画像
给定一家企业名称,用 4 个工具串起来输出其在公开公告口径下的债务画像:主体概览、债务规模、 公告时间线、担保线索、关联方延伸,每条引用都附详情页链接。
- 定位主体 —
search_debt_enterprise(keyword=企业名):命中 1 条直接用其enterprise_id;命中多条时列出候选让用户确认(同名企业未确认归属前不得合并);0 命中或报「搜索内容过于宽泛」时换更完整的全称重试一次,仍不行则按下方降级路径从公告切入 - 取规模数据 —
get_debt_enterprise_debt_summary(enterprise_id=...):转让 / 处置两个口径的公告数、本金与利息合计、关联方、公告时段 - 拉时间线明细 —
search_debt_notice(keyword=企业名, page_size=20),每条结果的detail_url都要保留;超过 20 条时翻页或改用关联债务人名收窄 - 补担保线索 — 对金额最大或最新的 1~3 条调用
get_debt_notice_detail(notice_id=...),取guarantor/collateral - 扩展关联方 — 从
related_debtors、debtor(逗号分隔,先拆分)、creditor取名称,逐个再跑search_debt_notice
## {企业名称} 债务画像
> 数据来源:智收云公开债权公告({N} 条)|查询时间:{yyyy-MM-dd HH:mm}|口径:公开公告,非征信报告
1. 主体概览 —— 企业名称(链到企业详情页)、企业 ID、关联公告时段、
相关债权人(共 N 家)、相关债务人(共 N 户)、数据来源渠道
2. 债务规模 —— 转让类 / 处置·招商类:公告数、本金合计、利息合计
3. 公告时间线(按日期倒序,最多 20 条)—— 日期、类型、标题、债权人、本金、链接
4. 担保与标的 —— 抵押物、保证人、公告详情链接(未披露的写「公告未披露」)
5. 关联方延伸 —— 名称:命中 X 条公告,涉及本金 Y
6. 提示 —— 公开公告口径;金额 _yuan / _text 口径说明;链接为接口返回值(已带 source)
search_debt_notice(keyword=企业名, page_size=20) 从公告切入,
用 creditor / original_creditor / debtor / 金额 / notice_date
产出「债务规模 + 时间线 + 关联方」,并如实说明未取得企业维度概要,不得用公告数据反推企业概要结论。
5.2 定向检索与串联
- 搜索公告:用户给出企业/人名关键词 →
search_debt_notice(keyword=...),从items[].notice_id取公告 ID - 查详情:拿到公告 ID 后 →
get_debt_notice_detail(notice_id=...),补充保证人、抵押物 - 搜企业:用户想找某债务企业 →
search_debt_enterprise(keyword=...),从items[].enterprise_id取企业 ID - 查债务概要:拿到企业 ID 后 →
get_debt_enterprise_debt_summary(enterprise_id=...) - 串联:企业链路搜到的相关债权人/债务人,可再作为
search_debt_notice的 keyword 进一步检索
示例问法
| 场景 | 示例 |
|---|---|
| 企业债务画像 | 「XX 公司」欠了多少钱 / 有多少债务 / 债务情况怎么样 |
| 债务画像报告 | 帮我做个「XX 公司」的债务画像 / 风险画像 |
| 担保线索 | 「XX 公司」有哪些抵押物和保证人 |
| 公告搜索 | 帮我搜索关于「某某公司」的债权转让公告 |
| 企业债务概要 | 查一下这家债务企业的债务概要 |
| 近期公告 | 看看最近有哪些不良资产处置公告 |
所有接口返回统一为 { success, code, message, data }。success=false 时读取 code / message:
isError=true,看 code / 文案),
只有鉴权、限流、网关类错误才表现为 4xx / 5xx。只看 HTTP 状态码会把工具级错误当成成功。
| 返回 | 含义 | 处理方式 |
|---|---|---|
401 / AUTH_REQUIRED / AUTH_INVALID / TOKEN_EXPIRED |
无凭据或凭据失效——两者响应相同,无法区分 | 检查请求头中的 PAT 是否正确;在控制台重新复制令牌;已失效则重新生成并更新客户端配置 |
INSUFFICIENT_SCOPE / PERMISSION_DENIED |
权限不足(工具级错误,HTTP 仍为 200) | 说明需要对应权限(notice:read / enterprise:read) |
PARAM_INVALID |
参数错误 |
常见触发:keyword 为空、page_size 超过工具校验上限 100、
关键词过宽(搜索内容过于宽泛)。改用完整企业全称并检查参数后重试
|
RESOURCE_NOT_FOUND |
企业 / 公告不存在 | 换 ID 或用全称重查,不要臆造 ID |
429 / RATE_LIMITED |
已触达限流(说明链路本身是通的) | 指数退避后重试,降低并发,不要短时间内重复画像同一主体 |
GUEST_LIMITED |
游客通道限流(工具级错误,HTTP 仍为 200) | 退避 1 秒后重试;串联工具时保持串行(相邻调用间隔 ≥1 秒) |
UPSTREAM_TIMEOUT / INTERNAL_ERROR |
上游异常 | 稍后重试;连续 5xx / 超时时降级为「仅公告搜索」并提示用户稍后再试,不要反复重试放大故障 |
连接失败 / DNS 失败 / 超时 / 非 401 的 4xx(404、405 等):
说明服务不可达或路径不对,属「未接入」类问题,如实排查地址与网络即可,不要反复重试。
本服务输出的是公开公告数据,结论可能被用于尽调、合作判断或对外材料,请遵守以下要求:
| 要求 | 说明 |
|---|---|
| 标注来源与时间 | 必须标注数据来源(智收云公开公告)与查询时间 |
| 口径声明 | 必须声明「公开公告口径,非征信报告」;不得用公告数据推断未披露债务、偿付能力或信用等级, 也不做超出数据的因果与法律结论 |
| 同名企业不合并 | 同名企业未确认归属前不得合并统计;命中多条时列出候选让用户确认 |
| 只读、禁止批量导出 | 4 个工具均为只读查询,禁止整库拉取、爬取或长期归档;分页实际按 20 截断,需要更多请翻页并控制节奏 |
| 限流为共享配额 | 超限返回 429 会影响其他用户,不要做压测或并发突发;同一主体的画像避免短时间重复执行 |
| 调用节奏 | 串行调用,相邻调用间隔至少 1 秒;一次完整画像建议控制在 15 次工具调用以内 |
| 异常优先降级 | 连续 5xx / 超时时先降级为「仅公告搜索」,并提示「企业维度数据暂不可用,请稍后重试」 |
| 令牌使用范围 | 访问令牌仅授权用于 agent.debtop.com,不得用于其它部署或域名 |
Authorization 请求头即可,无需注册应用或配置回调。Authorization 即你的令牌。令牌默认隐藏,点击「显示」查看明文,点击「复制」直接复制完整配置。AUTH_INVALID / TOKEN_EXPIRED,请在控制台重新生成并更新客户端配置。RATE_LIMITED,稍后重试即可。debtor 列出的企业能查到;用 creditor(出让方)名称通常 0 命中,属正常现象。想按债权人检索请改用 search_debt_notice。page_size 传 100,为什么只返回 20 条?page_size 会回显 20。需要更多结果请递增 page 翻页,或收窄关键词。_yuan 还是 _text?*_yuan(number,精确值);直接展示给用户时用 *_text(已格式化文本,如「1.2万元」)。两者不要混用,也不要自行换算。guarantor / collateral / original_creditor 都是条件字段,仅公告披露时才出现(key 可能整体不存在)。取值前请判空,未披露时展示「公告未披露」,不要编造。