shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 效率与办公API Key 暂未确认

抵押物穿透查询

抵押物穿透查询：给定抵押物线索（小区 / 楼盘 / 地块 / 门牌，或资产类型词如「工业用地」「商铺」「采矿权」「机器设备」，可再带面积区间），在公开债权公告中反查关联债权——定位公告、债务人、出让方与保证人，并从公告披露文本中解析抵押物的名称、坐落与面积。当用户说「查一下某小区某面积的抵押物情况」「XX 花园 / XX 地块有没有被抵押在债权公告里」「某类抵押物对应哪些债权」时使用。免注册免登录，只做公开公告的只读检索与原文解析。英文触发词：collateral lookup, mortgage collateral search, collateral reverse lookup, 抵押物查询。若用户要按行业与金额筛债权标的，改用 debtop-debt-screening；若只要公告清单，改用 debtop-notice-search；若要某家出让方的处置清单，改用 debtop-creditor-disposal。

person作者: debtophubModelScope
open_in_new仓库download下载资源包

抵押物穿透查询（游客免登录）

给定抵押物线索（小区 / 楼盘 / 地块 / 门牌，或资产类型词，可再带面积区间），在公开公告口径的债权公告中反查关联债权：命中公告、债务人、出让方、保证人，并从公告披露文本中解析抵押物的名称、坐落与面积；每条引用都原样附详情页链接。

抵押物是公告里的自由文本，不是结构化字段——本 Skill 的产出是「公告披露了什么」，不是权属或价值结论，请遵守 §七 的合规与限流要求。 本 Skill 的端点与令牌仅授权用于 agent.debtop.com；调用前请确认端点与此一致。

何时使用

  • 用户说「查一下某小区 / 某楼盘某面积的抵押物情况」
  • 用户说「XX 花园 / XX 地块 / XX 门牌有没有出现在债权公告里」
  • 用户说「某类抵押物（工业用地 / 商铺 / 采矿权 / 机器设备）对应哪些债权」
  • 用户手里有一条抵押物线索，想反查它关联的债务人、出让方与公告

与相邻 Skill 的分工：本 Skill 以抵押物为入口做反查与原文解析；若要按行业 / 地区 / 金额筛债权标的，用 debtop-debt-screening；若只是按任意关键词列公告清单，用 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_notice / get_debt_notice_detail / search_debt_enterprise / get_debt_enterprise_debt_summary）→ 该 MCP 已在客户端配置好，直接调用（凭据由平台注入）；一个都看不到 → 未配置为连接器，只能自行走 HTTP + 游客通道（见 @references/guest-access.md），或引导用户先到平台配置该连接器。

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

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

第 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_notice | 公告全文检索（本 Skill 主入口：抵押物词直接搜公告） | keyword | | get_debt_notice_detail | 公告详情（抵押物原文的唯一来源） | notice_id | | search_debt_enterprise | 企业搜索（反查维度：命中哪些企业主体名下有此抵押物线索） | keyword（单一名称） | | get_debt_enterprise_debt_summary | 企业债务概要（补充该主体的债务规模） | enterprise_id |

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

  • 入参统一 snake_case（page_size / notice_id / enterprise_id）；ID 参数整数与字符串都可传；page_size 默认 10，工具接受 1–100，但上游按 20 截断。
  • 两个维度都能按抵押物线索搜，但覆盖差异很大：公告维度是全文（标题、主体名、抵押物文本），实测「采矿权」1698 条、「商铺」9298 条；企业维度命中企业名与关联文本，覆盖窄得多（同词仅个位数，如「工业用地」2 家）。以公告维度为主，企业维度做补充反查。
  • 抵押物原文只在 get_debt_notice_detail 的 collateral（自由文本、条件字段、可能整体缺失）；search_debt_notice 的列表项不含 collateral。
  • 四个工具都返回 detail_url（详情页链接）——输出时务必原样附上（见 §五）。

四、抵押物排查流程

  1. 确认抵押物线索 — 区分两类输入：
    • 具体标的（小区 / 楼盘 / 地块 / 门牌，如「锦绣东方」）→ 直接作为关键词
    • 资产类型（如 工业用地 商铺 采矿权 机器设备 土地使用权）→ 作为关键词，但要注意它是类词，命中量大、需要收窄
    • 面积区间（如 100–300㎡）→ 不能当检索参数，只在第 4 步解析后过滤
  2. 双维度检索（串行、间隔 ≥1 秒）
    • 主：search_debt_notice(keyword=线索, page_size=20)，每条结果的 detail_url 都要留着；命中多时翻页（page 递增）或给线索加限定词（加地名 / 加资产类型）收窄
    • 辅：search_debt_enterprise(keyword=线索, page_size=20)，得到企业主体候选；再对候选企业补 get_debt_enterprise_debt_summary(enterprise_id=...)（可选）
    • 两类结果按 notice_id / enterprise_id 去重，并注明来源维度
  3. 逐条拉详情 — 对命中公告调用 get_debt_notice_detail(notice_id=...)，取 collateral、guarantor、original_creditor、debtor、creditor、area
    • 只对可能相关的条目拉详情（每轮建议 ≤10 条），命中量很大时先按 notice_date 倒序取前若干条
  4. 解析抵押物条目与面积（本地解析，工具不提供面积）
    • 把 collateral 按换行 / 分号 / ①②③④⑤ / 顿号切成独立条目
    • 每条抽取：资产类型（土地 / 房产 / 商铺 / 厂房 / 在建工程 / 采矿权 / 股权 / 机器设备 / 车辆）、坐落或小区名、面积
    • 面积统一识别 ㎡、m²、平方米 三种写法，带千分位逗号（如 19,649.02㎡）先去掉逗号再转数值；亩 保留原单位并注明未换算
    • 需要面积区间过滤时，用解析出的数值比较；解析不出面积的条目单列，不要跳过、不要猜
  5. 核对线索 — 用户给的是具体小区 / 门牌时，核对解析出的坐落是否真的包含该线索（同名词可能指向不同标的）；不确定的标注「需人工核对坐落」
  6. 输出 — 按 §五 出「命中概览 / 抵押物清单 / 主体与担保 / 未披露说明 / 提示」

