local-leads-mcp

local-leads-mcp

通过 AI Agent 查找需要网站的本地商家，并验证结果。

一个 MCP 服务，通过 OpenStreetMap 发现本地商家，再用一系列检查来验证结果，将真正的潜在客户名单与一堆误报区分开来。专为使用 Claude、Cursor 或任何 MCP 客户端进行客户开发的自由职业者和代理机构打造。

核心工作流无需 API 密钥：发现商家、验证网站、检查电子邮件可送达性和评估网站质量，全部基于免费的开放基础设施（Overpass、Nominatim、DNS-over-HTTPS、纯 HTTP）。

为什么不用地图抓取工具？

本地客户开发的难点不在于获取商家名单，而在于不出洋相。基于原始地图数据构建的潜在客户名单里陷阱很多，而本服务会专门检查这些问题：

• “没有网站”并不一定是真的。 OSM 数据可能过时；缺少 website 标签并不能证明什么。verify_website 会检查根域名、www 和重定向（根域名无法解析、网站却正常托管在 www. 上，是典型的“没有网站”误报），而 confirm_no_website 会通过网页搜索作最终确认。
• Facebook 页面不等于网站。 社交资料、预约平台（Fresha、TheFork、Treatwell……）、目录列表和免费子域名（*.wixsite.com、*.business.site……）都会被归类为 not_own_site，而不是“有网站”。
• 会退回的电子邮件。 check_mx 可以在你联系潜在客户之前预测邮件是否可送达（没有 MX = 必定退信；仅支持 PEC 的域名会被标记）。
• “网站很差”需要证据。 score_website 会返回可引用的问题（没有 HTTPS、没有移动端 viewport、缺少 title/meta/H1、没有 sitemap……），而不是凭感觉判断；还可选择通过 PageSpeed API 获取 Lighthouse 评分。

每项判定都会附上产生该结果的原始检查数据，因此你的 Agent 可以展示判断依据。

快速开始（60 秒）

{
  "mcpServers": {
    "local-leads": {
      "command": "uvx",
      "args": ["local-leads-mcp"]
    }
  }
}

就这么简单，无需凭据。接下来可以向你的 Agent 提出类似这样的要求：

找出 Turin 20 家没有网站的餐厅，逐一验证，并为我导出一份 CSV，列出已确认的商家及其电话号码。

可选环境变量

变量	启用功能
BRAVE_API_KEY	通过 Brave Search API 使用 confirm_no_website
GOOGLE_CSE_API_KEY + GOOGLE_CSE_CX	通过 Google Programmable Search 使用 confirm_no_website
PAGESPEED_API_KEY	在 score_website 中获取 Lighthouse 评分

工具

发现（OpenStreetMap — 无需密钥）

• find_businesses(area, category, website_filter, phone_prefix, require_phone, limit) — 查找城市或街区内的商家，并根据网站是否存在进行筛选。支持约 35 个便捷类别，以及任意原始 OSM key=value 标签。
• list_categories() — 列出类别与 OSM 标签的映射。

验证（无需密钥）

• verify_website(domain_or_url) — 判定结果：live_own_site、not_own_site、domain_exists_no_site、no_website_found；包含每个 URL 的证据。
• check_mx(domain) — 通过 DNS-over-HTTPS 预先检查电子邮件是否可送达。

评估（无需密钥；PageSpeed 为可选项）

• score_website(url) — 0–100 的网站质量评分，列出具体问题，并检测 CMS/技术栈（WordPress、Wix、Shopify……）。

确认（需要搜索密钥）

• confirm_no_website(business_name, city) — 最终确认“真的没有网站吗？”，将搜索结果分类为自有网站候选项、目录列表或社交页面。

导出

• export_leads(leads_json, format) — 导出为 CSV、JSON 或 Markdown 表格。

道德规范与公平使用

• 数据来源均为公开信息：OpenStreetMap（© OSM contributors，ODbL）、公开 DNS，以及商家自己的公开页面。
• OSM 请求在本地受到速率限制（调用间隔至少为 1 秒），并根据 Nominatim 和 Overpass 使用政策携带描述性 User-Agent。对于高负载工作，请运行自己的 Overpass 实例。
• 此服务用于发现和验证，不会抓取个人邮箱，也不会发送任何内容。如何联系商家由你自行决定：请遵守当地法规（包括 GDPR 等）。

另请参阅

seo-stack-mcp — 用于 SEO 数据的同类工具：在一个 MCP 服务中整合 Google Search Console、GA4、Bing Webmaster 和 Microsoft Clarity。使用 local-leads 开发潜在客户，然后用 seo-stack 监测你搭建的网站。

许可证

MIT。

---

由 Raffaele Nocera 开发——为本地商家提供 Web 咨询服务。如果此工具帮你赢得了客户，我很乐意听听你的反馈。