安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install debtop-counterparty-check
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 debtop-counterparty-check。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

交易对手债务快速核查是 Openclaw Skills 之一，可在合作、采购、投资或签署合同前，快速查看与公司相关的公开债务公告。输入企业名称即可检查公告匹配情况，并在简洁、结论优先的报告中概述已披露债务规模、近期公告日期、主要债权人以及担保或抵押线索。
此技能使用由知守云公开债务公告数据支持的只读工具，并提供来源详情链接。这只是初步参考，并非信用报告或尽职调查结论：未匹配到记录并不能证明公司没有债务，且此技能不得给出信用评级或建议是否与某家公司合作。

应用场景

在签署协议前核查潜在业务伙伴。
在采购或招标审核期间快速检查供应商债务。
收集公开债务线索，作为投资、法律或业务审核的初步输入。
无需完整企业债务概况时，获取简明的结论卡片。
企业搜索未找到公司级匹配时，查找公告级证据。

工作原理

接收单个公司名称并搜索企业记录。
如果恰好匹配一家企业，则使用返回的 ID 获取债务摘要。如果匹配多条记录，请用户确认正确实体；不要合并记录。如果没有匹配记录，则使用全名重试，然后搜索公开公告。
搜索公告以查找近期动态和主要债权人，并保持每个返回的详情 URL 不变。
获取一至两条最新或金额最大的公告详情，核查已披露的保证人和抵押线索。
生成简明、结论优先的卡片，涵盖匹配情况、已披露规模、近期公告、债权人和担保。缺失字段应标记为不可用，不得编造数据。
包含数据来源、查询时间、来源链接，并注明必要免责声明：数据来自公开公告，并非信用报告。

配置指南

此技能专为零配置使用而设计：无需用户注册、登录、API key 或设置。如果 MCP 连接已可用，请直接调用其工具。否则，技能可以使用访客只读访问路径；该备用方式需要 HTTPS 访问权限，以及运行 curl 和 bash 或 python3 的能力。访客令牌和签名密钥仅授权用于 agent.debtop.com。

可选：查看技能的访客访问说明和脚本

cat references/guest-access.md
bash scripts/guest_token.sh

仅在访客访问流程要求时使用 PoW 辅助程序

python3 scripts/pow_solve.py
常规工作流程只需要公司名称。请按照访客访问参考说明获取和刷新令牌、检查端点及满足特定平台的前置条件；不要仅为探测 MCP 连接而创建访客身份。工具调用应按顺序进行，间隔至少一秒，并遵守服务限制。

数据架构

此技能查询服务端公开债务数据，不定义本地数据库，也不生成持久化数据文件。其软件包包含指南、报告模板和可选的访客访问脚本。
资源或字段 用途
references/guest-access.md 访客访问端点、令牌处理、前置条件和备用行为
references/tools-and-fields.md 工具参数、返回字段、枚举值和索引详情
references/errors.md 错误代码和恢复指南
references/client-source-ids.md 用于访客访问归因的客户端标识符
templates/counterparty-check-report.md 五部分、结论优先的报告结构
scripts/guest_token.sh 在需要该访问路径时获取访客访问令牌
scripts/pow_solve.py 在需要时解决工作量证明挑战
enterprise_id, notice_id 从工具结果中获取的 ID；绝不可编造
detail_url 服务返回的来源详情 URL；必须原样复现 *_yuan 和 *_text 使用数值型元字段进行计算，并使用对应文本字段展示；不要混用或自行转换 四种只读工具为 search_debt_enterprise、get_debt_enterprise_debt_summary、search_debt_notice 和 get_debt_notice_detail。公告和企业结果的覆盖范围可能不同。企业级未匹配不代表没有债务；公告搜索仍可能返回公开公告。

高级特性

支持使用已有的授权 MCP 连接或访客只读访问路径；参考资料中记录了令牌刷新和升级指南。
使用四种专用工具搜索企业、汇总债务、查找公告和检查公告详情。
遇到公司名称不明确时，请求用户确认实体，而不是合并可能匹配的结果。
企业级数据不可用时，改用公告搜索，并明确区分两种结果类型。
完全保留服务提供的详情 URL，并将其附加到相关企业和公告。
支持处理速率限制、身份验证、参数错误和服务中断；调用应保持顺序进行，且每次快速核查通常不超过八次工具调用。
强制实行只读、非批量使用，并要求清楚披露数据来源、查询时间、公开公告范围及调查结果的局限性。
将更深入的请求转交给相关技能：完整概况使用
debtop-enterprise-profile
，公告列表使用
debtop-notice-search
，债权人处置机会使用
debtop-creditor-disposal
。

