AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
Use the Lovely Router data tool "Google マップのレビュー" (id `google-maps-reviews`, Google Maps) to get data for me. It returns JSON.
- Docs (read first): https://lovelyrouter.com/docs/tools/run.md and https://lovelyrouter.com/docs/api/tools.md
- Input fields and price: GET https://lovelyrouter.com/v1/tools/google-maps-reviews (public, no key needed). Price: $0.000675 / review.
- Run: POST https://lovelyrouter.com/v1/tools/google-maps-reviews/run with a body like `{"input":{"placeIds":["ChIJN1t_tDeuEmsRUsoyG83frY4"],"maxReviews":3,"reviewsSort":"newest"},"max_results":10}`. 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 (up to 500 per run).
- If you support MCP, you can instead connect the server https://lovelyrouter.com/mcp (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool with tool "google-maps-reviews".
- 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: <describe the data you need, e.g. which places, profiles, keywords or URLs, and the output format>入力
placeIdsstring[]List of place IDs. Add them one by one or upload a list using the Bulk edit option. A place ID has the format ChIJreV9aqYWdkgROM_boL6YbwA - only 27-character IDs starting with ChIJ or GhIJ are supported.
startUrlsobject[]List of URLs to be crawled. They can be search URLs, place URLs or review detail URLs. Valid Google Maps place URLs must contain one of the following subpaths: /maps/search, /maps/place or /maps/reviews. This feature also supports uncommon URL formats such as: https://google.com/maps?cid=***.
maxReviewsintegerMax number of reviews per place to scrape. If you want to scrape all reviews, remove the prefilled value.
reviewsSortstringDefine how reviews are sorted.
newest · mostRelevant · highestRanking · lowestRanking
languagestringResults will be scraped in this language.
en · af · az · id · ms · bs · ca · cs · da · de · et · es
試す
コードから呼び出す
実行・ポーリング・課金の仕組み →curl https://lovelyrouter.com/v1/tools/google-maps-reviews/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{"input":{"placeIds":["ChIJN1t_tDeuEmsRUsoyG83frY4"],"maxReviews":3,"reviewsSort":"newest"},"max_results":20}'# MCP (agents): suggest_tools → get_tool → run_tool
run_tool({
"tool": "google-maps-reviews",
"input": {"placeIds":["ChIJN1t_tDeuEmsRUsoyG83frY4"],"maxReviews":3,"reviewsSort":"newest"},
"max_results": 20
})料金の目安
| 結果 | 実行回数(1 回あたり最大 500 件) | 原価 |
|---|---|---|
| 100 | 1 | $0.068 |
| 1,000 | 2 | $0.675 |
| 10,000 | 20 | $6.75 |
プリペイド、サブスクリプションなし。結果が要求より少なければ料金も下がります。 料金
用途
よくある質問
Google マップのレビュー API の料金はいくらですか?
$0.000675 / review。1 回最大 500 件で 1,000 件取得すると $0.675 です。サブスクリプションはなく、プリペイド残高から支払います。
これは店舗 クチコミ APIですか?
はい。店舗 クチコミ API、Google マップ クチコミ 取得、Google マップ レビュー スクレイピングをお探しなら、これです:Google マップの場所(プレイス ID または URL)のレビュー:本文、星評価、日付、オーナーの返信。
1 回の実行で何件の結果が返りますか?
既定は 20 件、1 回あたり最大 500 件。max_results で上限を設定でき、届いた結果の分だけ課金されます。
Google Maps のアカウントや API キーは必要ですか?
不要です。Lovely Router の API キーでツールを呼び出すと JSON が返ります。Google Maps 側の設定は何もいりません。
AI エージェントはこのツールを使えますか?
はい。Claude Code・Cursor などの MCP クライアントを Lovely Router の MCP サーバーにつなぐと、エージェントが suggest_tools でこのツールを見つけ、run_tool と ID google-maps-reviews で実行します。
実行が失敗するとどうなりますか?
失敗または停止した実行は、届いた結果の分だけを支払い、呼び出し料金はかかりません。実行開始時に最大費用を確保し、精算時に残りを解放します。