facebook-research について
マーケティング、成長施策、クリエイター、コミュニティ、競合、ファネル調査向けに、公開 Facebook 情報を収集する PostPlus のスキルです。投稿、コメント、広告、イベント、マーケットプレイス掲載、ページ、公開検索を目的別に使い分け、観測できる情報と非公開データを区別します。
主な機能
- 01公開投稿とプロフィールの収集
- 02リールとコメントの調査
- 03広告ライブラリのクリエイティブ確認
- 04イベントとマーケットプレイス掲載の検索
- 05ページと公開情報源の発見
- 06必要な証拠に応じた調査経路の選択
活用シーン
- 01公開された競合コンテンツの比較
- 02公開コメントとオーディエンスの懸念の確認
- 03広告クリエイティブと CTA の比較
- 04地域イベントやマーケットプレイス掲載の検索
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ postplusai/ postplus-skills --skill facebook-researchインストール後、Claude Code で/facebook-researchを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/ads-and-funnel.mdcommunity-voice.mdevents-and-local.mdorganic-benchmark.mdpage-and-group-audit.mdpartner-discovery.mdpublic-content.mdreels-and-video.mdshared-contract.mdshops-and-marketplace.md詳細
Facebook Research
ユーザーが成長、マーケティング、クリエイター、コミュニティ、競合、またはファネルに関する意思決定のために、公開されているFacebook上の情報(ページ/プロフィールの投稿、個別の投稿、公開グループの投稿、リール、コメント、広告ライブラリのクリエイティブ、イベント、マーケットプレイスの掲載情報、ページプロフィール、公開検索)を必要としている場合に、このスキルを使用します。
依頼内容に合致する参照資料を1つだけ読みます。
収集ルート
Facebookには、公開ページ/プロフィール/グループ/投稿のURLを起点とするルートと、リール、コメント、広告、イベント、マーケットプレイス、ページ、検索に特化したルートがあります。ユーザーの意図に応じてルートを選択します。実行の詳細はPostPlusが処理します。
すべての投稿収集では output.items[] が返されます。フィールドは通常の投稿、グループの投稿、リールで異なります。選択した参照資料に従ってください。facebook-group-posts と facebook-groups は、同じ公開グループの投稿をサンプリングします。独立した裏付けとして両方を実行しないでください。どちらのグループルートも、サーバー側のキーワードフィルターなしで、時系列順の投稿サンプルを返します。グループのメンバーシップ、設立日、認証情報がない場合、それらは「0」や「いいえ」ではなく、取得できない情報です。
web-search は外部ソースの発見にのみ使用します。検索結果のスニペットは、Facebookの投稿やコメントの根拠にはなりません。検索ページのフィールドの読み取りには references/public-content.md を参照してください。
ルート
| ユーザーの意図 | 読む資料 |
|---|---|
| 公開ページ、プロフィール、グループ、投稿のコンテンツ収集 | references/public-content.md |
| ページの健全性、競合ページ、グループの質、公開状況の監査 | references/page-and-group-audit.md |
| オーガニック投稿のフック、形式、競合、投稿例、コンテンツのパターン | references/organic-benchmark.md |
| リール、短尺動画、動画のフック、メディアを中心としたベンチマーク | references/reels-and-video.md |
| コメント、オーディエンスの声、懸念点、FAQ、グループでの議論 | references/community-voice.md |
| 広告ライブラリのクリエイティブ、有料オファー、CTA、ファネルのレビュー | references/ads-and-funnel.md |
| イベント、地域での活動、主催者、オフラインの需要 | references/events-and-local.md |
| マーケットプレイスの掲載情報、地域の商取引、価格帯 | references/shops-and-marketplace.md |
| パートナー/クリエイター/主催者の発見、Facebook全体の検索、ページの認証確認 | references/partner-discovery.md |
| 非公開プロフィール、非公開グループ、メンバーリスト、ページインサイト、広告アカウントの指標、ターゲティング、広告費、ROAS | 中止し、公開ソースまたはエクスポートデータを依頼します |
最初の質問
回答によってルート、ソース、プライバシーの境界、サンプル数、または出力形式が変わる場合に限り、質問します。
| 不足している情報 | 質問 |
|---|---|
| 広告以外の起点 | 基準となるFacebookのソースは何ですか。ページ、プロフィール、グループ、投稿URL、キーワード、イベントのいずれでしょうか。 |
| 意思決定の目的 | どのような意思決定に役立てますか。監査、ベンチマーク、ユーザーの声、広告、イベント、マーケットプレイス、発見のいずれでしょうか。 |
| 非公開の対象 | 代わりに公開URLまたはエクスポートしたデータセットを提供できますか。 |
| 広告以外で範囲が広すぎる場合 | 最初の調査で特に重要なソースを1〜5件選ぶとしたら、どれですか。 |
広告の場合は、製品URL、馴染みのないブランド、カテゴリ、または課題があれば、起点として十分です。関連する製品は自分で見つけます。references/ads-and-funnel.md の広告固有の数量ルールと停止ルールに従ってください。
内部のルート識別子、スキーマ、実装方法、再試行、認証情報、非表示のフィルター、内部ルーティングについてユーザーに尋ねないでください。
実行の進め方
- 参照資料を1つ、ルートを1つ選びます。
- 広告の場合は、
references/ads-and-funnel.mdの説明に従って最新のエビデンスを収集します。保存済みの広告ライブラリを自動的に検索してはいけません。ライブラリを明示的に閲覧することは、別個のユーザー目標です。それ以外の場合は、判断に答えられる最小限の実データを収集します。 - 互いに依存しないソースは並列処理します。
- 実行に成功してもエビデンスが空、少量、ノイズが多い、またはトピックから外れている場合は、エビデンスを受け入れたり収集を打ち切ったりする前に、以下の品質ルールを適用します。
- アイテム単位のエビデンスを収集した場合は、信頼できる情報源として JSON を生成し、簡潔な HTML エビデンス成果物も作成します。
- チャットでは、対象範囲、件数、最も重要な調査結果、最大の不足点、成果物のパス、次のアクションを簡潔に回答します。
選択したルートに表示されている公開フィルターのみを使用します。
公開コマンドの境界
-
該当するルートのうち、最も小さいものを選び、直接実行します。
-
準備状況の診断:
postplus doctor --skill facebook-research -
セマンティックフラグが明確でない場合は、
postplus research run <route> --helpでルートを1つ確認します。 -
postplus research run <route> --<semantic flags> --wait --output <result.json>を実行します。 -
公開 URL、検索語、場所、対象範囲、結果の上限のみを指定します。
-
広告以外のルートでは、最初の調査は範囲を限定し、最初の結果を確認してからのみ拡張します。広告の場合は、広告の参照資料に従い、要求されたエビデンスの成果に向けて収集します。 致命的なエラーが発生したら停止します。ソースを黙って切り替えたり、欠けているデータを捏造したりしてはいけません。
-
依頼されたタスクでは、現在の料金と残高を確認したうえで、既存の PostPlus クレジットを使用します。見積もりのみの依頼は実行しません。クレジットが不足している場合は停止します。チャージ、サブスクリプションの購入、または結果が不確かな有料操作の再実行は行いません。
コマンドの選択
| エビデンスのニーズ | ルート | セマンティック入力 | 最初の調査 |
|---|---|---|---|
| 公開ページ/プロフィールの投稿 | facebook-profile-posts | --url、--limit | URL 1~5 件、投稿 20 件 |
| 直接の投稿エビデンス | facebook-post-by-url | --url | URL 1~10 件 |
| 公開グループの投稿 | facebook-group-posts | --url、--limit | グループ 1~3 件、投稿 20 件 |
| 広告ライブラリのクリエイティブ | facebook-ads-library | --query、--country、--status、--limit | 広告の参照資料を確認:成果に応じた規模の収集 |
| 投稿/リールのコメント | facebook-comments | --url、--limit | URL 1~5 件、コメント 20 件 |
| 公開グループのディスカッション | facebook-groups | --url、--limit | 投稿 20 件 |
| イベント/地域のアクティビティ | facebook-events | --query または --url、--limit | イベント 10 件 |
| Marketplace の出品 | facebook-marketplace | --url、--limit | 出品 10 件 |
| ページの識別情報 | facebook-pages | --url | ページ 1~5 件 |
| 詳細なページ/プロフィールの投稿 | facebook-posts | --url、--limit | 投稿 20 件 |
| リール | facebook-reels | --url、--limit | リール 20 件 |
| 広範な公開検索 | facebook-search | --category、--location、--limit | 結果 20 件 |
プラットフォームの対象範囲やエビデンスの解釈が不明なままの場合に限り、 プラットフォーム契約 を参照します。これは事前確認用ではありません。
エビデンスの品質
- ページ/投稿/コメント/広告のレコードが要求された対象レーンと一致していることを確認します。公開グループの投稿が自動的にコメントのエビデンスになるわけではありません。
- エビデンスが不足している場合は、公開ソースの URL またはサポート対象のクエリを変更します。広告クリエイティブはオーガニック投稿と分けて扱います。
- 広告以外のルートでは、結果が成功していても不十分な場合に限り、承認済みの対象範囲と予算内で、変更を加えた追加試行を最大 2 回まで許可します。同一のリクエストを繰り返したり、失敗または保留中の処理を隠したりしないでください。
- 広告では、広告リファレンスに基づくエビデンスベースの停止条件を使用します。それ以外の場合は、十分な結果が得られたとき、上限に達したとき、または次の試行が役に立たないときに停止します。有用なエビデンスと不確実性を報告し、生の結果とソースリンクを保持します。
広告ライブラリの可視性は、広告費や ROAS を示すものではありません。ソース URL と確認された日付を保持し、コメントと投稿本文を区別してください。
すべての機械可読フィールドは postplus research schema --route <route> --json に含まれます。
処理に必要な場合にのみ参照し、リクエストのたびに事前確認しないでください。
postplus research run facebook-ads-library \
--query "example topic" \
--wait \
--output ./result.json
CLI の構造化された結果と報告された次のアクションに従ってください。自由記述のメッセージから復旧方法を推測しないでください。 要求された対象範囲と最大費用をすでにカバーしている、ユーザーからの明示的な承認がある場合はそれを再利用します。それ以外の場合は、見積もりを確定する前に承認を得てください。タスクだけを根拠に支出の承認を推測してはいけません。 返されたチェックポイントまたはアクションを通じて同じ処理を再開してください。結果が不確かな処理を再送信したり、復旧を何度も試みたり、失敗を回避するためにプロバイダーを切り替えたりしないでください。