mcpField
F
facebook-research

facebook-research

github.com/postplusaiマーケティング・グロース271.1k 回インストール1 日前に更新
リポジトリ

facebook-research について

マーケティング、成長施策、クリエイター、コミュニティ、競合、ファネル調査向けに、公開 Facebook 情報を収集する PostPlus のスキルです。投稿、コメント、広告、イベント、マーケットプレイス掲載、ページ、公開検索を目的別に使い分け、観測できる情報と非公開データを区別します。

主な機能

  1. 01公開投稿とプロフィールの収集
  2. 02リールとコメントの調査
  3. 03広告ライブラリのクリエイティブ確認
  4. 04イベントとマーケットプレイス掲載の検索
  5. 05ページと公開情報源の発見
  6. 06必要な証拠に応じた調査経路の選択

活用シーン

  1. 01公開された競合コンテンツの比較
  2. 02公開コメントとオーディエンスの懸念の確認
  3. 03広告クリエイティブと CTA の比較
  4. 04地域イベントやマーケットプレイス掲載の検索

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/postplusai/postplus-skills --skill facebook-research

インストール後、Claude Code で/facebook-researchを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
ads-and-funnel.md
community-voice.md
events-and-local.md
organic-benchmark.md
page-and-group-audit.md
partner-discovery.md
public-content.md
reels-and-video.md
shared-contract.md
shops-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つ、ルートを1つ選びます。
  2. 広告の場合は、references/ads-and-funnel.md の説明に従って最新のエビデンスを収集します。保存済みの広告ライブラリを自動的に検索してはいけません。ライブラリを明示的に閲覧することは、別個のユーザー目標です。それ以外の場合は、判断に答えられる最小限の実データを収集します。
  3. 互いに依存しないソースは並列処理します。
  4. 実行に成功してもエビデンスが空、少量、ノイズが多い、またはトピックから外れている場合は、エビデンスを受け入れたり収集を打ち切ったりする前に、以下の品質ルールを適用します。
  5. アイテム単位のエビデンスを収集した場合は、信頼できる情報源として JSON を生成し、簡潔な HTML エビデンス成果物も作成します。
  6. チャットでは、対象範囲、件数、最も重要な調査結果、最大の不足点、成果物のパス、次のアクションを簡潔に回答します。

選択したルートに表示されている公開フィルターのみを使用します。

公開コマンドの境界

  • 該当するルートのうち、最も小さいものを選び、直接実行します。

  • 準備状況の診断: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、--limitURL 1~5 件、投稿 20 件
直接の投稿エビデンスfacebook-post-by-url--urlURL 1~10 件
公開グループの投稿facebook-group-posts--url、--limitグループ 1~3 件、投稿 20 件
広告ライブラリのクリエイティブfacebook-ads-library--query、--country、--status、--limit広告の参照資料を確認:成果に応じた規模の収集
投稿/リールのコメントfacebook-comments--url、--limitURL 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 件

プラットフォームの対象範囲やエビデンスの解釈が不明なままの場合に限り、 プラットフォーム契約 を参照します。これは事前確認用ではありません。

エビデンスの品質

  1. ページ/投稿/コメント/広告のレコードが要求された対象レーンと一致していることを確認します。公開グループの投稿が自動的にコメントのエビデンスになるわけではありません。
  2. エビデンスが不足している場合は、公開ソースの URL またはサポート対象のクエリを変更します。広告クリエイティブはオーガニック投稿と分けて扱います。
  3. 広告以外のルートでは、結果が成功していても不十分な場合に限り、承認済みの対象範囲と予算内で、変更を加えた追加試行を最大 2 回まで許可します。同一のリクエストを繰り返したり、失敗または保留中の処理を隠したりしないでください。
  4. 広告では、広告リファレンスに基づくエビデンスベースの停止条件を使用します。それ以外の場合は、十分な結果が得られたとき、上限に達したとき、または次の試行が役に立たないときに停止します。有用なエビデンスと不確実性を報告し、生の結果とソースリンクを保持します。

広告ライブラリの可視性は、広告費や ROAS を示すものではありません。ソース URL と確認された日付を保持し、コメントと投稿本文を区別してください。 すべての機械可読フィールドは postplus research schema --route <route> --json に含まれます。 処理に必要な場合にのみ参照し、リクエストのたびに事前確認しないでください。

postplus research run facebook-ads-library \
  --query "example topic" \
  --wait \
  --output ./result.json

CLI の構造化された結果と報告された次のアクションに従ってください。自由記述のメッセージから復旧方法を推測しないでください。 要求された対象範囲と最大費用をすでにカバーしている、ユーザーからの明示的な承認がある場合はそれを再利用します。それ以外の場合は、見積もりを確定する前に承認を得てください。タスクだけを根拠に支出の承認を推測してはいけません。 返されたチェックポイントまたはアクションを通じて同じ処理を再開してください。結果が不確かな処理を再送信したり、復旧を何度も試みたり、失敗を回避するためにプロバイダーを切り替えたりしないでください。

コメント