Lead Leak Check

lead-leak-check（MCP 服务）

找出从首次接触到首次人工回复之间，潜在客户在哪些环节被悄无声息地漏掉。

你的 Zapier、Make 或 n8n 运行记录显示 成功。但潜在客户仍然没有收到回复：没人负责回复，筛选器因字段为空而停止，工作流被关闭了一天，或者 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 未跟进潜在客户心跳检测模板（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。