name: debtop-counterparty-check display_name: 合作方债务速查
display_name_en: Counterparty Debt Quick Check
description: "合作方债务速查：给定一家企业名称，快速核查其公开债务线索，输出一页结论化速查卡——是否命中、债务规模（转让 / 处置口径的本金与利息）、最近公告时间、主要债权人与担保线索，用于商务合作、采购、投资、法务的前置参考。当用户说「要和 XX 合作，先查一下有没有债务」「XX 这家公司靠不靠谱 / 有没有债务风险」「签合同前帮我核一下对方」「合作方背景速查」时使用。只需企业名称，免注册免登录，输出为面向非专业用户的速查结论。英文触发词：counterparty check, company debt check, supplier risk check, vendor due diligence, quick background check。若用户要完整的债务画像，改用 debtop-enterprise-profile；若只要公告清单，改用 debtop-notice-search；若按债权人找处置标的，改用 debtop-creditor-disposal。" description_zh: "合作方债务速查：给定一家企业名称，快速核查其公开债务线索，输出一页结论化速查卡——是否命中、债务规模（转让 / 处置口径的本金与利息）、最近公告时间、主要债权人与担保线索，用于商务合作、采购、投资、法务的前置参考。当用户说「要和 XX 合作，先查一下有没有债务」「XX 这家公司靠不靠谱 / 有没有债务风险」「签合同前帮我核一下对方」「合作方背景速查」时使用。只需企业名称，免注册免登录，输出为面向非专业用户的速查结论。英文触发词：counterparty check, company debt check, supplier risk check, vendor due diligence, quick background check。若用户要完整的债务画像，改用 debtop-enterprise-profile；若只要公告清单，改用 debtop-notice-search；若按债权人找处置标的，改用 debtop-creditor-disposal。"
description_en: "Quickly check one company's publicly disclosed debt clues and return a one-page verdict card: whether any notice hits, debt scale (transfer / disposal principal and interest), latest notice date, main creditors and guarantee clues, as a pre-deal reference for business cooperation, procurement, investment and legal review. Use when the user asks 'I am about to work with X, any debt?', 'is this company reliable / risky', or wants a counterparty background check before signing. Only the enterprise name is needed, no sign-up and no configuration needed. For a full debt profile, use debtop-enterprise-profile; for notice lists, use debtop-notice-search; for creditor-side disposal lists, use debtop-creditor-disposal."
version: 1.0.1
author: 智收云
disable-model-invocation: false
user-invocable: true

合作方债务速查（游客免登录）

给定一家企业名称，快速核查其公开公告口径的债务线索，输出一页结论化速查卡：是否命中、债务规模、最近公告时间、主要债权人与担保线索，供商务合作 / 采购 / 投资 / 法务前置参考；每条引用都原样附详情页链接。

产出面向非专业用户，容易被直接用于合作决策，请务必遵守 §七 的合规要求（声明非征信、不代表无债务、不构成尽调结论）。 本 Skill 的端点与令牌仅授权用于 agent.debtop.com；调用前请确认端点与此一致。

数据来自智收云MCP（不良资产债权转让/处置公告，覆盖报纸电子版、AMC 官网、产权交易所、阿里资产、京东法拍等）。

何时使用
用户问「要和 XX 合作 / 签合同，先查一下它有没有债务」
用户问「XX 这家公司靠不靠谱 / 有没有债务风险 / 背景怎么样」
采购、招投标、投融资、法务在建立合作关系前要做一页式的快速核查
用户要的不是完整画像，而是能快速看完的结论（命中与否、规模量级、最近动态）

与相邻 Skill 的分工：本 Skill 是 debtop-enterprise-profile 的结论化、轻量版，面向前置核查；若要完整画像（六节明细），用 debtop-enterprise-profile；若只要公告清单，用 debtop-notice-search；若按债权人找处置标的，用 debtop-creditor-disposal。

一、零配置与能力边界

本 Skill 不需要注册、不需要登录、不需要填任何 key、不需要任何配置项：

情形 做法
该 MCP 已连接过（OAuth 授权，或客户端已配置 PAT） 直接调用工具，不做任何认证动作
尚未连接 本 Skill 自行以「游客（Guest）」身份取只读令牌（见 §二），用户直接提问即可

