AI エージェント向けの Web 検索 API

1. キーを取得する

   サインアップして $5 からチャージし、API キーでキーを作成します。ツールカタログ自体は公開されているため、キーがなくてもスキーマと料金を確認できます。

2. Web を検索する

   input にクエリと、必要に応じて count（結果は 1〜50 件）を指定して送ります。料金は検索 1 回ごとなので、count を変えても変わりません。

   cURLPythonNode.js

   Shell

   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
     }'

3. 読む価値のあるページを読む

   web-fetch に URL を 1 つ渡すと、メニューや広告を除いたページのタイトルと本文が Markdown で返されます。

   cURL

   curl https://lovelyrouter.com/v1/tools/web-fetch/run \
     -H "Authorization: Bearer $LOVELY_API_KEY" \
     -H "content-type: application/json" \
     -d '{"input": {"url": "https://en.wikipedia.org/wiki/Web_search_engine"}, "max_results": 1}'

各リクエストは、既定で最大 60 秒間、実行の完了を待ちます（wait は最大 300 まで指定可能）。完了した実行は、charge_usd と items 内の結果とともに 200 で返されます。それより長くかかる実行は 202 と、ポーリング先のパスを返します。どちらのケースもツールを実行するで説明しています。

web-search は、query（1〜128 文字）内の次の演算子を解釈します。

google-news は "exact phrase"、OR、-word、site:、intitle: に対応しています。google-search は、Google に入力するのと同じように演算子を受け付けます。

MCP サーバーを接続すると、エージェントはデータツールのカタログのほかのツールと並んで、web_search と web_fetch をツールとして使えるようになります。サーバーはエージェントに対し、調べたり読んだりする必要があるものにはこの 2 つを使い、クリックして操作する必要があるページにはブラウザエージェントを使うよう指示します。結果は短く番号付きで返されます。web_fetch は長いページを約 12,000 文字ずつに分けて返し、続きを読むのは無料です。

claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELY_API_KEY"

あとは Claude Code に、たとえば次のように頼みます。「全固体電池に関する今週の発表をニュースサイトから検索し、最も関連性の高い記事を 3 本読んで、何が変わったのかをリンク付きでまとめて」 Cursor、Claude Desktop などのクライアントの設定方法は MCP サーバーにあります。

web-search は検索 1 回ごとに $0.0009 で課金され、結果が 1 件でも 50 件でも同じです。結果がない検索は無料です。web-fetch はページ 1 つごとに同じ料金で課金され、読み取れなかったページは無料です。Google 検索は検索結果ページごと、Google ニュースは記事ごと、Google トレンドは呼び出しごとに課金されます。現在の料金は上のカードに表示されています。

どの実行も、開始時に最大費用をプリペイド残高から確保し、返した結果に応じて精算します。そのため、実行前にかかりうる最大額が分かります。失敗した実行は、届いた結果の分だけ支払います。サブスクリプションはありません。すべてのツールとモデルの料金は料金を参照してください。