qonto-counterparty-watch

Qonto 交易对手监控

在发票造成损失之前，了解谁欠你钱、谁正在拖延，以及谁正陷入法律困境。100 % 只读：该技能仅观察并发出提醒，绝不会在任何地方写入数据。

前提条件

1. get_organization → 账户、bank_account_id/IBAN（list_transactions 必需）、法定国家/地区。不硬编码任何内容：该技能会适配所找到的组织。
2. 按国家/地区处理：法律健康状况补充信息依赖法国公共登记系统（SIRENE、BODACC）。对于其他 Qonto 国家/地区（DE、ES、IT、AT、NL、BE、PT…），请明确说明，并退回到纯 Qonto 核心功能——风险敞口排名和付款延迟评分在所有地区均可用；绝不可假称查询了实际上并未查询的登记系统。
3. 可选补充信息——先检测，不要假定：仅在可用时使用已声明的 Datagouv 工具（search_datasets、query_resource_data）。不得通过文件系统或原生工具探测 MCP 是否可用。若可用 → 提供法律健康状况检查，并说明这些检查会将 Qonto 中的 SIREN 或准确法定名称发送至 Datagouv；仅在用户明确确认后启用。若不可用或用户拒绝 → 只需说明一次“法律健康状况检查不可用，将提供仅基于 Qonto 的评分”，然后继续。核心功能不得依赖这些工具。

工作流

1. 建立交易对手清单

• 客户：list_clients（使用 per_page: "50" 分页）→ 法定名称，以及存在时的 tax_identification_number。提取 SIREN：法国 VAT 号码格式为 FR + 2 位校验码 + 9 位 SIREN；保留这 9 位数字。按需使用 get_client 获取详细信息。
• 供应商：list_supplier_invoices（供应商名称、金额、状态）+ 每个账户调用 list_transactions（查询 12–24 个月的数据，按 3 个月分窗口，使用 per_page: "50"）→ 按标准化交易对手分组的经常性借记交易。
• 名称标准化（银行标签往往杂乱）：转为大写，去除 SEPA/转账前缀和参考编号，删除法律实体后缀（SARL、SAS、SASU、SA、EURL、SCI、GmbH…），合并多余空格。按标准化键合并 Qonto 客户记录与交易对手，并保留原始标签以供显示。

2. 计算每个交易对手的风险敞口

• 客户：汇总状态为未付款/逾期的 list_client_invoices 结果——金额、数量、最早到期日、逾期账龄分段（逾期 0–30 / 31–60 / 61–90 / 90+ 天）。
• 供应商：尚待支付的供应商发票 + 根据交易历史年化的经常性支出 → 依赖权重（若该供应商倒闭，会影响哪些业务）。

3. 衡量实际付款行为

按客户统计已付款发票：实际付款日期 − due_date（若存在则使用 paid_at，否则使用匹配的入账交易的 settled_at）。输出平均延迟、最长延迟和趋势（最近 3 张发票与之前的发票相比）——即使没有任何法律事件，客户的付款从 15 天逐渐拖到 45 天也是一种信号。

4. 检查法律健康状况（仅当 Datagouv 可用且用户已确认时）

对于每个有 SIREN 的交易对手（或准确法定名称匹配的交易对手，并注明置信度较低）：

• SIRENE：行政状态——正常经营、已停止经营、已注销。
• BODACC：集体程序公告——司法重整（receivership）、司法清算、司法保护——以及发布日期。
• 诚实也是一项功能：每个结论都附有证据——“✅ 已于 DD/MM 核验 BODACC，未发现记录”，或“⚠️ 无法核验（无 SIREN / 无匹配 / 登记系统不可访问）”。通过 data.gouv 获取的 BODACC 数据可能不完整：请说明这一点；检查无异常只能表述为“未发现记录”，绝不能说“保证经营状况良好”。

5. 为每个交易对手评分 🟢🟡🔴

综合考虑风险敞口 × 法律健康状况 × 付款延迟：

• 🔴 存在未结案的集体程序，或已停止经营/注销且仍有款项未收回；或大额款项逾期 90+ 天
• 🟡 付款趋势恶化、风险敞口较高但无法核验法律状况，或发现集体程序但当前无风险敞口
• 🟢 已核实经营状况良好（或无风险信号），且按时付款 每项评分都需用一句话说明依据——列出影响评分的因素，而不只是颜色。

6. 报告 — 输出格式

始终在对话中以 Markdown 表格回复：

1. 风险表（交易对手 · 风险敞口 € · 平均延迟 · 法律状况 + 核实日期 · 评分 🟢🟡🔴 · 一句话说明），按风险程度、再按风险敞口排序。
2. 优先警报，按紧急程度从高到低排列——重点是交叉信号："客户 X 欠你 N €（发票逾期 D 天），且 BODACC 显示已于 DD/MM 启动司法接管程序 → 今天通过挂号信申报债权并跟进（债权申报期限：自公告之日起 2 个月）。"
3. 覆盖情况说明：已核实／无法核实／登记系统不可用的交易对手数量。

此外，当宿主支持文件渲染时（claude.ai artifacts、Claude Desktop、Claude Code）：提供一个 HTML 仪表板——风险矩阵（风险敞口 vs 法律状况）、账龄图表、警报卡片。如果宿主无法渲染文件，则无需提及：Markdown 表格就是交付内容。

护栏

• 100% 只读——绝不调用任何 Qonto 写入工具；此技能不包含任何需要批准、签署或执行的操作。
• 未经用户在当前对话中明确确认，绝不将源自 Qonto 的 SIREN 或法定名称发送至 Datagouv。
• 陈述法律状况时，必须注明来源和日期；覆盖不完整或缺少 SIREN 时，绝不能把“未查到”视为“状况良好”。
• 法律警报只是信号，不构成法律建议：若存在未结程序，建议先在 bodacc.fr 确认，并在采取行动前咨询律师／会计师。
• 如实说明能力降级：没有 Datagouv MCP → 仅基于 Qonto 评分，并说明一次。非法国交易对手 → 仅提供风险敞口和延迟情况。
• 屏蔽 IBAN（仅显示最后 4 位）。所有内容均须分页（per_page ≤ 50）。