游客是只读身份、短时效、可限流、可审计：scope 为 notice:read + enterprise:read + guest:access（4 个工具全部可用）；access 30 分钟、refresh 1 天、单游客最长 7 天；调用限流 1 QPS（相邻调用间隔 ≥1 秒）、30 次/分、1000 次/天（共享配额）；创建游客另有配额（单 IP 3 次/小时、全局 500 次/天）。完整端点、能力边界与可直接复制执行的 curl 见 @references/guest-access.md。

运行前提：若该 MCP 已配成客户端连接器（见 §二），用户侧无任何要求；若需要走游客兜底，则要求运行侧能访问 HTTPS且可执行 curl 与 bash / python3（无脚本能力时按 @references/guest-access.md「运行前提与替代方案」处理）。

二、先判断「能不能直接用」（认证判定）

一句话结论：有工具就直接用（已配置）；只有 401 且客户端不能自动 OAuth 才创建游客；其余情况（工具级报错 / 429 / 连不上）一律不要创建游客。

第 0 步｜先看手里有没有工具（零成本，先做这一步）：当前会话能看到这 4 个工具（search_debt_enterprise / get_debt_enterprise_debt_summary / search_debt_notice / get_debt_notice_detail）→ 该 MCP 已在客户端配置好，直接调用（凭据由平台注入）；一个都看不到 → 未配置为连接器，只能自行走 HTTP + 游客通道（见 @references/guest-access.md），或引导用户先到平台配置该连接器。

客户端是否已配置，只能由「工具是否可见」与「探测响应」推断；SKILL 读不到平台的连接器配置，因此不要问用户"你配了吗"，直接按下述步骤探测。

第 1 步｜探测一次（仅当第 0 步无法确定时）：调一次 tools/list，或一次轻量工具调用（如 search_debt_enterprise(keyword=企业全称)）。不要用「创建游客」来探测——那会消耗创建配额。

第 2 步｜按返回判定：

返回 判定 动作 200 已配置且已授权 直接干活，不要再创建游客；后续沿用同一会话 401 + WWW-Authenticate: Bearer resource_metadata=… 链路通，但无凭据或凭据已过期（两者响应相同，无法区分） 客户端能自动 OAuth → 交给客户端（用户点一次）；否则走游客。若本机此前已取过游客令牌（缓存仍在），先刷新而不是重建——跨会话复用同一份缓存，不要每次对话都重建游客 200 但结果里 isError=true 工具级错误（HTTP 仍是 200）：INSUFFICIENT_SCOPE / GUEST_LIMITED / PARAM_INVALID scope 不足不要降级为游客（游客只读、权限更低）；限流退避 1 秒重试；参数问题改参数重试 429 已触达限流 → 说明链路本来就通 退避后重试，不要创建游客 连接失败 / DNS 失败 / 超时 / 404、405 等非 401 的 4xx 服务不可达或路径不对（属"未接入"） 不要创建游客、不要反复重建；如实告知用户该 MCP 未接入或地址有误

上表只适用探测 MCP 端点（/mcp/debt/stream）。创建游客与挑战端点的返回另有一套判定（404 FEATURE_DISABLED、401 AUTH_REQUIRED、POW_REQUIRED / POW_INVALID），详见 @references/errors.md。

三、可用工具（4 个，只读）
工具 用途 必填参数
search_debt_enterprise 企业搜索（速查入口：先确认主体是否存在） keyword（单一企业名称）
get_debt_enterprise_debt_summary 企业债务概要（速查核心：规模量级） enterprise_id
search_debt_notice 债权公告搜索（近况与主要债权人） keyword
get_debt_notice_detail 公告详情（担保线索） notice_id

四个要点（完整参数、返回字段、条件字段与枚举见 @references/tools-and-fields.md）：

入参统一 snake_case（page_size / notice_id / enterprise_id）；ID 参数整数与字符串都可传；page_size 默认 10，工具接受 1–100，但上游按 20 截断。
企业索引是债务人（融资方）维度：用 creditor（AMC / 银行等出让方）名通常查不到，属正常现象；要按债权人检索请改用 search_debt_notice。
debtor 是逗号分隔的多主体串（甲公司,乙公司），debtor_num 即主体个数；逐个使用前先拆分。
四个工具都返回 detail_url（详情页链接）——输出时务必原样附上（见 §五）。
四、速查流程
定位主体 — search_debt_enterprise(keyword=企业全称)
命中 1 条：直接用其 enterprise_id
命中多条：列出候选让用户确认（同名企业存在，不可臆断合并） 0 条：换更完整的全称重试一次；仍 0 条则按第 3 步从公告切入 取规模量级 — get_debt_enterprise_debt_summary(enterprise_id=...) → 转让 / 处置两个口径的公告数、本金与利息合计、关联债权人 / 债务人、公告时段
拉近况 — search_debt_notice(keyword=企业全称, page_size=20)，取最近公告日期与主要债权人；每条结果的 detail_url 都要留着
企业维度 0 命中时，这一步仍可能命中（公告索引同时覆盖出让方与融资方），据此给出「公告维度命中，但未取得企业维度概要」的结论
补担保线索 — 对最新或金额最大的 1～2 条调用 get_debt_notice_detail(notice_id=...)，取 guarantor / collateral
给结论 — 按 §五 输出速查卡：命中与否 → 规模量级 → 最近动态 → 主要债权人 → 担保线索 → 提示

