scrapesocial-facebook

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Scrapesocial Facebook

Use this skill for Facebook research and analysis tasks. It maps the user's goal to the right

scrapesocial

Facebook command.

使用此技能完成Facebook研究与分析任务。它会将用户的目标匹配到合适的

scrapesocial

Facebook命令。

Prerequisites

前提条件

A Scrape Creators API key is required for this skill. Get one at scrapecreators.com.

使用此技能需要Scrape Creators API密钥。请前往scrapecreators.com获取。

Quick start

快速开始

Install the CLI once:

bash

npm install -g scrapesocial

Ensure authentication is available through
```
SCRAPECREATORS_API_KEY
```
or
```
--api-key
```
.
Start from the most stable identifier you have:
- A page/profile URL for organic Facebook data
- A post URL for a single post, transcript, or comment thread
- A group URL for community research
- A brand name, keyword, page ID, or ad ID for Ad Library work
Prefer a narrow command first, then paginate or deepen only when needed.

安装CLI工具（仅需一次）：

bash

npm install -g scrapesocial

确保通过
```
SCRAPECREATORS_API_KEY
```
环境变量或
```
--api-key
```
参数完成身份验证。
从你拥有的最稳定标识符开始：
- 用于获取Facebook自然流量数据的页面/主页URL
- 用于获取单条帖子、转录内容或评论线程的帖子URL
- 用于社区研究的群组URL
- 用于广告库工作的品牌名称、关键词、页面ID或广告ID
优先使用范围较窄的命令，仅在需要时再进行分页或深入查询。

Goal-led workflows

基于目标的工作流

Goal	When to use this skill	How to start
Lead generation	Use it to qualify known brands, pages, advertisers, or community-led prospects. It is better for qualification than cold discovery.	Start with `facebook ads companies search` for known brands or `facebook profiles get` for known pages, then expand with `facebook profiles posts` or `facebook ads companies get` .
Influencer discovery	Use it to vet known creators or pages surfaced elsewhere and see whether they publish consistently in the niche.	Start with `facebook profiles get` , then compare `facebook profiles reels` and `facebook profiles posts` .
Brand monitoring	Use it to watch owned pages, groups, and ad activity over time.	Start with `facebook profiles posts` , `facebook profiles reels` , `facebook groups posts` , or `facebook ads companies get` , depending on the surface.
Competitor analysis	Use it to compare page activity, creative formats, and paid messaging across competitors.	Start with `facebook profiles get` for each page, then use `facebook profiles posts` and `facebook ads companies get` for side-by-side review.
Content analytics	Use it to explain which posts, reels, photos, or ads deserve deeper analysis.	Start with `facebook profiles posts` or `facebook profiles reels` , then inspect winners with `facebook posts get` , `facebook comments` , or `facebook transcript` .
Trend research	Use it for group conversations and ad-library pattern spotting.	Start with `facebook groups posts` for discussion trends or `facebook ads search` for creative and message trends.
Audience analysis	Use it for qualitative audience language, objections, and reactions. It does not provide demographic audience breakdowns.	Start with `facebook comments` on representative posts or `facebook groups posts` for community discussion.

目标	使用场景	启动方式
线索生成	用于筛选已知品牌、页面、广告主或社区潜在客户。相较于冷启动挖掘，它更适合资格筛选。	针对已知品牌，从 `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` 开始。

Choose the right command

选择合适的命令

```
scrapesocial facebook profiles get
```
- Use for page/profile metadata.
- Good first step for business pages; add
```
--get-business-hours
```
  when hours matter.
```
scrapesocial facebook profiles posts
```
- Use to collect recent timeline posts from a page or profile.
- Good for content audits, engagement review, and finding post URLs to inspect further.
```
scrapesocial facebook profiles reels
```
- Use to collect a page's reels feed.
- Good for short-form creative research and video content tracking.
```
scrapesocial facebook profiles photos
```
- Use to collect a page's photo feed.
- Good for image creative analysis and gallery extraction.
```
scrapesocial facebook posts get
```
- Use for one post or reel when you need the full object.
- Add
```
--get-comments
```
  or
```
--get-transcript
```
  when you want an initial deep dive in one request.
```
scrapesocial facebook comments
```
- Use to paginate through a post or reel's comments.
- Prefer
```
--feedback-id
```
  when available; get it from
```
facebook posts get
```
  .
```
scrapesocial facebook transcript
```
- Use when you only need the transcript for a post and do not need the rest of the post payload.
```
scrapesocial facebook groups posts
```
- Use to pull posts from a Facebook group.
- Good for community monitoring, topic discovery, and trend spotting.
```
scrapesocial facebook ads search
```
- Use to search the Meta Ad Library by keyword or theme.
- Best for market scans, messaging research, and finding ads before you know the advertiser.
```
scrapesocial facebook ads companies search
```
- Use to find advertiser identities and page IDs from a company or brand name.
- Best first step when the user says "show me this brand's Facebook ads."
```
scrapesocial facebook ads companies get
```
- Use to list ads for a known advertiser.
- Best when you already have the page ID or have just looked it up.
```
scrapesocial facebook ads get
```
- Use to inspect one specific ad in detail.
- Add
```
--get-transcript
```
  for short video ads when transcript text matters.

