skillatlas Scrapesocial Facebook
Use this skill for Facebook research and analysis tasks. It maps the user's goal to the right scrapesocial Facebook command.
Prerequisites
- A Scrape Creators API key is required for this skill. Get one at scrapecreators.com.
Quick start
- Install the CLI once:
npm install -g scrapesocial
- Ensure authentication is available through
SCRAPECREATORS_API_KEYor--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.
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. |
Choose the right command
scrapesocial facebook profiles get- Use for page/profile metadata.
- Good first step for business pages; add
--get-business-hourswhen 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-commentsor--get-transcriptwhen you want an initial deep dive in one request.
scrapesocial facebook comments- Use to paginate through a post or reel's comments.
- Prefer
--feedback-idwhen available; get it fromfacebook 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-transcriptfor short video ads when transcript text matters.
Common workflows
Page or profile audit
- Run
facebook profiles getto confirm the page and collect top-level metadata. - Run
facebook profiles postsfor the timeline. - Add
facebook profiles reelsandfacebook profiles photosif the user wants a fuller creative inventory. - Open individual posts with
facebook posts getwhen deeper analysis is needed.
Post investigation
- Start with
facebook posts get --url .... - If you need the first comments or transcript immediately, add
--get-commentsand/or--get-transcript. - If the thread is long, continue with
facebook comments, reusing--feedback-idfrom the post payload when available.
Group research
- Use
facebook groups posts --url .... - Adjust
--sort-bybased on the task:TOP_POSTSfor what performs bestRECENT_ACTIVITYorCHRONOLOGICALfor monitoring current discussions
- Keep paginating with
--cursoruntil you have enough coverage.
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 tofacebook ads companies get. - Use
facebook ads geton standout ads for creative details or transcripts. - Apply filters like country, status, media type, and date range before paginating widely.
Working notes
- Many Facebook listing commands return pagination data. Reuse
--cursor,--page-id, or--group-idexactly as returned. facebook commentsis much faster with--feedback-idthan with only a post URL.facebook ads searchis best for theme-based discovery.facebook ads companies getis best for advertiser-level collection.- Use
--trimon ad commands when you want leaner payloads for downstream processing.
Minimal examples
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