速查求快求简：一次速查建议控制在 8 次工具调用以内；不要为了凑满模板而翻页或反复换词。

五、输出与链接规则

输出模板见 @templates/counterparty-check-report.md（速查结论 / 债务规模 / 最近公告 / 担保线索 / 提示 五节，结论置顶）；字段为空时按模板中的说明处理，不要编造。

读不到模板文件时（例如平台只分发 SKILL.md），按下面的骨架组织输出即可：

{企业名称} 合作方债务速查

数据来源：智收云公开债权公告｜查询时间：{yyyy-MM-dd HH:mm}｜口径：公开公告，非征信报告

结论速览：{是否有公开债务公告}｜规模量级：{本金合计约 X}｜最近公告：{最近日期}｜主要债权人：{前 3}

1. 速查结论 —— 命中公告 X 条；企业维度概要：{有/无}；一句话判断（只陈述公开信息，不给信用结论）
2. 债务规模 —— 转让类 / 处置·招商类：公告数、本金合计、利息合计
3. 最近公告（按日期倒序，最多 5 条）—— 日期、类型、标题、债权人、本金、链接
4. 担保线索 —— 抵押物、保证人、公告详情链接（未披露的写「公告未披露」）
5. 提示 —— 公开公告口径、非征信报告、未命中不代表无债务；链接为接口返回值（原样引用）

链接规则（原样引用，不做任何改写）：

引用必附链接：凡引用公告或企业，都要附上其 detail_url。链接形如 …/notice/（公告）或 …/debtor/（企业）；返回里没有该字段时写「暂无链接」。
链接一律原样输出：scheme、域名、路径、ID 与查询参数全部照搬接口返回值——不要追加、修改、覆盖或删除任何查询参数，不要添加任何来源/追踪标识，也不要缩短、改写或自行猜测链接。链接是服务端返回的数据，不是可加工的对象。
展示的链接文本与 href 用同一个 URL；企业名、标题做成可点击链接时同样照搬返回值。
说明：创建游客时上报的 skillId（客户端标识，同一产品的多端统一用同一个标识；取值见 @references/client-source-ids.md，表外客户端用 @scripts/client_id.py 生成）与 skillCode（本 SKILL 的包名，固定为 debtop-counterparty-check）都是请求字段，只用于服务端归属统计（见 @references/guest-access.md）；它们与输出链接无关，不要写进任何 URL。

其它输出要求：

结论置顶、篇幅克制：先给一句话速览，再给支撑明细；不要输出完整画像级别的长文（那是 debtop-enterprise-profile 的职责）。
金额成对返回：计算与排序用 *_yuan，展示给用户用 *_text，不要混用或自行换算。
ID 不可臆造：一律取自上一跳搜索结果；ID 是纯数字（int64）。
不给信用结论：只说"公开公告显示……"，不要输出"高风险 / 不可合作 / 建议拒签"之类的判断（见 §七）。
串行调用、留出间隔：相邻工具调用至少间隔 1 秒；按「企业搜索 → 债务概要 → 公告搜索 → 详情」顺序串行执行。
游客身份的边界：若某些字段为空或提示需登录明细，说明该数据需登录用户权限——应引导用户完成 OAuth 授权，并把当前游客绑定到该用户（POST /bff/v1/guest-access/upgrade，见 @references/guest-access.md）。
六、错误处置
情形 处置 401 / AUTH_REQUIRED / AUTH_INVALID 先刷新游客令牌；刷新也失败 → 重建游客并重试一次 GUEST_LIMITED（工具级错误，HTTP 仍为 200） 退避 1 秒后重试，保持串行 429 / RATE_LIMITED 指数退避、降低并发；创建类避免突发 PARAM_INVALID 改参数重试（空 keyword、page_size>100、关键词过宽）
企业维度 0 命中 不算故障：改用 search_debt_notice 从公告切入，并如实说明未取得企业维度概要
上游 5xx / 超时 降级为「仅公告搜索」，并提示用户稍后再试

