自社や競合が何かをリリースしたとき、発表投稿へのリプライは、受け止められ方を最も早く、正直に知る手がかりになります。とはいえ 400 件のリプライを手で読む人はいませんし、スレッドは増え続けます。Lovely Router がそれを代わりに読みます。投稿のリンクを送ると、リプライ 1 件につき JSON オブジェクトが 1 つ返り、料金はプリペイド残高からリプライ単位で支払います。スクリプト、日次レポート、AI エージェントのどこからでも、1 つの API キーで呼び出せます。
AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
X の投稿へのリプライを読んで、ローンチの反応を把握する. Use the Lovely Router data tools: each returns JSON and is billed per result.
- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. 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.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and 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: <the inputs (links, keywords or accounts) and how many results you need>仕組み
投稿を選ぶ
重要な投稿のリンクをコピーします。自社のローンチスレッド、競合の発表、拡散したクレームなどです。
上限を付けてツールを実行する
リンクを
max_resultsと一緒にPOST /v1/tools/x-replies/runに送ります。実行は最大費用を残高から仮押さえし、リプライを JSON で返します。声を仕分ける
リプライを質問、称賛、バグ報告、機能要望に手作業またはモデルで分類し、エンゲージメント順に並べます。
1 回のリクエストで投稿へのリプライを取得する
X（Twitter）の投稿リプライ取得は、postUrls に投稿のリンクを受け取ります。上限は resultsLimit で指定します。
curl https://lovelyrouter.com/v1/tools/x-replies/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"postUrls": ["https://x.com/elonmusk/status/1905584213761351970"],
"resultsLimit": 100
},
"max_results": 100
}'60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。
各リプライに含まれる情報
| フィールドグループ | 取得できるもの |
|---|---|
| Content | リプライの本文 |
| Author | 投稿者 |
| Engagement | リプライのエンゲージメント数 |
| Time | 投稿された日付 |
1 回の実行で最大 500 件のリプライを返し、デフォルトは 20 件です。上限は、実際に読む、または分析する件数に合わせて設定してください。
レシピ
発表の 2 時間後に、最初の 200 件のリプライを取得します。質問を数え、バグ報告にフラグを立て、エンゲージメント上位 5 件をチームに共有します。
競合の価格改定へのリプライを、モデルにテーマごとにクラスタリングさせ、最も大きいテーマを自社のメッセージに活かします。
顧客のクレームが広がり始めたら、リプライを集めて、同じ問題を抱えている人や試した対処法を確認します。
自社製品の投稿へのリプライを取得し、疑問符で終わるものを残して、最も繰り返される質問にドキュメントで答えます。
自社の投稿と競合の投稿に同じ処理を実行し、リプライの量と、最もエンゲージメントの高いリプライを比較します。
普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「この X の投稿への最新 200 件のリプライを読み、質問、クレーム、称賛に分類して、各グループで「いいね」の多い上位 3 件を引用してください。max_results は 200 に設定してください。」
他の X データと組み合わせる
リプライは 1 本のスレッドにすぎません。会話の全体像と、その参加者を知るには次のツールを使います。
URL で指定した X/Twitter 投稿への返信：本文、投稿者、エンゲージメント、日付。
検索語・ハッシュタグ・指定アカウントに一致するツイート：本文、投稿者、エンゲージメント、日付。
X/Twitter アカウントのプロフィール：自己紹介、フォロワー、フォロー、認証、各種カウント。
URL で指定した Reddit スレッドの投稿とコメント。
YouTube 動画またはショートのコメント：本文、高評価、返信数、投稿者、日付。人気順または新しい順。
x-searchは、min_faves:やsince:などの演算子を使って、自社をタグ付けしていないローンチ関連の投稿を見つけます。x-profileは、最も声の大きい返信者が誰かを確認します。reddit-commentsは、同じローンチについての Reddit での議論を集めます。youtube-commentsは、ローンチ動画のコメントを対象にします。
継続的なメンションのフィードについては、ソーシャルリスニングをご覧ください。
リプライは実名のユーザーによるものです。保存したり連絡したりする場合は、プライバシー保護法やスパム規制を含め、そのデータを適法に利用する責任があなたにあります。
料金
料金はリプライ 1 件ごとにかかります。実行を開始すると最大費用（呼び出し料金 + リプライ単価 × max_results）が仮押さえされ、実際に返った分で精算されて、仮押さえの残りは残高に戻ります。失敗またはタイムアウトした実行は返したリプライの分だけを支払い、開始時に拒否された実行は無料です。
200 件のリプライを読むと、リプライ 200 件分として課金されます。サブスクリプションや月額の最低利用料はなく、$5 からチャージでき、1 つの残高でツールとモデルの両方を支払えます。現在の価格は上のカードに表示されており、料金ではすべてのツールを一覧できます。
よくある質問
1 回の実行で複数の投稿を渡せますか？+
postUrls はリストなので、渡せます。resultsLimit の上限は全体で共有されるため、投稿の数に合わせて引き上げてください。
リプライは何件まで取得できますか？+
1 回の実行で最大 500 件で、上限を設定しない場合は 20 件です。それ以上必要な場合は、続けて実行してください。
各リプライには何が含まれますか？+
本文、投稿者、エンゲージメント、日付です。
リプライへのリプライも含まれますか？+
このツールは、URL を指定して投稿へのリプライを取得するものとして説明されています。ネストしたスレッドについては、それ以上の記載がないため、まず小さな実行で確認してください。
X のアカウントは必要ですか？+
いいえ。投稿のリンクと API キーを送るだけです。
サブスクリプションは必要ですか？+
いいえ。プリペイド残高にクレジットを追加し、実行ごとに残高から差し引かれます。失敗した実行は返した結果の分だけを支払い、自動で更新されるものは何もありません。
1 本のスレッドではなく会話全体を追うなら、ソーシャルリスニング、レビューモニタリング、そのほかのツールカタログをご覧ください。