ユースケース

B2B リード獲得 API:
Google Maps と LinkedIn から営業リストを作成

Google Maps で地域の事業者を、LinkedIn で意思決定者を探し、メールアドレスを追加して検証。MCP 経由のエージェントからも、API 1 回でも使えます。

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで
Google MapsLinkedInWebEmaillovelyjsonitems[0]"name": "Austin Smile Dental""phone": "+1 512 555 0142""website": "austinsmile.com""email": "hello@austinsmile.com""verified": true"rating": 4.8"reviews": 312

自分のコードからでも AI エージェントからでも、リードリストを作成できます。Google Mapsで地域の事業者を検索し、LinkedIn で企業や人物を探し、Web サイトからメールアドレスと電話番号を取得して、送信前にすべてのアドレスを確認します。各ステップはデータツールで、JSON を送ると JSON が返り、料金は結果 1 件ごとに決まっています。支払いはモデルと同じプリペイドのキーから行われます。地域の事業者に売り込むなら Google Mapsのリードスクレイパーから、企業に売り込むなら LinkedIn から始めましょう。

AI エージェントに任せる

このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。

Build a B2B lead list for me: find businesses on Google Maps and decision makers on LinkedIn, add their emails and verify them. Use the Lovely Router data tools: each returns JSON and is billed per result.

- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the industry, the location, the roles you want and the columns of the CSV>
01

仕組み

010203
  1. ソースを選ぶ

    地域の事業者を探すなら、Google Mapsのリードが、場所の情報とその Web サイトで見つかったメールアドレス、電話番号、SNS リンクを 1 回の実行でまとめて返します。企業や人物を探すなら、LinkedIn 企業検索、LinkedIn 人物検索、LinkedIn 企業の従業員を使います。

  2. 上限を付けて実行する

    ツールの input と上限 max_results を POST /v1/tools/{id}/run に送ります。この上限によって、実行が始まる前に、その実行でかかりうる最大費用が決まります。

  3. エンリッチして検証する

    Web サイトは Web サイトの連絡先に、LinkedIn のプロフィール URL はメールファインダーに、そしてすべてのアドレスをメール検証に送ります。

02

1 回のリクエストで Google Mapsのリードを取得する

次の実行は、Web サイトを持つマイアミの歯科医院を探し、各サイトから連絡先を読み取ります。

curl https://lovelyrouter.com/v1/tools/google-maps-leads/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "searchTerms": ["dentist", "dental clinic"],
      "location": "Miami, FL, USA",
      "maxResults": 100,
      "websiteFilter": "withWebsite"
    },
    "max_results": 100
  }'

レスポンスには、実行の status、charge_usd に入った費用、items に入った事業者が含まれます。各事業者は Google Mapsの場所で、その Web サイトで見つかったメールアドレス、電話番号、SNS リンクが付いています。websiteFilter を withWebsite にすると Web サイトのある場所だけが残り、Web サイト制作を売り込むなら withoutWebsite にしてサイトのない場所だけを残せます。60 秒を過ぎても実行中の場合は、202 と poll パスが返ります。ポーリングのループはツールを実行するで紹介しています。

Tip

近隣検索で見つかる場所は、検索語 1 つあたり約 60 件です。幅広いカテゴリを網羅するには、searchTerms に関連する語を複数指定してください。結果はマージされて重複が除かれ、max_results はそのすべてに適用されます。

03

エージェントにリストを作らせる

search_toolsrun_toolget_run

MCP サーバーを Claude Code に接続します。

Shell
claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELY_API_KEY"

あとは次のように頼むだけです。「Web サイトのあるマイアミの歯科医院を探してください。メールアドレスを取得し、すべてのアドレスを検証して、名前、Web サイト、メールアドレス、検証結果をまとめた CSV をください。まず suggest_tools でプランを立て、すべての実行に max_results を設定し、始める前に見積もり費用を見せてください。」

04

ツール

Google Maps
Google マップのリード(メール付き)

Google マップの店舗・事業者と、その Web サイトから取得したメール・電話・SNS リンク。地域のリードリスト作成向け。

$0.00075 / place詳細 →
Google Maps
Google マップの場所を検索

キーワードと地域で Google マップ上の店舗・事業者を検索:名前、住所、電話番号、Web サイト、評価、レビュー数、営業時間、座標。

$0.000238 / place + $0.00075 / call詳細 →
Web
Web サイトのメール・連絡先を取得

Web サイトをクロールし、メールアドレス、電話番号、SNS プロフィールのリンクを抽出します。

$0.015 / website + $0.0015 / call詳細 →
LinkedIn
LinkedIn の企業を検索

キーワード・地域・規模で LinkedIn の企業を検索:名称、業界、規模、URL。

$0.003 / company + $0.0015 / call詳細 →
LinkedIn
LinkedIn の企業情報を取得

LinkedIn の企業ページ:概要、業界、規模、本社、Web サイト、フォロワー。

$0.008 / company詳細 →
LinkedIn
LinkedIn 企業の従業員一覧

LinkedIn 企業の従業員(役職・地域・キーワードで絞り込み可):氏名、見出し、役職、プロフィール URL。

$0.0045 / profile + $0.03 / call詳細 →
LinkedIn
LinkedIn の人物を検索

キーワード・地域・会社・役職で LinkedIn の人物を検索。1 回の呼び出しで最大 25 件の簡易プロフィール。

$0.15 / call詳細 →
LinkedIn
LinkedIn プロフィールからメールを検索

LinkedIn プロフィール URL から勤務先メールアドレスを取得。