完整错误码、工具级错误与两个端点的区别、逐项降级路径见 @references/errors.md。

七、合规与限流
面向非专业用户，结论必须稳健：
必须标注数据来源（智收云公开公告）与查询时间；
必须声明「公开公告口径，非征信报告」，并明确 「未命中不等于无债务」——本数据只覆盖公开披露的债权公告，不能证明企业无债务或偿债能力；
不得输出信用评级、合作建议、拒贷/拒签等结论，也不得用公告数据推断未披露债务或偿付能力；只陈述"公开公告显示什么"。
同名企业未确认归属前不得合并；候选多于一条时应先让用户确认主体。
只读、禁止批量导出：4 个工具均为只读查询；禁止用它做整库拉取、爬取或长期归档。分页实际按 20 截断（见 @references/tools-and-fields.md）。
企业维度取不到数据时：若 search_debt_enterprise 报 PARAM_INVALID: 搜索内容过于宽泛（如 公司 / 有限公司），或对具体全称仍为 0 命中，改用 search_debt_notice(keyword=企业名, page_size=20) 从公告切入，不得用公告数据反推企业概要结论。
限流是共享配额（数值见 §一）：超限 429 会影响其他用户，不要做压测或并发突发；同一主体的速查避免短时间重复执行。
数据处理范围（对外可明确说明）：本 Skill 只做三件事——① 用用户给的关键词调用本服务的只读查询工具；② 需要走游客通道时上报「客户端/平台标识（skillId）」与「本技能包名（skillCode）」，仅用于来源归属统计与配额防滥用；③ 原样返回服务端结果。不读取本地文件、不采集用户个人信息、不向任何第三方转发数据、不改写任何返回链接。
令牌仅限本服务：游客令牌与 Guest 签名密钥仅授权用于 agent.debtop.com；不得用于其它部署或域名。
接入前自查（首次接入或升级后各跑一次）：
BASE=https://agent.debtop.com

# 1) 发现元数据应含 x-guest-access 且 public_create=true
curl -s $BASE/.well-known/oauth-protected-resource | grep -qE '"public_create"[[:space:]]*:[[:space:]]*true' \

&& echo "元数据 OK (公开通道已开启)" # 注意: 响应是紧凑 JSON, 冒号后可能无空格

# 2) PoW 挑战端点应可达
curl -s -o /dev/null -w "challenge=%{http_code}\n" $BASE/bff/v1/guest-access/challenge
# 期望: 200；若为 404 说明 GUEST_PUBLIC_CREATE_ENABLED=false
# 3) 免凭据创建必须被要求 PoW（准入校验生效）
curl -s -X POST $BASE/bff/v1/guest-access -H 'Content-Type: application/json' -d '{"source":"web"}'
# 期望: {"success":false,"code":"POW_REQUIRED",...}
# 若直接返回 accessToken, 说明 PoW 校验被绕过（严重, 立即熔断: 置 false 并重建容器）
# 4) 拿到游客令牌后, 用一条 search_debt_enterprise(keyword=) 验证取数

异常优先降级：出现连续 5xx / 超时，先降级为「仅公告搜索」，并在回答中提示"企业维度数据暂不可用，请稍后重试"，不要反复重试放大故障。
八、本技能包资源与脚本

跨平台读法：表中的 @路径 是 WorkBuddy 的技能内引用写法；在其它平台按同名的相对路径读取同名文件即可（文件名与目录名完全一致）。脚本请用 bash / python3 显式调用（技能包内不含可执行位）；若平台不能执行脚本，按 @references/guest-access.md「运行前提与替代方案」处理。

资源 用途
@references/guest-access.md 零配置游客通道：端点、能力边界、可直接复制执行的 curl、令牌刷新、升级与降级路径
@references/tools-and-fields.md 4 个工具的完整参数、返回字段、条件字段、枚举与索引范围
@references/errors.md 错误码与处置、工具级错误与两个端点的错误区分
@references/client-source-ids.md 客户端标识对照表（创建游客时上报的 skillId 取值，60+ 客户端）
@templates/counterparty-check-report.md 速查卡输出模板（五节，结论置顶，含链接占位说明）
@scripts/guest_token.sh 取游客令牌：bash scripts/guest_token.sh [输出文件] [BASE]（失败非 0 退出并在 stderr 给出错误码）
@scripts/pow_solve.py 解 PoW 挑战：python3 scripts/pow_solve.py
EIN.LLC 激活续传

Laudex