请克制调用次数（共享配额）：一次排查建议控制在 20 次工具调用以内（检索 ≤6 次、详情 ≤10 次、企业补充 ≤4 次）。

五、输出与链接规则

输出模板见 @templates/collateral-check-report.md（命中概览 / 抵押物清单 / 主体与担保 / 未披露说明 / 提示 五节）；字段为空时按模板中的说明处理，不要编造。

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

## 抵押物穿透查询：{线索}{面积区间}
> 数据来源：智收云公开债权公告（公告维度命中 {notice_total} 条、企业维度命中 {ent_total} 家）｜查询时间：{yyyy-MM-dd HH:mm}｜口径：公开公告原文，非权属证明

1. 命中概览 —— 线索、检索维度（公告 / 企业）、命中条数、已核对公告数、公告时段、地区分布
2. 抵押物清单 —— 线索匹配度、资产类型、坐落 / 小区、面积（原文）、所在公告（标题 + 链接）、债务人、出让方
3. 主体与担保 —— 债务人（拆分去重）、债权人 / 出让方、保证人、原债权人
4. 未披露说明 —— 命中但 `collateral` 缺失的公告条数；解析不出面积的条目（原样列出）
5. 提示 —— 原文口径；面积为公告披露文本解析值、非测绘值；同名标的需核对坐落；命中总数达 10000 可能被截断；链接为接口返回值（原样引用）

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

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

其它输出要求：

  • 原文优先：抵押物一律引用公告原文（可截断长文本但不得改写措辞），解析结果与原文并列，便于用户核对。
  • 面积标明来源与单位：面积是从公告文本解析的数值，不是测绘或评估值；亩 不换算，原样保留并注明。
  • 区分命中与确认：命中公告 ≠ 该标的的权属确认；同名词（同名小区 / 同名地块）必须标注「需人工核对坐落」。
  • ID 不可臆造：notice_id / enterprise_id 一律取自上一跳搜索结果；notice_id 是纯数字（int64）。
  • 条数如实标注：命中总数以返回的 total 为准，展示条数以本次实际取得为准（分页按 20 截断）。
  • 串行调用、留出间隔：相邻工具调用至少间隔 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、关键词过宽） | | RESOURCE_NOT_FOUND | 换 notice_id 或关键词重查，不臆造 ID | | 某条公告无 collateral | 正常现象（条件字段）：记为「公告未披露抵押物」，不要换成别的公告 | | 上游 5xx / 超时 | 保留已取得的清单结果，并提示用户稍后再试；不要继续翻页 |

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

七、合规与限流

  • 原文口径、不越界：抵押物来自公告披露文本，因此
    • 必须标注数据来源（智收云公开公告）与查询时间；
    • 必须声明**「公告原文口径，非权属证明、非征信报告」**，不用公告数据推断标的权属、价值或是否已解押；
    • 不给法律 / 估值 / 交易结论（不说「该小区房产已被查封」「可折价收购」之类），只陈述"公告披露了什么"；
    • 面积为文本解析值，非测绘值；同名标的未核对坐落前不得合并。
  • 只读、禁止批量导出：4 个工具均为只读查询；禁止用它做整库拉取、爬取或长期归档。分页实际按 20 截断（见 @references/tools-and-fields.md），需要更多请翻页并控制节奏。
  • 命中总数可能被截断：total 达到 10000 时表示可能已被上限截断（类词如 土地使用权 易触发），输出时应说明，不要声称"全量"。
  • 取不到数据时：类词可尝试同义写法（工业用地 / 土地 / 土地使用权）或叠加地名收窄，各重试一次；仍 0 命中时如实告知"未检索到含该抵押物线索的公开公告"，不得编造公告或抵押物。
  • 限流是共享配额（数值见 §一）：超限 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_notice(keyword=<抵押物词>, page_size=5) 验证取数
  • 异常优先降级：出现连续 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/collateral-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 <challenge> <difficulty> |