ユースケース

企業サイトのリストにメールアドレスと電話番号を追加する

企業サイトのリストから、ページ上で見つかったメールアドレス、電話番号、SNS リンクを JSON で取得し、見込み客リストを補完します。サイト単位で課金。

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで
Weblovelyjsonitems[0]"website": "https://example-plumb…"emails": "info@example-plumbing…"phones": "+1 555 0100""linkedin": "linkedin.com/company/…"pages": 5

ディレクトリや地図検索から集めた企業のリストがあっても、手元にあるのは各社の Web サイトだけ、ということはよくあります。連絡先はお問い合わせページ、フッター、会社概要ページのどこかにありますが、1 社ずつ開いて探すと数分かかります。Lovely Router がサイトをクロールして代わりに探します。Web サイトのリンクを送ると、サイト 1 件につき連絡先をまとめた 1 つの JSON オブジェクトが返り、プリペイド残高からサイトごとに課金されます。スクリプト、CRM のインポート処理、AI エージェントのどこからでも、1 つの API キーで呼び出せます。

AI エージェントに任せる

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

企業サイトのリストにメールアドレスと電話番号を追加する. 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 inputs (links, keywords or accounts) and how many results you need>
01

仕組み

010203
  1. Web サイトを集める

    アプローチしたい企業の Web サイトのリンクを集めます。ディレクトリのエクスポート、地図検索で得たリスト、自社の CRM などが元になります。

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

    入力を max_results と一緒に POST /v1/tools/website-contacts/run に送ります。リンクは startUrls に入れます。実行は最大費用を残高から仮押さえし、サイトごとに 1 つのオブジェクトを返します。

  3. リストに書き戻す

    各結果をウェブサイトで企業と照合し、メールアドレス、電話番号、SNS リンクを保存します。送信する前にメールアドレスを検証してください。

02

1 回のリクエストで Web サイトから連絡先を取得する

Web サイトからメールと連絡先を探すツールは、開始ページのリストを startUrls で受け取ります。1 つのサイトが 1 件の結果になり、最大 5 ページをクロールして連絡先をまとめます。maxDepth は開始ページから何リンク先まで進むかを、sameDomain はクロールを同じサイト内に留めるかを指定します。

curl https://lovelyrouter.com/v1/tools/website-contacts/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "startUrls": [
        {
          "url": "https://example.com"
        }
      ],
      "maxDepth": 1
    },
    "max_results": 1
  }'

1 回の実行で最大 50 サイトを読み取れます。max_results には送ったサイトの数を設定してください。60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。

03

各サイトに含まれる情報

フィールドのグループ取得できる内容
メールアドレスサイト上で見つかったメールアドレス
電話番号サイト上で見つかった電話番号
SNS プロフィール企業の SNS プロフィールへのリンク
統合クロールした最大 5 ページの連絡先を、サイトごとに 1 つの結果にまとめたもの

ツールが返すのは、サイトが公開している情報です。サイトにメールアドレスが載っていなければ、返せるものはありません。連絡先データは、連絡先の国のプライバシー規制や迷惑メール規制を含め、適法に利用する責任がご自身にあります。

04

レシピ

地図検索のリストを補完する。

Google マップのリードの実行結果からウェブサイトを取り出して startUrls に送り、同じ行にメールアドレスと電話番号を追加します。

適切な宛先を見つける。

最初の連絡には info@ のような代表アドレスを使い、個人宛てに書く前に担当者名入りのアドレスを探します。

SNS リンクを集める。

SNS プロフィールのリンクから企業がどこで活動しているかを調べ、連絡チャネルを選びます。

アプローチ前にリストを整える。

メールアドレスを email-verify にかけ、バウンスするものを除外します。

リンクまとめページを確認する。

linktr.ee のページを開始 URL として渡すと、プロフィール上のすべてのリンクから連絡先を読み取ります。

普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「companies.csv にある 30 の Web サイトを読み取り、それぞれのメールアドレスと電話番号を見つけて列として追加してください。max_results は 30 に設定してください。」

06

料金

料金はサイト単位です。実行を開始すると最大費用(呼び出し料金 + サイト単価 × max_results)が仮押さえされ、実際に返った分で精算されて、仮押さえの残りは残高に戻ります。失敗またはタイムアウトした実行は返したサイトの分だけを支払い、開始時に拒否された実行は無料です。

200 サイトを補完すると、1 サイトあたり何ページをクロールしたかに関係なく、200 サイト分として課金されます。サブスクリプションや月額の最低利用料はなく、$5 からチャージでき、1 つの残高でツールとモデルの両方を支払えます。現在の価格は上のカードに表示されており、料金ではすべてのツールを一覧できます。

07

よくある質問

?
1 つのサイトで何ページ読み取りますか?+

最大 5 ページです。すべてのページの連絡先が 1 つの結果にまとめられます。

リンクをたどる範囲を制限できますか?+

はい。maxDepth で開始 URL から何リンク先まで進むかを、sameDomain で同じドメイン内にクロールを留めるかを指定します。

1 回の実行で何サイト処理できますか?+

最大 50 サイトです。

すべての企業のメールアドレスが見つかりますか?+

いいえ。クロールしたページにサイトが公開している情報だけを返します。メールアドレスをまったく載せていないサイトもあります。

見つけたアドレスにメールを送るのは合法ですか?+

送り手と受け手のいる国によって異なります。プライバシー規制と迷惑メール規制を守る責任はご自身にあります。

サブスクリプションは必要ですか?+

いいえ。プリペイド残高にクレジットを追加し、実行ごとに残高から差し引かれます。失敗した実行は返した結果の分だけを支払い、自動で更新されるものは何もありません。

営業開拓の流れ全体を設計するならリード獲得を、そのほかのツールについてはツールカタログをご覧ください。

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

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