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

  • 用于收集主页的 Reels 信息流。
  • 适用于短视频创意研究和视频内容跟踪。

• scrapesocial facebook profiles photos

  • 用于收集主页的照片信息流。
  • 适用于图片创意分析和相册内容提取。

• scrapesocial facebook posts get

  • 需要完整对象时，用于获取单条帖子或 Reels。
  • 想在一次请求中进行初步深入分析时，添加 --get-comments 或 --get-transcript。

• scrapesocial facebook comments

  • 用于分页获取帖子或 Reels 的评论。
  • 有 --feedback-id 时优先使用；可从 facebook posts get 获取。

• scrapesocial facebook transcript

  • 只需要帖子的转录文本、不需要其余帖子数据时使用。

• scrapesocial facebook groups posts

  • 用于获取 Facebook 群组的帖子。
  • 适用于社群监测、话题发现和趋势观察。

• scrapesocial facebook ads search

  • 用于按关键词或主题搜索 Meta 广告资料库。
  • 最适合市场扫描、广告文案研究，以及在尚不清楚广告主时查找广告。

• scrapesocial facebook ads companies search

  • 用于根据公司或品牌名称查找广告主身份和主页 ID。
  • 当用户说“给我看看这个品牌的 Facebook 广告”时，这是最佳的第一步。

• scrapesocial facebook ads companies get

  • 用于列出已知广告主的广告。
  • 已有主页 ID 或刚查到主页 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. 如果评论串很长，继续使用 facebook comments；如果帖子数据中有 --feedback-id，请重复使用。

群组研究

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。
• 相较于只提供帖子 URL，facebook comments 配合 --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