コーディングエージェントはスクレイパーを書けても、LinkedIn のプロフィールを読んだり、Google Maps のレビューを取得したり、登録フォームをクリックして進めたりすることは自力ではできません。https://lovelyrouter.com/mcp という URL 1 つを API キーとともに追加すれば、Claude Code、Cursor、Codex、Claude Desktop などの MCP クライアントで、Web 検索、クリーンなページ読み取り、データツールのカタログ全体、ブラウザエージェントが使えるようになります。モデル API と同じキーとプリペイド残高を使い、検索ごと、結果ごと、ブラウザのステップごとに支払います。
AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
Connect yourself to the Lovely Router MCP server so you can search the web, read pages, run pay-per-result data tools and drive a browser agent. - Docs (read first): https://lovelyrouter.com/docs/tools/mcp.md - Server: https://lovelyrouter.com/mcp over Streamable HTTP, header `Authorization: Bearer $LOVELY_API_KEY`. In Claude Code: `claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp --header "Authorization: Bearer $LOVELY_API_KEY"`; the docs have the setup for Codex, Gemini CLI, Cursor and Claude Desktop. Use the setup for the client you are running in. - Then plan with suggest_tools, read the input schema with get_tool and run with 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: <describe what you want to build or get>
仕組み
エージェント用のキーを作成する
API キーでキーを作成し、利用上限を設定します。キーの上限を超えるおそれのある実行は、課金が発生する前に
402で拒否されるため、ループに陥ったエージェントが残高を使い果たすことはありません。クライアントにサーバーを追加する
Claude Code ならコマンド 1 つです。すべてのプロジェクトで使うには
--scope userを付けます。claude mcp listを実行すると、接続できているか確認できます。Shellclaude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \ --header "Authorization: Bearer $LOVELY_API_KEY"やりたいことを頼む
タスクを普段の言葉で説明します。エージェントは
suggest_toolsでタスクの計画を立て、get_toolで入力スキーマを読み、run_toolでツールを実行して結果を読みます。
クライアントを接続する
サーバーは Streamable HTTP で通信し、REST API と同じキーを使って Authorization: Bearer lr-... で認証します。Streamable HTTP 経由のリモート MCP サーバーに対応したクライアントならどれでも使えます。ローカルサーバーしか起動できないクライアントは、Claude Desktop と同じように mcp-remote ブリッジを介して接続します。
codex mcp add lovely --url https://lovelyrouter.com/mcp --bearer-token-env-var LOVELY_API_KEYCursor は ~/.cursor/mcp.json またはプロジェクトの .cursor/mcp.json を読み込みます。Claude Desktop ではブリッジに Node.js が必要です。Settings → Developer → Edit Config で上のブロックを追加し、Claude Desktop を再起動してください。
MCP ツール
少数の固定された MCP ツールから、カタログのすべてのツールにアクセスできます。エージェントは必要になったときにだけツールを探し、そのスキーマを読みます。
| グループ | MCP ツール | できること |
|---|---|---|
| 検索と読み取り | web_search、web_fetch | Web を検索する（最大 50 件。site:、after:、"exact phrase" などの演算子に対応）か、1 つのページをクリーンな Markdown で読みます。検索 1 回またはページ 1 つにつき $0.0009。結果のない検索や読み取れないページは無料です。 |
| データカタログ | suggest_tools、search_tools、get_tool、run_tool、get_run | 見積もり費用付きでタスクを計画し、カタログを検索して、ツールのスキーマと現在の料金を読みます（ここまではすべて無料）。そのうえでツールを実行し、結果を読みます。 |
| ブラウザエージェント | browser_run、browser_status、browser_reply、browser_takeover | クリック、入力、ログインが必要な Web サイト上のタスクを実行します。エージェントの質問に答えたり、ステップを承認したり、ブラウザを引き継いだりできます。 |
| 画像 | generate_image、get_image | 説明文から画像を作成します。1 枚 $0.04 です。 |
サーバーはエージェントに対し、読むだけでよいものには web_search と web_fetch を使い、操作が必要なページにはブラウザエージェントを使うよう指示します。suggest_tools、search_tools、get_tool はキーなしで使えるため、キーを接続する前からエージェントはカタログを閲覧できます。
run_tool から使えるツールの一部を、現在の料金とともに紹介します。
Web を検索します。最大 50 件の結果に、タイトル、URL、日付、サイト、短い抜粋、モデル向けの長い要約（必要ならページ本文も）が付きます。演算子：site:、-site:、"完全一致"、-語、lang:、after:、before:。
公開されている Web ページを、ナビゲーションや広告を除いたきれいな Markdown（タイトルと本文）で読み取ります。URL がわかっている 1 ページ向けです。
キーワードと地域で Google マップ上の店舗・事業者を検索：名前、住所、電話番号、Web サイト、評価、レビュー数、営業時間、座標。
Google マップの場所（プレイス ID または URL）のレビュー：本文、星評価、日付、オーナーの返信。
URL で公開 LinkedIn プロフィールを取得：見出し、職歴、学歴、スキル、所在地。
クエリまたはサブレディットで Reddit の投稿を取得：タイトル、本文、スコア、コメント数、投稿者、日付。
YouTube 動画の字幕全文（タイムスタンプ付き）：動画リンクごとに 1 件、動画にあれば指定した言語で。
Give it a goal and a start page; an AI agent drives a real browser to do it: navigate, fill forms, log in with saved secrets, ask you for codes, hand over for CAPTCHAs, wait for your approval before purchases, and return structured JSON in your schema. For tasks that need interaction; to just read a page, use Read a web page (web-fetch). $0.006 per step in fast mode, $0.012 in accurate mode (looks at screenshots when unsure, can run read-only code to read data). Each step includes 1 minute; time beyond that (e.g. waiting for your approval) costs $0.005/min. Full API: /v1/browser.
試してみたいプロンプト
- 「オースティンのヴィーガンレストランを探して、レビューでどんな不満が出ているか教えて」 エージェントは Google Maps の場所検索を実行し、見つかった場所について Google Maps のレビューを実行します。
- 「この URL の移行ガイドを読んで、それに合わせてクライアントコードを更新して」
web_fetchを 1 回呼び出すだけで、ページが Markdown になります。 - 「今週 Reddit で自社製品についてどんなことが言われている？ 不満をグループ分けして」 エージェントは期間を絞り込んで Reddit 検索を実行します。
- 「この YouTube のトークの文字起こしを取得して、タイムスタンプ付きで要約して」 YouTube 文字起こしを 1 回実行します。
- 「この公開フォームに以下の内容を入力して、確認番号を教えて」 エージェントはブラウザエージェントを起動します。パスワードは名前を指定して保管庫から取り出され、MCP を経由することはありません。
エージェントの支出を管理する
上限はモデルのリクエスト、データツール、ブラウザエージェントのすべてに適用されます。API キーを参照してください。
max_results を指定する。実行の費用は、呼び出しあたりの料金と、結果 1 件あたりの料金に max_results を掛けた額の合計が上限になります。プロジェクトの指示に 「max_results を必ず指定すること」 と書いておきましょう。
suggest_tools と get_tool は無料で現在の料金を返すため、エージェントは実行前にその最大費用を確認できます。
すべての実行とその請求額は、ダッシュボードの「ツール」に一覧表示されます。同時に進行できる実行は最大 10 件です。
支払う料金
サブスクリプションはありません。MCP の呼び出しは、REST での同じ呼び出しと同様にプリペイド残高から課金されます。データツールは呼び出しあたりの料金と結果 1 件あたりの料金、Web 検索とページ読み取りは呼び出しごと、ブラウザエージェントはステップごと（高速モードで $0.006、高精度モードで $0.012）、画像は 1 枚ごとの課金です。実行は開始時に最大費用を確保し、終了時に届けた分だけ課金されます。失敗した実行は、返した結果の分だけ支払います。料金を参照してください。
よくある質問
どの MCP クライアントでサーバーを使えますか？+
Claude Code、Cursor、Codex CLI、Gemini CLI をはじめ、Streamable HTTP 経由のリモート MCP サーバーに対応したクライアントなら、URL とキーで接続できます。Claude Desktop の MCP 設定や、ローカルサーバーしか起動できないクライアントでは、mcp-remote ブリッジを介して接続します。
Claude Code の MCP サーバーとして追加するには？+
claude mcp add --transport http で https://lovelyrouter.com/mcp と API キーを登録すれば、コマンド 1 つで完了します。すべてのプロジェクトで使うには --scope user を付け、claude mcp list で接続できているか確認してください。
ツール用に別のアカウントやキーが必要ですか？+
いいえ。Claude、GPT、Gemini に使っている API キーがそのまま MCP サーバーでも使えます。ツールの支出は同じプリペイド残高から差し引かれ、同じキーの利用上限に計上されます。
キーを追加する前に、エージェントはツールを確認できますか？+
はい。suggest_tools、search_tools、get_tool はキーなしで使えるため、エージェントは先にタスクを計画して料金を確認できます。ツールやブラウザエージェントを実行するにはキーが必要です。
エージェントの使いすぎを防ぐにはどうすればよいですか？+
エージェントに利用上限付きの専用キーを渡し、すべての実行で max_results を指定するよう指示してください。キーの上限を超えるおそれのある実行は、課金が発生する前に 402 で拒否されます。
ツールの実行に 1 分以上かかるとどうなりますか？+
ほとんどのクライアントは約 1 分でツール呼び出しを打ち切るため、run_tool は最大 50 秒だけ待ちます。それより長い実行は実行 ID とともに返され、エージェントは get_run を呼び出して結果を待ちます。
ブラウザエージェントで自分のマシン上のサイトを開けますか？+
いいえ。ブラウザエージェントはクラウドで動作するため、localhost やプライベートアドレスは開けません。エージェントが読むだけでよい公開ページなら、web_fetch のほうが速く安価です。
検索だけを使う場合は Web 検索 API を、同じキーで Claude Code 自体を動かす場合は AI コーディングエージェントを参照してください。すべての引数と戻り値の形式は MCP サーバーのドキュメントにまとめています。