2 店舗目を出す前、フランチャイズの商圏を選ぶ前、広告を出す場所を決める前には、すでに誰がそこにいるのかを知る必要があります。競合が何軒あるか、評価はどれくらいか、互いにどれだけ離れているか。Google マップを手でクリックして見られるのは十数件で、市場全体ではありません。Lovely Router は全体像を返します。業種と場所を送ると店舗ごとに 1 つの JSON オブジェクトが返り、料金はプリペイド残高から店舗 1 件ごとに差し引かれます。ノートブックでも出店候補地のモデルでも 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>仕組み
市場を定義する
業種を
searchTermsに、エリアをlocationに指定します。デフォルトの範囲が合わない場合は、キロメートル単位でradiusも指定します。上限を付けてツールを実行する
検索を
maxResultsとmax_resultsと一緒にPOST /v1/tools/google-maps-places/runに送ります。実行は最大費用を残高から仮押さえし、店舗を JSON で返します。地図を分析する
座標をプロットし、評価とレビュー数で順位を付け、エリア同士を比べます。店が密集していて評価が低いエリアと、店が少ないエリアとでは、チャンスの種類が違います。
1 回のリクエストで店舗を取得する
Google マップの店舗を検索するツールは、searchTerms と location を受け取ります。店舗 1 件が 1 件の結果で、1 回の実行で最大 200 件を返します。
curl https://lovelyrouter.com/v1/tools/google-maps-places/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"searchTerms": ["coffee shop"],
"location": "Austin, Texas, USA",
"maxResults": 10,
"language": "en"
},
"max_results": 10
}'60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。minRating（2.0 から 4.5 まで 0.5 刻み）を追加すると評価の高い店舗だけに絞れ、openNow を追加すると現在営業中の店舗だけに絞れます。
各店舗に含まれる情報
| フィールド群 | 取得できるもの |
|---|---|
| Identity | 店名と住所 |
| Contact | 電話とウェブサイト |
| Reputation | 平均評価とレビュー数 |
| Hours | 営業時間 |
| Location | 座標 |
レシピ
住所の周辺で自分のカテゴリを検索し、店舗数を数えて平均評価を見ます。4.5 を超える店舗が多ければ、顧客にはすでに良い選択肢があるということです。
minRating を付けずに実行し、レビュー数が十分ある店舗を評価の低い順に並べて、サービスの空白がありそうな場所を書き留めます。
同じ検索を両方の都市で実行し、店舗数と評価の中央値を比べて、どちらに拡大するかを決めます。
restaurants、cafe、fast food のように複数の searchTerms を渡します。結果は重複を除いた 1 つの集合にまとまります。1 つの語では市場の一部しか見えません。
店名、住所、座標をエクスポートし、座標から訪問ルートを計画します。
普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「オースティンのコーヒーショップを探してレビュー数で順位を付け、評価が最も高くレビュー数が最も少ない 5 店舗を教えてください。max_results は 100 に設定してください。」
他の地域ソースと組み合わせる
店舗の一覧は出発点です。レビュー、他のディレクトリ、連絡先の情報で完成します。
キーワードと地域で Google マップ上の店舗・事業者を検索：名前、住所、電話番号、Web サイト、評価、レビュー数、営業時間、座標。
Google マップの場所（プレイス ID または URL）のレビュー：本文、星評価、日付、オーナーの返信。
Google マップの店舗・事業者と、その Web サイトから取得したメール・電話・SNS リンク。地域のリードリスト作成向け。
指定した地域の Tripadvisor のホテル・レストラン・観光スポット。
google-maps-reviewsは、特定の店舗について顧客が書いた内容を、星の数、日付、オーナーの返信とともに読み取ります。google-maps-leadsは、各事業者の公式サイトからメールと SNS のリンクを加え、アウトリーチに使えるようにします。tripadvisor-placesは、旅行者向けの市場のホテル、レストラン、観光スポットをカバーします。
地域と旅行のデータについては、旅行・不動産データもご覧ください。
料金
料金は店舗 1 件ごとにかかります。実行を開始すると最大費用（呼び出し料金 + 店舗 1 件あたりの単価 × max_results）が仮押さえされ、実際に返った分で精算されて、仮押さえの残りは残高に戻ります。失敗またはタイムアウトした実行は返した店舗の分だけを支払い、開始時に拒否された実行は無料です。
150 件の店舗をマッピングすると、店舗 150 件分として課金されます。サブスクリプションや月額の最低利用料はなく、$5 からチャージでき、1 つの残高でツールとモデルの両方を支払えます。現在の価格は上のカードに表示されており、料金ではすべてのツールを一覧できます。
よくある質問
1 回の検索で何件の店舗を取得できますか？+
周辺検索で返るのは、検索語 1 つにつき最大でおよそ 60 件です。1 回の実行では最大 200 件を返せるため、広いエリアをカバーするには複数の検索語や場所を使ってください。
検索範囲はどれくらいですか？+
検索は location の周囲の約 radius キロメートルの範囲が対象です。radius を設定して広げたり狭めたりできます。
評価で絞り込めますか？+
はい。minRating は 2.0、2.5、3.0、3.5、4.0、4.5 を受け付け、平均評価がその値以上の店舗だけを残します。
メールは返りますか？+
いいえ。このツールが返すのは掲載情報で、店名、住所、電話、ウェブサイト、評価、レビュー数、営業時間、座標です。事業者の公式サイトにあるメールが必要な場合は、google-maps-leads を使ってください。
サブスクリプションは必要ですか？+
いいえ。プリペイド残高にクレジットを追加し、実行ごとに残高から差し引かれます。失敗した実行は返した結果の分だけを支払い、自動で更新されるものは何もありません。