scrapesocial-facebook

Scrapesocial Facebook

Facebook の調査や分析タスクには、このスキルを使用します。ユーザーの目的に応じて、適切な scrapesocial Facebook コマンドを選択します。

前提条件

• このスキルを使用するには、Scrape Creators API キーが必要です。scrapecreators.com で取得してください。

クイックスタート

• CLI を一度インストールします。

npm install -g scrapesocial

• SCRAPECREATORS_API_KEY または --api-key を使用して認証できることを確認します。
• 手元にある最も安定した識別子を起点にします。
  • オーガニックな Facebook データには、ページ／プロフィールの URL
  • 単一の投稿、トランスクリプト、コメントスレッドには、投稿の URL
  • コミュニティの調査には、グループの URL
  • 広告ライブラリの調査には、ブランド名、キーワード、ページ ID、広告 ID
• まず対象を絞ったコマンドを使い、必要な場合にのみページネーションや詳細な調査を行います。

目的別のワークフロー

目的	このスキルを使用する場面	開始方法
リード獲得	既知のブランド、ページ、広告主、またはコミュニティを基盤とする見込み客の適格性を確認する場合に使用します。コールドディスカバリーよりも適格性確認に適しています。	既知のブランドには facebook ads companies search、既知のページには facebook profiles get から始め、その後 facebook profiles posts または facebook ads companies get で調査を広げます。
インフルエンサーの発見	別の場所で見つけた既知のクリエイターやページを評価し、そのニッチで継続的に投稿しているかを確認する場合に使用します。	facebook profiles get から始め、facebook profiles reels と facebook profiles posts を比較します。
ブランドモニタリング	所有するページやグループ、広告の動向を継続的に監視する場合に使用します。	対象に応じて、facebook profiles posts、facebook profiles reels、facebook groups posts、または facebook ads companies get から始めます。
競合分析	競合間で、ページの活動、クリエイティブの形式、有料メッセージを比較する場合に使用します。	各ページについて facebook profiles get から始め、その後 facebook profiles posts と facebook ads companies get を使って並べて確認します。
コンテンツ分析	どの投稿、リール、写真、広告を詳しく分析すべきかを判断する場合に使用します。	facebook profiles posts または facebook profiles reels から始め、有力なコンテンツを facebook posts get、facebook comments、または facebook transcript で調べます。
トレンド調査	グループでの会話や、広告ライブラリのパターンを見つける場合に使用します。	議論のトレンドには facebook groups posts、クリエイティブやメッセージのトレンドには facebook ads search から始めます。
オーディエンス分析	オーディエンスが使う言葉、懸念、反応を定性的に分析する場合に使用します。人口統計に基づくオーディエンスの内訳は提供しません。	代表的な投稿の facebook comments、またはコミュニティの議論を調べる facebook groups posts から始めます。

適切なコマンドを選ぶ

• scrapesocial facebook profiles get

  • ページ／プロフィールのメタデータを取得するときに使います。
  • ビジネスページの調査を始めるのに適しています。営業時間が必要な場合は --get-business-hours を追加します。

• scrapesocial facebook profiles posts

  • ページまたはプロフィールの最近のタイムライン投稿を収集するときに使います。
  • コンテンツ監査、エンゲージメントの確認、詳しく調査する投稿 URL の特定に適しています。

• scrapesocial facebook profiles reels

  • ページのリールフィードを収集するときに使います。
  • 短尺クリエイティブの調査や動画コンテンツの追跡に適しています。

• scrapesocial facebook profiles photos

  • ページの写真フィードを収集するときに使います。
  • 画像クリエイティブの分析やギャラリーの抽出に適しています。

• scrapesocial facebook posts get

  • 投稿またはリールの完全なデータが必要な場合に使います。
  • 1 回のリクエストで初期の詳細調査を行う場合は、--get-comments または --get-transcript を追加します。

