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からDatagouvにSIRENまたは正確な法人名が送信されることを説明し、ユーザーが明示的に確認した後にのみ実行します。利用できない場合、またはユーザーが希望しない場合は、一度だけ「法的健全性の確認は利用できないため、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…）を削除して、連続する空白を1つにまとめます。正規化したキーで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：集団手続きに関する公告 — redressement judiciaire（再建型の法的整理）、liquidation judiciaire（司法清算）、sauvegarde（事業保護手続き）— 公告日を含めます。
• 誠実さを重視：各判定には根拠を添えます。「✅ DD/MMにBODACCで確認済み。該当なし」のように示す一方、「⚠️ 検証できません（SIRENなし／一致なし／登記情報にアクセスできません）」とも明記します。data.gouv経由のBODACC情報は一部に限られる場合があります。その旨を伝え、確認結果がクリーンでも「該当なし」と表現し、「健全であることが保証される」とは伝えません。

5. カウンターパーティごとにスコアを付ける 🟢🟡🔴

エクスポージャー × 法的健全性 × 支払い遅延を組み合わせます。

• 🔴 未払いがある状態で集団手続きが開始されている、または活動停止／登録抹消となっている場合。あるいは、重要な金額が90日を超えて期限超過している場合。
• 🟡 支払い傾向が悪化している、エクスポージャーが大きいのに法的状況を確認できない、または現在のエクスポージャーがない状態で手続きが見つかった場合。
• 🟢 健全性が確認されている（または兆候がない）うえ、支払いが期日どおりの場合。

各スコアには、色だけでなく、判断に用いた情報を1行で示します。

6. レポート — 出力形式

必ず、会話内で以下の Markdown テーブルを返してください。

1. リスクテーブル（取引先・エクスポージャー €・平均遅延日数・法的状況＋確認日・スコア 🟢🟡🔴・理由を1行で）。リスク、次にエクスポージャーの順に並べてください。
2. 優先アラート。緊急度の高いものから順に並べてください。シグナルの組み合わせが重要です。例：「取引先 X は N € の未払いがあります（請求書の支払期限から D 日経過）。さらに、BODACC では DD/MM に管財手続きの開始が示されています → 債権を届け出て、本日中に配達証明付き郵便で督促してください（債権届出期限：公告から2か月）。」
3. カバレッジに関する注記：確認済み／確認不能／レジストリ利用不可の取引先数。

さらに、ホストがファイルをレンダリングできる場合（claude.ai artifacts、Claude Desktop、Claude Code）：HTML ダッシュボード — リスクマトリックス（エクスポージャー対法的状況）、滞留期間グラフ、アラートカード。ホストがファイルをレンダリングできない場合は、そのことには触れないでください。納品物は Markdown テーブルです。

ガードレール

• 完全な読み取り専用 — Qonto の書き込みツールは一切呼び出しません。このスキルには承認、署名、実行するものはありません。
• 現在の会話内でユーザーから明示的な確認を得ない限り、Qonto 由来の SIREN や正式名称を Datagouv に送信しないでください。
• 法的状況を記載する際は、必ず情報源と日付を明記してください。対象範囲が不完全な場合や SIREN が不明な場合は、「何も見つからなかった」を「健全」と同一視しないでください。
• 法的アラートは兆候であり、法的助言ではありません。手続きが開始されている場合は、行動する前に bodacc.fr で確認し、弁護士または会計士に相談するよう勧めてください。
• 正直に機能を制限してください。Datagouv MCP がない場合は、Qonto の情報のみでスコアリングし、その旨を1回だけ伝えてください。フランス国外の取引先については、エクスポージャーと遅延日数のみを示してください。
• IBAN は末尾4桁以外をマスキングしてください。すべてのページネーションを行ってください（per_page ≤ 50）。