mcpField
L
local-leads-mcp

local-leads-mcp

ローカル
github.com/Raffaele86ビジネス・マーケティング015 週間前に更新

local-leads-mcp について

local-leads-mcpは、フリーランスや代理店向けに、OpenStreetMapから地域の事業者を探し、サイトの有無、メールの到達可能性、サイト品質を確認します。判定の根拠となるチェック内容も示し、基本のワークフローにAPIキーは不要です。

主な機能

  1. 01地域とカテゴリを指定した事業者検索
  2. 02サイトの状態と自社サイトかどうかの確認
  3. 03MXレコードによるメール到達可能性の事前確認
  4. 04具体的な問題点に基づくサイト評価
  5. 05CSV、JSON、Markdownでのエクスポート

活用シーン

  1. 01地域内で自社サイトのない事業者を探す
  2. 02サイト状態の確認で誤判定を除外
  3. 03連絡前に事業者のメールドメインを確認
  4. 04確認済みの見込み顧客を整理して出力

MCP 対応

MCPサーバーは、事業者検索、サイト確認、MXチェック、サイト評価、見込み顧客の確認と出力のツールを提供します。基本のワークフローにAPIキーは不要ですが、BraveまたはGoogle検索によるサイト不在の確認とPageSpeedスコアの追加には、それぞれのキーが必要です。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"raffaele86-local-leads": {
"command": "uvx",
"args": [
"local-leads-mcp"
],
"env": {
"BRAVE_API_KEY": "<BRAVE_API_KEY>",
"GOOGLE_CSE_API_KEY": "<GOOGLE_CSE_API_KEY>",
"GOOGLE_CSE_CX": "<GOOGLE_CSE_CX>",
"PAGESPEED_API_KEY": "<PAGESPEED_API_KEY>"
}
}
}
}
起動コマンドuvx local-leads-mcp
設定が必要な環境変数
BRAVE_API_KEYシークレットBrave Search API key (enables confirm_no_website)
GOOGLE_CSE_API_KEYシークレットGoogle Programmable Search API key (alternative to Brave)
GOOGLE_CSE_CXGoogle Programmable Search engine id (used with GOOGLE_CSE_API_KEY)
PAGESPEED_API_KEYシークレットGoogle PageSpeed Insights API key (adds Lighthouse scores to score_website)

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypilocal-leads-mcp0.1.1

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

local-leads-mcp

AI エージェントから、ウェブサイトを必要としている地元の事業者を見つけ、そのことを裏付けます。

OpenStreetMap を使って地元の事業者を見つけ、誤検出の寄せ集めではなく、実際に使えるリードリストを作るためのチェックで検証する、ひとつの MCP サーバーです。Claude、Cursor、または任意の MCP クライアントを使って見込み客を探すフリーランサーや代理店向けに作られています。

基本のワークフローに API キーは不要です。事業者の検索、ウェブサイトの検証、メールの到達可能性チェック、ウェブサイトの弱点評価はすべて、無料で利用できるオープンなインフラ(Overpass、Nominatim、DNS-over-HTTPS、通常の HTTP)で実行されます。

なぜ地図スクレイパーではないのですか?

地元で見込み客を探すときに難しいのは、事業者のリストを入手することではなく、恥ずかしい思いをしないことです。生の地図データから作られたリードリストには落とし穴がたくさんあります。このサーバーは、そうした落とし穴を明示的にチェックします。

  • 「ウェブサイトがない」は、そうとは限りません。 OSM データは古くなっている可能性があります。website タグがないからといって、何も証明されません。verify_website は apex と www の両方、およびリダイレクトをチェックします(apex ドメインは名前解決できなくても、www. では問題なくサイトが表示されるケースは、「ウェブサイトがない」と誤判定される典型例です)。さらに、confirm_no_website はウェブ検索を使って最終確認を行います。
  • Facebook ページはウェブサイトではありません。 SNS プロフィール、予約集約サイト(Fresha、TheFork、Treatwell など)、ディレクトリ掲載ページ、無料サブドメイン(*.wixsite.com、*.business.site など)は、「ウェブサイトあり」ではなく not_own_site に分類されます。
  • メールの不達を防ぎます。 check_mx は、見込み客に連絡する前にメールの到達可能性を予測します(MX がなければ確実にバウンスします。PEC 専用のドメインにはフラグが付けられます)。
  • 「サイトの出来が悪い」には根拠が必要です。 score_website は、印象ではなく、根拠を示せる問題点(HTTPS なし、モバイル用 viewport なし、title/meta/H1 の不足、サイトマップなしなど)を返します。オプションで PageSpeed API を使って Lighthouse スコアも取得できます。

各判定には、その判定につながった生のチェック結果が含まれるため、エージェントは判断の根拠を提示できます。

クイックスタート(60 秒)

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

これだけで完了です。認証情報は不要です。その後、エージェントに次のように依頼できます。

ウェブサイトがないトリノのレストランを 20 件見つけ、それぞれを検証して、電話番号付きで確認済みの事業者を CSV にしてください。

オプションの環境変数
変数有効になる機能
BRAVE_API_KEYBrave Search API を使った confirm_no_website
GOOGLE_CSE_API_KEY + GOOGLE_CSE_CXGoogle Programmable Search を使った confirm_no_website
PAGESPEED_API_KEYscore_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) — 名前付きの問題点と CMS/技術の検出(WordPress、Wix、Shopify など)を含む、0~100 のウェブサイト弱点スコア。
確認(検索用のキーが必要)
  • confirm_no_website(business_name, city) — 「本当にウェブサイトがないのか」を最終確認し、検索結果を自社サイト候補と掲載ページ/SNS に分類します。
エクスポート
  • 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 データ向けの同じコンセプトです。Google Search Console、GA4、Bing Webmaster、Microsoft Clarity を 1 つの MCP サーバーにまとめています。local-leads で見込み客を開拓し、seo-stack で構築したサイトをモニタリングしてください。

ライセンス

MIT。


Raffaele Nocera が制作 — 地域の事業者向けのウェブコンサルティングを提供しています。このツールがクライアント獲得に役立ったら、ぜひお知らせください。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。