$0.005 / email詳細 →
Email
メールアドレスを検証

メールアドレスが届くか確認:形式、ドメイン、MX レコード、メールボックスの状態。

$0.0015 / email詳細 →
ツール主な入力返ってくる内容
google-maps-leadssearchTerms、location、radius、websiteFilter事業者と、その Web サイトに載っているメールアドレス、電話番号、SNS リンク
google-maps-placessearchTerms、location、minRating、openNow名前、住所、電話番号、Web サイト、評価、レビュー数、営業時間、座標
website-contactsstartUrls、maxDepth、sameDomainメールアドレス、電話番号、SNS プロフィールのリンク(Web サイトごとに統合、各サイト最大 5 ページ)
linkedin-company-searchsearchQuery、locations、companySize企業名、業種、規模、LinkedIn URL
linkedin-companycompanies(URL)または searches(企業名)概要、業種、規模、本社所在地、Web サイト、フォロワー数
linkedin-company-employeescompanies、jobTitles、locations名前、ヘッドライン、役職、プロフィール URL
linkedin-people-searchsearchQuery、locations、currentCompanies、currentJobTitles1 回の呼び出しで最大 25 件の簡易プロフィール
linkedin-email-finderlinkedinUrls各プロフィールの勤務先メールアドレス
email-verifyemails構文、ドメイン、MX レコード、メールボックスの状態
05

レシピ

評価の高いレストランとその連絡先。

google-maps-places を "minRating": 4.5 で実行し、各場所の website を startUrls として "maxDepth": 1 を指定した website-contacts に渡します。

英国の小規模フィンテック企業のグロース担当者。

linkedin-company-search を "searchQuery": "fintech"、"locations": ["United Kingdom"]、"companySize": ["11-50"] で実行します。得られた企業 URL を "jobTitles": ["Head of Growth"] を指定した linkedin-company-employees に渡し、さらにプロフィール URL を linkedin-email-finder に渡します。「UK」ではなく「United Kingdom」と書いてください。LinkedIn は「UK」をウクライナと解釈することがあります。

特定の都市の創業者。

"searchQuery": "founder" と "locations": ["San Francisco"] を指定して linkedin-people-search を 1 回呼び出すと、最大 25 件のプロフィールが返り、課金は呼び出し単位で 1 回分です。

アカウント名のリストをエンリッチする。

企業名を searches として linkedin-company に送ると、各企業の業種、規模、本社所在地、Web サイトが得られます。

06

データを責任をもって使う

リード系ツールが返すのは公開されているビジネス情報ですが、その一部は氏名、役職、勤務先メールアドレスといった個人データです。GDPR や CCPA などのプライバシー法に基づく適法な根拠を持つこと、本人からの請求に応じること、未承諾の一斉送信を行わないことを含め、データを適法に使う責任は利用者にあります。営業リストを作る前に利用規定をお読みください。

07

料金

各ツールには結果単価、呼び出し料金、またはその両方が設定されています。現在の価格は上のカードに表示されています。ほとんどのリード系ツールは、場所、企業、プロフィール、Web サイト、メールアドレスの件数で課金されます。人物検索は呼び出し単位の課金で、1 回の呼び出しで最大 25 件のプロフィールが返ります。実行を開始すると、最大費用(呼び出し料金 + 結果単価 × max_results)が仮押さえされ、実際に返った分で精算されます。失敗した実行は、終了までに返した結果の分だけを支払うため、結果が 0 件のまま失敗した実行は無料です。サブスクリプションはありません。モデルの支払いにも使う 1 つのプリペイド残高にチャージするだけです。詳しくは料金をご覧ください。

08

よくある質問

?
Google Mapsの掲載情報からメールアドレスを取得できますか?+

はい。google-maps-leads ツールは Google Mapsで事業者を見つけ、同じ実行の中でその Web サイトからメールアドレス、電話番号、SNS リンクを読み取ります。すでに手元にある場所の情報をエンリッチしたい場合は、その Web サイトを website-contacts ツールに送ってください。

Google Mapsの 1 回の実行で何件のリードが返りますか?+

設定した max_results の上限までで、1 回の実行につき最大 200 件の場所です。近隣検索で見つかる場所は検索語 1 つあたり約 60 件なので、幅広いカテゴリを網羅するには関連する語を複数指定してください。

メールアドレスが実在するかどうかを確認するには?+

メール検証 API として使える email-verify ツールを、リストに対して実行します。各アドレスの構文、ドメイン、MX レコード、メールボックスの状態を確認し、メールアドレス 1 件ごとに課金されます。

AI エージェントだけでリードリストを作れますか?+

はい。MCP サーバーを Claude Code、Cursor などの MCP クライアントに接続すると、エージェントは suggest_tools でプランを立て、get_tool で入力スキーマを読み、run_tool でツールを実行します。エージェントには利用上限付きの API キーを渡してください。上限を超える実行は、課金が発生する前に拒否されます。

この方法でリードを集めるのは合法ですか?+

あなたやリストに載っている人がどこにいるか、データをどのように使うかによって異なります。結果を適法に使う責任は利用者にあり、ツールを使ってはならない用途は利用規定に定められています。

次は、見込み客が何を話題にしているかを把握するソーシャルリスニング、採用のシグナルを得る採用データ、または複数ステップの作業を費用付きで計画できる最適なツールを見つけるをご覧ください。

モデル・データ・エージェントを 1 つのプリペイドキーで

サブスクリプションなし。チャージして必要な分だけ使い、すべての請求をログで確認できます。