AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
Use the Lovely Router data tool "Web 検索" (id `web-search`, Web) 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/web-search (public, no key needed). Price: $0.0009 / search.
- Run: POST https://lovelyrouter.com/v1/tools/web-search/run with a body like `{"input":{"query":"electric car prices site:reuters.com OR site:bloomberg.com after:2026","count":10},"max_results":1}`. 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 1 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 "web-search".
- 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>入力
querystring必須What to search for, 1–128 characters. Operators: site:example.com (several: site:a.com OR site:b.com), -site:example.com, "exact phrase", -word, -"exact phrase", lang:en (or lang:zh,en), after:2026-01-01, before:2026-06 (years or dates).
countintegerNumber of results, 1–50 (the price is per search, not per result).
need_contentbooleanAlso return each page's text (longer response). Usually the summary is enough.
questionstringOptional: the user's original question (≤ 128 characters), to rank results better.
試す
コードから呼び出す
実行・ポーリング・課金の仕組み →curl https://lovelyrouter.com/v1/tools/web-search/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{"input":{"query":"electric car prices site:reuters.com OR site:bloomberg.com after:2026","count":10},"max_results":1}'# MCP (agents): suggest_tools → get_tool → run_tool
run_tool({
"tool": "web-search",
"input": {"query":"electric car prices site:reuters.com OR site:bloomberg.com after:2026","count":10},
"max_results": 1
})料金の目安
| 実行数 | 原価 |
|---|---|
| 100 | $0.09 |
| 1,000 | $0.90 |
| 10,000 | $9.00 |
プリペイド、サブスクリプションなし。結果が要求より少なければ料金も下がります。 料金
用途
よくある質問
Web 検索 API の料金はいくらですか?
$0.0009 / search。1,000 回の実行で $0.90 です。サブスクリプションはなく、プリペイド残高から支払います。
これはWeb検索 APIですか?
はい。Web検索 API、AIエージェント 検索ツール、LLM Web検索をお探しなら、これです:Web を検索します。最大 50 件の結果に、タイトル、URL、日付、サイト、短い抜粋、モデル向けの長い要約(必要ならページ本文も)が付きます。演算子:site:、-site:、"完全一致"、-語、lang:、after:、before:。
1 回の実行で何が返りますか?
1 回の実行が 1 search として課金されます。返る量は入力で決まり、入力項目はこのページに記載しています。
AI エージェントはこのツールを使えますか?
はい。Claude Code・Cursor などの MCP クライアントを Lovely Router の MCP サーバーにつなぐと、エージェントが suggest_tools でこのツールを見つけ、run_tool と ID web-search で実行します。
実行が失敗するとどうなりますか?
失敗または停止した実行は、届いた結果の分だけを支払い、呼び出し料金はかかりません。実行開始時に最大費用を確保し、精算時に残りを解放します。