AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
Use the Lovely Router data tool "Tripadvisor を検索" (id `tripadvisor-places`, Tripadvisor) 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/tripadvisor-places (public, no key needed). Price: $0.00435 / place.
- Run: POST https://lovelyrouter.com/v1/tools/tripadvisor-places/run with a body like `{"input":{"query":"Chicago","maxItemsPerQuery":5,"includeHotels":true},"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 100 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 "tripadvisor-places".
- 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>入力
querystringYou can enter a location name or a keyword here. If you search for a location, the scraper will take the first 'Location' type result and scrape hotels, restaurants, and attractions for that location. If you search for a keyword, the scraper will only scrape places directly listed on the search results page (it won't crawl destinations listed among those results).
startUrlsarrayURLs to start with instead of a location name. You can use URLs with search query included (containing 'Search?q='), tourism URLs or URLs pointing to a concrete hotel, restaurant, or attraction (containing 'Hotel_Review', 'Restaurant_Review', or 'Attraction_Review'). URLs of **public** trips are supported as well. The tool can also handle category URLs for all 3 kinds of places, including…
maxItemsPerQueryintegerLimit the number of places to be scraped per search query/start URL. If you want to set a limit across all search queries use 'Options' -> 'Maximum charged results'. Set this field to a value larger than `3000` to activate the *'deeper city search'*.
includeHotelsbooleanIf checked, the results will include hotels for a given location.
includeRestaurantsbooleanIf checked, the results will include restaurants for a given location.
試す
コードから呼び出す
実行・ポーリング・課金の仕組み →curl https://lovelyrouter.com/v1/tools/tripadvisor-places/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{"input":{"query":"Chicago","maxItemsPerQuery":5,"includeHotels":true},"max_results":10}'# MCP (agents): suggest_tools → get_tool → run_tool
run_tool({
"tool": "tripadvisor-places",
"input": {"query":"Chicago","maxItemsPerQuery":5,"includeHotels":true},
"max_results": 10
})料金の目安
| 結果 | 実行回数（1 回あたり最大 100 件） | 原価 |
|---|---|---|
| 100 | 1 | $0.435 |
| 1,000 | 10 | $4.35 |
| 10,000 | 100 | $43.50 |
プリペイド、サブスクリプションなし。結果が要求より少なければ料金も下がります。 料金
用途
よくある質問
Tripadvisor を検索 API の料金はいくらですか？
$0.00435 / place。1 回最大 100 件で 1,000 件取得すると $4.35 です。サブスクリプションはなく、プリペイド残高から支払います。
これはTripadvisor APIですか？
はい。Tripadvisor API、Tripadvisor スクレイピング、トリップアドバイザー データ 取得をお探しなら、これです：指定した地域の Tripadvisor のホテル・レストラン・観光スポット。
1 回の実行で何件の結果が返りますか？
既定は 10 件、1 回あたり最大 100 件。max_results で上限を設定でき、届いた結果の分だけ課金されます。
Tripadvisor のアカウントや API キーは必要ですか？
不要です。Lovely Router の API キーでツールを呼び出すと JSON が返ります。Tripadvisor 側の設定は何もいりません。
AI エージェントはこのツールを使えますか？
はい。Claude Code・Cursor などの MCP クライアントを Lovely Router の MCP サーバーにつなぐと、エージェントが suggest_tools でこのツールを見つけ、run_tool と ID tripadvisor-places で実行します。
実行が失敗するとどうなりますか？
失敗または停止した実行は、届いた結果の分だけを支払い、呼び出し料金はかかりません。実行開始時に最大費用を確保し、精算時に残りを解放します。