ユースケース

Instagram で競合のコンテンツとエンゲージメントをベンチマークする

Q: URL の代わりにユーザー名を使えますか？

はい。startUrls はプロフィール URL を受け取りますが、ユーザー名でも動作します。

Q: 1 回の実行で何件まで返せますか？

最大 200 件で、maxItems で指定します。maxItems は、その実行に含まれる全プロフィールの合計で数えます。

Q: 最近の投稿だけを取得できますか？

はい。until には YYYY-MM-DD 形式の日付を指定でき、それより新しい投稿だけが返ります。

競合プロフィールの最近の Instagram 投稿を、キャプション・いいね数・コメント数・フォロワー数付きで JSON 取得し、エンゲージメントを比較できます。

API キーを取得ドキュメントを読む

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで

週に 3 回投稿していても、フォロワーが自社の 2 倍いる競合が、本当に 2 倍の反応を得ているのかはわかりません。アカウントを手作業で比べるには、プロフィールを 1 つずつ開いて数字をシートに写す必要があります。Lovely Router なら 1 回でまとめて返します。プロフィールの URL を送ると、投稿 1 件につき JSON オブジェクトが 1 つ返り、料金はプリペイド残高から投稿単位で支払います。週次レポート、スクリプト、AI エージェントのどこからでも、1 つの API キーで呼び出せます。

AI エージェントに任せる

このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。

Instagram で競合のコンテンツとエンゲージメントをベンチマークする. 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>

仕組み

アカウントをリストにする
自社のプロフィールと、競合 3〜10 件です。
上限を付けてツールを実行する
プロフィールの URL を startUrls に入れて POST /v1/tools/instagram-posts/run に送ります。input の maxItems は全プロフィールの合計で数え、until を使えば指定日より新しい投稿だけを残せます。
フォロワーあたりのエンゲージメントで比べる
投稿ごとに、いいね数とコメント数の合計を投稿者のフォロワー数で割り、アカウントごとに平均して比較します。

1 回のリクエストで最近の投稿を取得する

Instagram の投稿を取得するは、startUrls にプロフィール URL またはユーザー名を受け取ります。maxItems は全アカウントの合計で数えるため、アカウント数に、各アカウントから取りたい投稿数を掛けた値に設定してください。

Shell

curl https://lovelyrouter.com/v1/tools/instagram-posts/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "startUrls": [
        "https://www.instagram.com/natgeo/"
      ],
      "until": "2026-09-27",
      "maxItems": 30
    },
    "max_results": 30
  }'

各投稿には、キャプション、いいね数、コメント数、メディア、フォロワー数付きの投稿者、日付が含まれます。60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。

各投稿に含まれるもの

フィールドグループ	取得できる内容
内容	キャプションとメディア
エンゲージメント	いいね数とコメント数
投稿者	投稿したアカウント（フォロワー数付き）
時期	日付

レシピ

週次のエンゲージメントベンチマーク。

競合 10 件のプロフィールを、until を 1 週間前にして実行し、フォロワーあたりのエンゲージメントを計算して、ランキングをチームのチャンネルに投稿します。

効果のある形式を知る。

競合の投稿をメディアの種類で分け、いいね数とコメント数を比べます。

投稿に最適な曜日を見つける。

あるアカウントの日付を曜日ごとにまとめ、どの曜日の投稿が最も多くのいいねを集めているかを確認します。

キャプションを分析する。

上位 20 件のキャプションをモデルに送り、長さ、問いかけ、行動喚起など、共通点を尋ねます。

キャンペーンを早期に察知する。

毎日実行し、そのアカウントの平均の数倍のいいねを集めた競合の投稿にフラグを立てます。

普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「この 4 つのプロフィールから、それぞれ直近 20 件の Instagram 投稿を取得し、フォロワーあたりのいいね数とコメント数の合計を計算して、アカウントをランキングにしてください。maxItems と max_results は 80 にしてください。」