ユースケース

公開 Facebook グループでメンバーが求めているものを調べる

Q: 1 回の実行で何グループまで読み取れますか？

1 回の実行で最大 50 グループです。resultsLimit は、それらすべてを合わせた投稿の合計数です。

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

はい。onlyPostsNewerThan に日付、ISO タイムスタンプ、または 7 days のような値を指定します。除外された投稿には課金されません。

Q: グループの投稿数が上限より少ない場合は？

返された投稿の分だけを支払います。

公開 Facebook グループの投稿を、本文・投稿者・リアクション・コメント数・日付つきの JSON で取得。満たされていない需要や繰り返される悩みを見つけます。

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

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

機能や製品を作る前に、実際の人たちが自分の悩みをどう表現しているかを読みたいものです。ニッチな趣味や専門分野では、それが Facebook グループで語られています。ただし、50 のグループを毎週スクロールできる人はいません。Lovely Router がその代わりに読みます。公開グループのリンクを送れば、投稿 1 件につき 1 つの JSON オブジェクトが返り、プリペイド残高から投稿 1 件ごとに課金されます。スクリプトや AI エージェントから、1 つの API キーで呼び出せます。

AI エージェントに任せる

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

公開 Facebook グループでメンバーが求めているものを調べる. 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>

仕組み

グループを一覧にする
購入者が話している公開グループのリンクをそれぞれコピーします。1 回の実行で最大 50 グループまで指定できます。
上限を付けてツールを実行する
リンクを startUrls に入れ、resultsLimit と max_results を添えて送ります。実行は最大費用を残高から仮押さえし、投稿を JSON で返します。
パターンを見つける
モデルに、投稿を質問や不満ごとにクラスタリングして数えてもらいます。リアクションやコメント数が多い投稿は、多くの人が共有している悩みを示します。

1 回のリクエストでグループ投稿を取得する

Facebook グループの投稿を取得するツールは、公開グループのリンクを startUrls に受け取ります。resultsLimit は、すべてのグループを合わせた投稿の合計数です。

Shell

curl https://lovelyrouter.com/v1/tools/facebook-groups/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "startUrls": [
        {
          "url": "https://www.facebook.com/groups/874728723021553"
        }
      ],
      "resultsLimit": 3
    },
    "max_results": 3
  }'

viewOption で並び順（CHRONOLOGICAL、RECENT_ACTIVITY、TOP_POSTS）を選び、onlyPostsNewerThan で最近の投稿だけに絞れます。除外された投稿には課金されません。60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。

投稿ごとの内容

フィールド群	取得できる内容
内容	投稿の本文
投稿者	投稿した人
エンゲージメント	リアクションとコメントの数
時期	投稿の日付

グループの投稿は一般の個人が書いたものです。テキストは調査に使い、集計して扱ってください。メンバーに連絡する場合は、プライバシーやスパム対策の規則を含め、データを適法に利用する責任は利用者にあります。

レシピ

悩みを頻度順に並べる。

5 つのグループから人気の投稿を 200 件（viewOption を TOP_POSTS に設定）取得し、モデルに悩みを一覧にして件数を付けてもらいます。

製品アイデアを検証する。

グループの最近の投稿から、作ろうとしているものを求めている人を探します。要望の数を数え、使われている言葉を読みます。

顧客の言葉でコピーを書く。

リアクションが多い投稿からフレーズを集め、ランディングページや広告に使います。

新しい質問を毎週チェックする。

onlyPostsNewerThan を 7 days に設定してスケジュール実行すれば、各回の費用は新しい投稿の分だけになります。

コンテンツのネタを見つける。

コメント数で投稿を並べ替えます。スレッドが最も長い投稿は、オーディエンスが解説を求めているトピックです。

普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「groups.txt にある 3 つのグループリンクから最新の投稿 300 件を読み、最も多い質問 10 個にクラスタリングして、それぞれ投稿を 1 つ引用してください。max_results は 300 に設定してください。」