Apify Audience Analysis
Pull real follower, engagement, and comment signals from major social platforms with Apify Actors so you can size and profile an audience before or while you grow.
Overview
Apify Audience Analysis is an agent skill most often used in Idea (also Validate scope, Grow analytics) that runs Apify social scrapers to extract audience demographics, engagement, and behavior signals.
Install
npx skills add https://github.com/apify/agent-skills --skill apify-audience-analysisWhat is this skill?
- 5-step workflow checklist: pick analysis type, fetch Actor schema, user preferences, run script, summarize findings
- Maps user needs to specific Apify Actor IDs across Facebook, Instagram, YouTube, and TikTok
- Uses mcpc CLI against Apify with native Node --env-file for APIFY_TOKEN
- Covers followers, likes, reels, comments, and post-level engagement scraping paths
- 5-step Task Progress checklist in the workflow
- Actor selection table covering Facebook, Instagram, YouTube, and TikTok use cases
Adoption & trust: 2.5k installs on skills.sh; 2.1k GitHub stars; 1/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need to know who follows, engages, and comments on social content but manual platform insights are thin or platform-locked.
Who is it for?
Indie founders researching ICP and channel fit using Facebook, Instagram, YouTube, or TikTok public data via Apify.
Skip if: Builders without an Apify account/token, use cases requiring only on-product analytics, or workflows that must avoid third-party scraping policies.
When should I use this skill?
Understand audience demographics, preferences, behavior patterns, and engagement quality across Facebook, Instagram, YouTube, and TikTok.
What do I get? / Deliverables
You get structured audience datasets from the chosen Apify Actor plus an agent summary of demographics and engagement patterns you can feed into positioning or content decisions.
- Exported audience datasets from the selected Apify Actor run
- Agent-written summary of demographics, engagement, and behavior findings
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Audience understanding is first shelved under Idea when you are still validating who cares; the same workflows support Grow when tuning content and lifecycle. Demographics, preferences, and engagement quality map directly to idea → audience research, not to shipping code.
Where it fits
Compare Facebook follower lists and Instagram engagement before picking a niche for your SaaS.
Scrape comment themes on competitor Reels to see if your prototype solves a loudly discussed pain.
Re-run post-level engagement Actors after a launch week to see which content attracted quality interactions.
How it compares
Skill-orchestrated Apify Actor runs, not a hosted analytics dashboard or first-party PostHog-style product telemetry.
Common Questions / FAQ
Who is apify-audience-analysis for?
Solo and indie builders doing distribution research who already use or can adopt Apify and want an agent-guided path from question to scraped audience data.
When should I use apify-audience-analysis?
Use it in Idea → audience to profile followers and engagement; in Validate → scope to test niche signals; and in Grow → analytics when revisiting who engages with your social proof and content.
Is apify-audience-analysis safe to install?
It needs network access and your APIFY_TOKEN; review the Security Audits panel on this page and Apify Actor terms before running scrapers on production accounts.
SKILL.md
READMESKILL.md - Apify Audience Analysis
# Audience Analysis Analyze and understand your audience using Apify Actors to extract follower demographics, engagement patterns, and behavior data from multiple platforms. ## Prerequisites (No need to check it upfront) - `.env` file with `APIFY_TOKEN` - Node.js 20.6+ (for native `--env-file` support) - `mcpc` CLI tool: `npm install -g @apify/mcpc` ## Workflow Copy this checklist and track progress: ``` Task Progress: - [ ] Step 1: Identify audience analysis type (select Actor) - [ ] Step 2: Fetch Actor schema via mcpc - [ ] Step 3: Ask user preferences (format, filename) - [ ] Step 4: Run the analysis script - [ ] Step 5: Summarize findings ``` ### Step 1: Identify Audience Analysis Type Select the appropriate Actor based on analysis needs: | User Need | Actor ID | Best For | |-----------|----------|----------| | Facebook follower demographics | `apify/facebook-followers-following-scraper` | FB followers/following lists | | Facebook engagement behavior | `apify/facebook-likes-scraper` | FB post likes analysis | | Facebook video audience | `apify/facebook-reels-scraper` | FB Reels viewers | | Facebook comment analysis | `apify/facebook-comments-scraper` | FB post/video comments | | Facebook content engagement | `apify/facebook-posts-scraper` | FB post engagement metrics | | Instagram audience sizing | `apify/instagram-profile-scraper` | IG profile demographics | | Instagram location-based | `apify/instagram-search-scraper` | IG geo-tagged audience | | Instagram tagged network | `apify/instagram-tagged-scraper` | IG tag network analysis | | Instagram comprehensive | `apify/instagram-scraper` | Full IG audience data | | Instagram API-based | `apify/instagram-api-scraper` | IG API access | | Instagram follower counts | `apify/instagram-followers-count-scraper` | IG follower tracking | | Instagram comment export | `apify/export-instagram-comments-posts` | IG comment bulk export | | Instagram comment analysis | `apify/instagram-comment-scraper` | IG comment sentiment | | YouTube viewer feedback | `streamers/youtube-comments-scraper` | YT comment analysis | | YouTube channel audience | `streamers/youtube-channel-scraper` | YT channel subscribers | | TikTok follower demographics | `clockworks/tiktok-followers-scraper` | TT follower lists | | TikTok profile analysis | `clockworks/tiktok-profile-scraper` | TT profile demographics | | TikTok comment analysis | `clockworks/tiktok-comments-scraper` | TT comment engagement | ### Step 2: Fetch Actor Schema Fetch the Actor's input schema and details dynamically using mcpc: ```bash export $(grep APIFY_TOKEN .env | xargs) && mcpc --json mcp.apify.com --header "Authorization: Bearer $APIFY_TOKEN" tools-call fetch-actor-details actor:="ACTOR_ID" | jq -r ".content" ``` Replace `ACTOR_ID` with the selected Actor (e.g., `apify/facebook-followers-following-scraper`). This returns: - Actor description and README - Required and optional input parameters - Output fields (if available) ### Step 3: Ask User Preferences Before running, ask: 1. **Output format**: - **Quick answer** - Display top few results in chat (no file saved) - **CSV** - Full export with all fields - **JSON** - Full export in JSON format 2. **Number of results**: Based on character of use case ### Step 4: Run the Script **Quick answer (display in chat, no file):** ```bash node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \ --actor "ACTOR_ID" \ --input 'JSON_INPUT' ``` **CSV:** ```bash node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \ --actor "ACTOR_ID" \ --input 'JSON_INPUT' \ --output YYYY-MM-DD_OUTPUT_FILE.csv \ --format csv ``` **JSON:** ```bash node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \ --actor "ACTOR_ID" \ --input 'J