• scrapesocial facebook comments

  • 投稿またはリールのコメントをページネーションで取得するときに使います。
  • --feedback-id が利用できる場合はそちらを優先します。facebook posts get で取得できます。

• scrapesocial facebook transcript

  • 投稿の他のデータは不要で、文字起こしだけが必要な場合に使います。

• scrapesocial facebook groups posts

  • Facebook グループの投稿を取得するときに使います。
  • コミュニティのモニタリング、トピックの発見、トレンドの把握に適しています。

• scrapesocial facebook ads search

  • キーワードまたはテーマで Meta Ad Library を検索するときに使います。
  • 市場調査、メッセージングの調査、広告主がわからない段階での広告の発見に最適です。

• scrapesocial facebook ads companies search

  • 会社名またはブランド名から広告主の識別情報とページ ID を特定するときに使います。
  • 「このブランドの Facebook 広告を見せて」とユーザーが依頼した場合の最初のステップに最適です。

• scrapesocial facebook ads companies get

  • 特定済みの広告主の広告を一覧表示するときに使います。
  • すでにページ ID がわかっている場合、または直前に検索した場合に最適です。

• scrapesocial facebook ads get

  • 特定の広告を詳しく調査するときに使います。
  • 文字起こしが必要な短い動画広告の場合は、--get-transcript を追加します。

よくあるワークフロー

ページまたはプロフィールの監査

1. facebook profiles get を実行してページを確認し、トップレベルのメタデータを収集します。
2. タイムラインを取得するには facebook profiles posts を実行します。
3. より網羅的なクリエイティブ一覧が必要な場合は、facebook profiles reels と facebook profiles photos も追加します。
4. 詳細な分析が必要な場合は、個々の投稿を facebook posts get で開きます。

投稿の調査

1. facebook posts get --url ... から始めます。
2. 最初のコメントや文字起こしもすぐに必要な場合は、--get-comments または --get-transcript、あるいは両方を追加します。
3. スレッドが長い場合は、投稿データに --feedback-id が含まれていればそれを再利用し、facebook comments で続けて取得します。

グループの調査

1. facebook groups posts --url ... を使います。
2. タスクに応じて --sort-by を調整します。
   • 最も反響の大きい投稿を調べる場合は TOP_POSTS
   • 現在の議論をモニタリングする場合は RECENT_ACTIVITY または CHRONOLOGICAL
3. 十分な範囲をカバーするまで、--cursor を使ってページネーションを続けます。

広告の調査

1. メッセージや市場はわかっているものの広告主が不明な場合は、facebook ads search から始めます。
2. ブランドがわかっている場合は、facebook ads companies search から始めて、次に facebook ads companies get を実行します。
3. 目立つ広告のクリエイティブの詳細や文字起こしを確認するには、facebook ads get を使います。
4. 大規模にページネーションする前に、国、ステータス、メディアタイプ、期間などのフィルターを適用します。

作業メモ

• Facebook の多くの一覧取得コマンドはページネーションデータを返します。返された --cursor、--page-id、または --group-id をそのまま再利用します。
• facebook comments は、投稿 URL だけを使うよりも --feedback-id を使うほうが大幅に高速です。
• テーマから広告を探す場合は facebook ads search が最適です。広告主単位で収集する場合は facebook ads companies get が最適です。
• 下流の処理に使うデータを簡潔にしたい場合は、広告コマンドで --trim を使います。

最小限の例

scrapesocial facebook profiles get --url https://www.facebook.com/nasa
scrapesocial facebook profiles posts --url https://www.facebook.com/nasa
scrapesocial facebook posts get --url https://www.facebook.com/... --get-comments --get-transcript
scrapesocial facebook groups posts --url https://www.facebook.com/groups/...
scrapesocial facebook ads companies search --query "Nike"
scrapesocial facebook ads companies get --page-id 123456789
scrapesocial facebook ads search --query "running shoes" --country US --status ACTIVE
scrapesocial facebook ads get --id 1234567890 --get-transcript