Lead Leak Check

lead-leak-check（MCP server）

最初の接点から最初の担当者による返信までの間に、見込み客からの問い合わせが気づかれないまま放置される箇所を特定します。

Zapier、Make、または n8n の実行結果は Success です。それでも、見込み客からの返信はありません。返信の担当者が決まっていない、空のフィールドでフィルターに引っかかった、ワークフローが1日停止していた、あるいは AI の下書きが送信されずに残っていた、といったことが原因です。lead-leak-check は、見込み客のパイプラインの説明を、リスクの高い順に並べたリストに変換し、それぞれに具体的な修正方法を提示します。

ツール

ツール	入力	出力
check_pipeline	パイプラインの JSON 設定（流入元、保存先、振り分け、返信、監視など）	0～100のリスクスコアと、高・中・低・要確認の順に並べた検出結果
check_pipeline_description	平易な英語の説明。例：「Typeform と WhatsApp から Zapier 経由で Google Sheets に送られるが、担当者は割り当てられていない」	同じレポートに加えて、テキストの解釈内容
analyze_run_history	実行履歴の CSV エクスポート（status 列と、任意の timestamp）	失敗およびフィルタリングされた実行、実行がない長い空白期間、古いワークフロー

リソース：leakcheck://rules には、全15件のルールの説明と修正方法が記載されています。

説明されていない項目は、安全と判断されず、すべて要確認として報告されます。ネットワークへの接続はなく、データがマシンの外に送信されることもありません。

インストール

git clone https://github.com/paopao-studio-ai/lead-leak-check-mcp && cd lead-leak-check-mcp
pip install .            # Python 3.10+, works with mcp 1.x and 2.x

ワンクリックバンドル（MCPB）

最新リリースからlead-leak-check-mcp-0.1.0.mcpbをダウンロードし、Claude Desktop（またはMCPB対応のクライアント）で開きます。uvが必要です。依存関係は自動的にインストールされます。

Claude Desktop／Cursor／任意の MCP クライアント

{
  "mcpServers": {
    "lead-leak-check": { "command": "lead-leak-check-mcp" }
  }
}

インストールせずに実行する場合：{"command": "python", "args": ["-m", "lead_leak_check.server"], "env": {"PYTHONPATH": "/path/to/lead-leak-check-mcp/src"}}

コマンドライン

lead-leak-check check examples/pipeline.json
lead-leak-check describe "WhatsApp leads land in Google Sheets via Make.com. Nobody is assigned."
lead-leak-check history examples/run_history.csv --interval 30
lead-leak-check --json check examples/pipeline.json

設定の形式（すべてのキーは任意）

{
  "name": "Typeform -> Google Sheets -> Slack #sales",
  "sources": [{ "type": "web_form", "required_contact_field": false }, { "type": "whatsapp", "logged_to_storage": false }],
  "storage": { "type": "google_sheets", "dedupe": false },
  "routing": { "owner_assignment": "none", "after_hours_coverage": false },
  "response": { "sla_minutes": 30, "auto_ack": true, "ai_drafts": true, "human_send_step": false },
  "monitoring": { "error_alerts": false, "unanswered_lead_alert": false, "run_history_review": "never" },
  "automation": { "platform": "zapier", "plan": "free" },
  "timezone": { "business_tz": "America/New_York", "automation_tz": "UTC" },
  "follow_up": { "sequence": false }
}

出力例（上記の設定に対するレポートの冒頭）：

# Lead leak risk: Typeform -> Google Sheets -> Slack #sales
Risk score: **100/100** (12 findings)
## 1. [HIGH] Nobody owns the first reply
- Why it leaks: Leads posted to a shared sheet or channel are seen by everyone and answered by no one.
- Fix: Assign an owner per lead (round robin or fixed) at the moment it is created, and name them in the notification.

最も重要な検出結果を無料で修正する

最もよくある重大度の高い検出結果は、「見込み客から返信がない場合に通知がない」です。無料の n8n missed-lead heartbeat テンプレート（https://github.com/paopao-studio-ai/n8n-missed-lead-heartbeat）は、5分ごとにシートまたは CRM を確認し、見込み客の待ち時間が SLA を超えると、Slack、Discord、または任意の Webhook に通知します。

担当者にマッピングを依頼しますか？

Paopao Studio では、定額料金の Lead Leak Check（$197） を提供しています。1～2件の見込み客ワークフローを対象とした書面による漏出マップで、30日以内に Starter の構築をご依頼いただくと、料金全額を充当します。メールでのスクリーンショット確認は無料です。 → https://paopao-studio.pages.dev/?utm_source=github&utm_medium=oss&utm_campaign=lead_leak_1029

開発

pip install -e ".[test]"
pytest -q          # rule tests + an end-to-end stdio round trip with the official MCP client

ライセンス

MITです。詳細はLICENSEをご覧ください。