```
scrapesocial facebook profiles get
```
- 用于获取页面/主页元数据。
- 是商业页面分析的良好第一步；若需营业时间信息，添加
```
--get-business-hours
```
  参数。
```
scrapesocial facebook profiles posts
```
- 用于收集页面或主页的近期动态帖子。
- 适用于内容审核、互动情况查看，以及查找需要进一步检查的帖子URL。
```
scrapesocial facebook profiles reels
```
- 用于收集页面的短视频（Reel）内容。
- 适用于短视频创意研究和视频内容追踪。
```
scrapesocial facebook profiles photos
```
- 用于收集页面的照片内容。
- 适用于图片创意分析和图库提取。
```
scrapesocial facebook posts get
```
- 当你需要完整的帖子或短视频对象时使用。
- 若想在一次请求中初步深入分析，可添加
```
--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广告库。
- 最适合市场扫描、营销话术研究，以及在不知道广告主的情况下查找广告。
```
scrapesocial facebook ads companies search
```
- 用于通过公司或品牌名称查找广告主身份和页面ID。
- 当用户提出“展示这个品牌的Facebook广告”时，这是最佳第一步。
```
scrapesocial facebook ads companies get
```
- 用于列出已知广告主的广告。
- 当你已获取页面ID或刚刚查询到页面ID时使用最佳。
```
scrapesocial facebook ads get
```
- 用于详细查看特定广告。
- 若短视频广告的转录内容重要，添加
```
--get-transcript
```
  参数。

Common workflows

常见工作流

Page or profile audit

页面或主页审核

Run
```
facebook profiles get
```
to confirm the page and collect top-level metadata.
Run
```
facebook profiles posts
```
for the timeline.
Add
```
facebook profiles reels
```
and
```
facebook profiles photos
```
if the user wants a fuller creative inventory.
Open individual posts with
```
facebook posts get
```
when deeper analysis is needed.

运行
```
facebook profiles get
```
确认页面并收集顶层元数据。
运行
```
facebook profiles posts
```
获取动态内容。
若用户需要更完整的创意资产，添加
```
facebook profiles reels
```
和
```
facebook profiles photos
```
命令。
当需要深入分析时，使用
```
facebook posts get
```
打开单个帖子。

Post investigation

帖子调研

Start with
```
facebook posts get --url ...
```
.
If you need the first comments or transcript immediately, add
```
--get-comments
```
and/or
```
--get-transcript
```
.
If the thread is long, continue with
```
facebook comments
```
, reusing
```
--feedback-id
```
from the post payload when available.

从
```
facebook posts get --url ...
```
开始。
若需立即获取首批评论或转录内容，添加
```
--get-comments
```
和/或
```
--get-transcript
```
参数。
若评论线程较长，继续使用
```
facebook comments
```
命令，优先复用帖子返回结果中的
```
--feedback-id
```
参数。

Group research

群组研究

Use
```
facebook groups posts --url ...
```
.
Adjust
```
--sort-by
```
based on the task:
- ```
TOP_POSTS
```
  for what performs best
- ```
RECENT_ACTIVITY
```
  or
```
CHRONOLOGICAL
```
  for monitoring current discussions
Keep paginating with
```
--cursor
```
until you have enough coverage.

使用
```
facebook groups posts --url ...
```
。
根据任务调整
```
--sort-by
```
参数：
- ```
TOP_POSTS
```
  用于查看表现最佳的内容
- ```
RECENT_ACTIVITY
```
  或
```
CHRONOLOGICAL
```
  用于监测当前讨论
使用
```
--cursor
```
参数持续分页，直到获取足够的内容覆盖范围。

Ad research

广告研究

If you know the message or market but not the advertiser, start with
```
facebook ads search
```
.

If you know the brand, start with

facebook ads companies search

, then move to

facebook ads companies get

Use
```
facebook ads get
```
on standout ads for creative details or transcripts.
Apply filters like country, status, media type, and date range before paginating widely.

若你知道营销话术或目标市场但不知道广告主，从
```
facebook ads search
```
开始。

若你知道品牌，从

facebook ads companies search

开始，之后使用

facebook ads companies get

。

使用
```
facebook ads get
```
查看表现突出的广告的创意细节或转录内容。
在大范围分页前，先应用国家、状态、媒体类型和日期范围等筛选条件。

Working notes

使用注意事项

Many Facebook listing commands return pagination data. Reuse
```
--cursor
```
,
```
--page-id
```
, or
```
--group-id
```
exactly as returned.
```
facebook comments
```
is much faster with
```
--feedback-id
```
than with only a post URL.
```
facebook ads search
```
is best for theme-based discovery.
```
facebook ads companies get
```
is best for advertiser-level collection.
Use
```
--trim
```
on ad commands when you want leaner payloads for downstream processing.

许多Facebook列表命令会返回分页数据。请完全复用返回的
```
--cursor
```
、
```
--page-id
```
或
```
--group-id
```
参数。
使用
```
--feedback-id
```
参数时，
```
facebook comments
```
命令比仅使用帖子URL快得多。
```
facebook ads search
```
最适合基于主题的发现，
```
facebook ads companies get
```
最适合按广告主维度收集内容。
当下游处理需要更精简的数据时，可在广告命令中使用
```
--trim
```
参数。

Minimal examples

极简示例

bash

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

bash

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