b2bleads-mcp

B2BLeads MCP サーバー

AI エージェント（Claude、Cursor、その他のMCP対応クライアント）に、リアルタイムでB2B企業を検索・情報拡充するためのsearch_leadsツールを提供するMCP（Model Context Protocol）サーバーです。

エージェントに、たとえば次のように依頼できます。

「ミュンヘンにある、ウェブサイトと電話番号のある建設会社を探してください。」

「ベルリンにある、評価が4.0を超えるIT企業を50社集めてください。」

「可能であれば、この見込み客リストにメール連絡先を追加してください。」

……すると、このツールが企業名、住所、電話番号、ウェブサイト、入手可能な場合はメールアドレスを含む、すぐに使える企業リストを返します。

このサーバーは、B2BLeads REST APIを利用するシンプルなMCPラッパーです。B2BLeadsのアカウントとAPIキーが必要です。詳しくは、下記のAPIキーの取得をご覧ください。

必要条件

• Node.js 18以降
• B2BLeads APIキー（登録）

インストール

インストールは不要です。npxで直接実行できます。MCPクライアントの設定に追加してください。

Claude Desktop / Claude Code

claude_desktop_config.jsonを編集するか、claude mcp addを実行します。

{
  "mcpServers": {
    "b2bleads": {
      "command": "npx",
      "args": ["-y", "b2bleads-mcp"],
      "env": {
        "B2BLEADS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

同じブロックを、プロジェクト内の.cursor/mcp.jsonまたはCursorのグローバルMCP設定に追加してください。

その他のMCPクライアント

B2BLEADS_API_KEY環境変数を設定し、コマンドnpx -y b2bleads-mcpを指定してください。

APIキーの取得

1. b2bleadsapi.comでアカウントを作成します。
2. Billingでプランを選択します。
3. ダッシュボードのAPI Keysからキーを生成します。
4. 上記のMCPクライアント設定で、B2BLEADS_API_KEYとして設定します。

ツール

search_leads

企業やビジネス上の連絡先をリアルタイムで検索します。

パラメーター	型	説明
q	string	自由形式の検索クエリ。例："construction companies in Munich"。
industry	string	list_industriesにあるカテゴリのいずれか。
city	string	検索対象の都市または地域。
radius_km	number	検索範囲（キロメートル）。
min_rating	number	最低評価（0～5）。
has_website	boolean	ウェブサイトがある事業者のみ。
verified_only	boolean	掲載情報が確認済みの事業者のみ。
open_now	boolean	現在営業中の事業者のみ。
price_level	string	budget | moderate | expensive | luxury
rank_by	string	relevance | distance
limit	integer	1回の呼び出しあたりの最大結果数（1～20）。
lang	string	結果の言語を示すBCP-47タグ（例：en、pt-BR）。
page_token	string	前回の呼び出しで取得したページネーショントークン。
save_to_list	boolean	結果をB2BLeadsの保存済みリストにも保存します。
list_id	string	追記先となる既存の保存済みリストID。
list_name	string	検索または作成した保存済みリストに追記するための名前。

q、industry、cityのいずれか1つ以上が必要です。

search_leads_advanced

⚠️ コストが高くなります。search_leads の呼び出し1回分の9倍のクォータを消費します。 特定の都市で search_leads が返した結果より多くの結果が必要な場合、または都市を網羅的に調べる必要がある場合にのみ使用してください。デフォルトや最初の試行としては使用しないでください。サーバー側で都市を3x3のグリッドに分割してサブ検索を行い、通常の約20～60件という上限を超えて、1回の呼び出しで最大約180件の重複を除いた事業者を返します。ページネーションには対応していません。

パラメーター	型	説明
q	string	自由形式の検索クエリです。例："construction companies"。industry が指定されている場合は省略できます。
industry	string	list_industries のカテゴリのいずれかです。
city	string	必須です。 検索する都市または地域です。検索フレーズ全体ではなく、都市名のみを指定してください（例："Lyon"）。そうしないと、誤った場所がジオコーディングされる可能性があります。
min_rating	number	最低評価（0～5）です。
has_website	boolean	ウェブサイトを持つ事業者のみを対象にします。
verified_only	boolean	認証済みのリスティングがある事業者のみを対象にします。
open_now	boolean	現在営業中の事業者のみを対象にします。
price_level	string	budget | moderate | expensive | luxury
lang	string	結果の言語です。BCP-47タグで指定します（例：en、pt-BR）。

list_industries

search_leads の industry フィルターで使用できる、事前定義された業種カテゴリを一覧表示します。引数は不要です。

list_saved_lists

保存済みのリードリストをすべて一覧表示します。各リストのID、名前、リード数を返します。リード自体は返しません。読み取り専用です。リスト内のすべてのリードを取得するには、get_saved_list を使用してください。

get_saved_list

IDを指定して、保存済みリードリスト1件を取得します。保存済みのリードがすべて含まれます。読み取り専用です。

パラメーター	型	説明
list_id	string	保存済みリストのIDです。list_saved_lists、または search_leads の save_to_list の応答から取得できます。必須です。

find_email

1つの事業者のウェブサイトから、可能な範囲で連絡先メールアドレスを検索します（ホームページと一般的な問い合わせページを確認します）。search_leads を再実行するのではなく、特定のウェブサイト1つを調べる場合に使用してください。有料プラン（Starter以上）が必要です。見つからない場合、メールアドレスが null で返されることがあります。

パラメーター	型	説明
website	string	検索する事業者のウェブサイトURLです。例：https://example.com。必須です。

account_get_usage

現在の請求期間に、月間検索クォータのうちどれだけ使用済みで、どれだけ残っているかを取得します。読み取り専用です。引数は不要です。

account_get_usage_limit

アカウントの月間検索クォータの合計と、現在の請求期間が更新される日時を取得します。読み取り専用です。引数は不要です。

list_saved_searches

保存済みの検索アラート（定期的に自動実行され、結果をリストに保存する検索）を一覧表示します。読み取り専用です。引数は不要です。

get_search_history

最近の検索履歴を最大200件まで取得します（クエリテキスト、結果数、日付）。読み取り専用です。引数は不要です。

設定

環境変数	必須	説明
B2BLEADS_API_KEY	はい	B2BLeads API キーです。
B2BLEADS_API_URL	いいえ	API のベース URL を上書きします。デフォルトは https://api.b2bleadsapi.com です。

料金とレート制限

検索を実行するたびに、B2BLeads プランのクォータを消費します。料金をご確認ください。レート制限やクォータに関するエラーは API から返され、ツールエラーとしてエージェントに通知されます。

リンク

• B2BLeads のウェブサイト
• REST API ドキュメント
• このパッケージの統合ページ — 通常の Node.js MCP クライアントに固有のセットアップ手順
• Claude Desktop / Claude Code の統合ページ
• 利用規約
• プライバシーポリシー

ライセンス

MIT