{"id":"f4600bbf-0e1e-464d-9c7b-3cbbf32f8917","shortId":"6S5CGP","kind":"skill","title":"apify-audience-analysis","tagline":"Understand audience demographics, preferences, behavior patterns, and engagement quality across Facebook, Instagram, YouTube, and TikTok.","description":"# Audience Analysis\n\nAnalyze and understand your audience using Apify Actors to extract follower demographics, engagement patterns, and behavior data from multiple platforms.\n\n## When to Use\n- You need audience demographics, engagement patterns, or follower behavior from social platforms.\n- The task is to choose and run Apify Actors for audience analysis across Facebook, Instagram, YouTube, or TikTok.\n- You need structured extraction plus a summarized interpretation of audience findings.\n\n## Prerequisites\n(No need to check it upfront)\n\n- `.env` file with `APIFY_TOKEN`\n- Node.js 20.6+ (for native `--env-file` support)\n- `mcpc` CLI tool: `npm install -g @apify/mcpc`\n\n## Workflow\n\nCopy this checklist and track progress:\n\n```\nTask Progress:\n- [ ] Step 1: Identify audience analysis type (select Actor)\n- [ ] Step 2: Fetch Actor schema via mcpc\n- [ ] Step 3: Ask user preferences (format, filename)\n- [ ] Step 4: Run the analysis script\n- [ ] Step 5: Summarize findings\n```\n\n### Step 1: Identify Audience Analysis Type\n\nSelect the appropriate Actor based on analysis needs:\n\n| User Need | Actor ID | Best For |\n|-----------|----------|----------|\n| Facebook follower demographics | `apify/facebook-followers-following-scraper` | FB followers/following lists |\n| Facebook engagement behavior | `apify/facebook-likes-scraper` | FB post likes analysis |\n| Facebook video audience | `apify/facebook-reels-scraper` | FB Reels viewers |\n| Facebook comment analysis | `apify/facebook-comments-scraper` | FB post/video comments |\n| Facebook content engagement | `apify/facebook-posts-scraper` | FB post engagement metrics |\n| Instagram audience sizing | `apify/instagram-profile-scraper` | IG profile demographics |\n| Instagram location-based | `apify/instagram-search-scraper` | IG geo-tagged audience |\n| Instagram tagged network | `apify/instagram-tagged-scraper` | IG tag network analysis |\n| Instagram comprehensive | `apify/instagram-scraper` | Full IG audience data |\n| Instagram API-based | `apify/instagram-api-scraper` | IG API access |\n| Instagram follower counts | `apify/instagram-followers-count-scraper` | IG follower tracking |\n| Instagram comment export | `apify/export-instagram-comments-posts` | IG comment bulk export |\n| Instagram comment analysis | `apify/instagram-comment-scraper` | IG comment sentiment |\n| YouTube viewer feedback | `streamers/youtube-comments-scraper` | YT comment analysis |\n| YouTube channel audience | `streamers/youtube-channel-scraper` | YT channel subscribers |\n| TikTok follower demographics | `clockworks/tiktok-followers-scraper` | TT follower lists |\n| TikTok profile analysis | `clockworks/tiktok-profile-scraper` | TT profile demographics |\n| TikTok comment analysis | `clockworks/tiktok-comments-scraper` | TT comment engagement |\n\n### Step 2: Fetch Actor Schema\n\nFetch the Actor's input schema and details dynamically using mcpc:\n\n```bash\nexport $(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\"\n```\n\nReplace `ACTOR_ID` with the selected Actor (e.g., `apify/facebook-followers-following-scraper`).\n\nThis returns:\n- Actor description and README\n- Required and optional input parameters\n- Output fields (if available)\n\n### Step 3: Ask User Preferences\n\nBefore running, ask:\n1. **Output format**:\n   - **Quick answer** - Display top few results in chat (no file saved)\n   - **CSV** - Full export with all fields\n   - **JSON** - Full export in JSON format\n2. **Number of results**: Based on character of use case\n\n### Step 4: Run the Script\n\n**Quick answer (display in chat, no file):**\n```bash\nnode --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \\\n  --actor \"ACTOR_ID\" \\\n  --input 'JSON_INPUT'\n```\n\n**CSV:**\n```bash\nnode --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \\\n  --actor \"ACTOR_ID\" \\\n  --input 'JSON_INPUT' \\\n  --output YYYY-MM-DD_OUTPUT_FILE.csv \\\n  --format csv\n```\n\n**JSON:**\n```bash\nnode --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \\\n  --actor \"ACTOR_ID\" \\\n  --input 'JSON_INPUT' \\\n  --output YYYY-MM-DD_OUTPUT_FILE.json \\\n  --format json\n```\n\n### Step 5: Summarize Findings\n\nAfter completion, report:\n- Number of audience members/profiles analyzed\n- File location and name\n- Key demographic insights\n- Suggested next steps (deeper analysis, segmentation)\n\n## Error Handling\n\n`APIFY_TOKEN not found` - Ask user to create `.env` with `APIFY_TOKEN=your_token`\n`mcpc not found` - Ask user to install `npm install -g @apify/mcpc`\n`Actor not found` - Check Actor ID spelling\n`Run FAILED` - Ask user to check Apify console link in error output\n`Timeout` - Reduce input size or increase `--timeout`\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["apify","audience","analysis","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding"],"capabilities":["skill","source-sickn33","skill-apify-audience-analysis","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/apify-audience-analysis","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34964 github stars · SKILL.md body (5,069 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-25T00:50:27.313Z","embedding":null,"createdAt":"2026-04-18T21:31:13.940Z","updatedAt":"2026-04-25T00:50:27.313Z","lastSeenAt":"2026-04-25T00:50:27.313Z","tsv":"'/reference/scripts/run_actor.js':441,458,479 '1':123,155,384 '2':131,309,410 '20.6':99 '3':138,377 '4':145,421 '5':151,491 'access':250 'across':14,69 'actor':29,65,129,133,163,170,311,315,344,346,347,353,358,363,442,443,459,460,480,481,542,546 'analysi':4,21,68,126,148,158,166,188,198,235,268,279,296,303,513 'analyz':22,501 'answer':388,426 'api':245,249 'api-bas':244 'apifi':2,28,64,96,327,337,517,527,555 'apify-audience-analysi':1 'apify/export-instagram-comments-posts':261 'apify/facebook-comments-scraper':199 'apify/facebook-followers-following-scraper':177,360 'apify/facebook-likes-scraper':184 'apify/facebook-posts-scraper':206 'apify/facebook-reels-scraper':192 'apify/instagram-api-scraper':247 'apify/instagram-comment-scraper':269 'apify/instagram-followers-count-scraper':254 'apify/instagram-profile-scraper':214 'apify/instagram-scraper':238 'apify/instagram-search-scraper':222 'apify/instagram-tagged-scraper':231 'apify/mcpc':112,541 'appropri':162 'ask':139,378,383,521,534,551,601 'audienc':3,6,20,26,47,67,84,125,157,191,212,227,241,282,499 'author':335 'avail':375 'base':164,221,246,414 'bash':324,432,449,470 'bearer':336 'behavior':9,37,53,183 'best':172 'boundari':609 'bulk':264 'call':341 'case':419 'channel':281,285 'charact':416 'chat':394,429 'check':90,545,554 'checklist':116 'choos':61 'clarif':603 'claud':438,455,476 'clear':576 'cli':107 'clockworks/tiktok-comments-scraper':304 'clockworks/tiktok-followers-scraper':290 'clockworks/tiktok-profile-scraper':297 'comment':197,202,259,263,267,271,278,302,306 'complet':495 'comprehens':237 'consol':556 'content':204,351 'copi':114 'count':253 'creat':524 'criteria':612 'csv':398,448,468 'data':38,242 'deeper':512 'demograph':7,33,48,176,217,289,300,507 'describ':580 'descript':364 'detail':320,345 'display':389,427 'dynam':321 'e.g':359 'engag':12,34,49,182,205,209,307 'env':93,103,329,435,437,452,454,473,475,525 'env-fil':102,434,451,472 'environ':592 'environment-specif':591 'error':515,559 'expert':597 'export':260,265,325,400,406 'extract':31,78 'facebook':15,70,174,181,189,196,203 'fail':550 'fb':178,185,193,200,207 'feedback':275 'fetch':132,310,313,343 'fetch-actor-detail':342 'field':373,403 'file':94,104,396,431,436,453,474,502 'filenam':143 'find':85,153,493 'follow':32,52,175,252,256,288,292 'followers/following':179 'format':142,386,409,467,488 'found':520,533,544 'full':239,399,405 'g':111,540 'geo':225 'geo-tag':224 'grep':326 'handl':516 'header':334 'id':171,348,354,444,461,482,547 'identifi':124,156 'ig':215,223,232,240,248,255,262,270 'increas':566 'input':317,370,445,447,462,464,483,485,563,606 'insight':508 'instagram':16,71,211,218,228,236,243,251,258,266 'instal':110,537,539 'interpret':82 'jq':349 'json':332,404,408,446,463,469,484,489 'key':506 'like':187 'limit':568 'link':557 'list':180,293 'locat':220,503 'location-bas':219 'match':577 'mcp.apify.com':333 'mcpc':106,136,323,331,531 'members/profiles':500 'metric':210 'miss':614 'multipl':40 'name':505 'nativ':101 'need':46,76,88,167,169 'network':230,234 'next':510 'node':433,450,471 'node.js':98 'npm':109,538 'number':411,497 'option':369 'output':372,385,465,486,560,586 'paramet':371 'pattern':10,35,50 'permiss':607 'platform':41,56 'plugin':439,456,477 'plus':79 'post':186,208 'post/video':201 'prefer':8,141,380 'prerequisit':86 'profil':216,295,299 'progress':119,121 'qualiti':13 'quick':387,425 'r':350 'readm':366 'reduc':562 'reel':194 'replac':352 'report':496 'requir':367,605 'result':392,413 'return':362 'review':598 'root':440,457,478 'run':63,146,382,422,549 'safeti':608 'save':397 'schema':134,312,318 'scope':579 'script':149,424 'segment':514 'select':128,160,357 'sentiment':272 'size':213,564 'skill':571 'skill-apify-audience-analysis' 'social':55 'source-sickn33' 'specif':593 'spell':548 'step':122,130,137,144,150,154,308,376,420,490,511 'stop':599 'streamers/youtube-channel-scraper':283 'streamers/youtube-comments-scraper':276 'structur':77 'subscrib':286 'substitut':589 'success':611 'suggest':509 'summar':81,152,492 'support':105 'tag':226,229,233 'task':58,120,575 'test':595 'tiktok':19,74,287,294,301 'timeout':561,567 'token':97,328,338,518,528,530 'tool':108,340 'tools-cal':339 'top':390 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'track':118,257 'treat':584 'tt':291,298,305 'type':127,159 'understand':5,24 'upfront':92 'use':27,44,322,418,569 'user':140,168,379,522,535,552 'valid':594 'via':135 'video':190 'viewer':195,274 'workflow':113 'xarg':330 'youtub':17,72,273,280 'yt':277,284 'yyyy-mm-dd_output_file.csv':466 'yyyy-mm-dd_output_file.json':487","prices":[{"id":"9c9ab258-bd7e-4308-ad17-4f259ed7959c","listingId":"f4600bbf-0e1e-464d-9c7b-3cbbf32f8917","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:31:13.940Z"}],"sources":[{"listingId":"f4600bbf-0e1e-464d-9c7b-3cbbf32f8917","source":"github","sourceId":"sickn33/antigravity-awesome-skills/apify-audience-analysis","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-audience-analysis","isPrimary":false,"firstSeenAt":"2026-04-18T21:31:13.940Z","lastSeenAt":"2026-04-25T00:50:27.313Z"}],"details":{"listingId":"f4600bbf-0e1e-464d-9c7b-3cbbf32f8917","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"apify-audience-analysis","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34964,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-24T06:41:17Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"782d32bc27ba9d149631b00b2b4b5e67eff4b244","skill_md_path":"skills/apify-audience-analysis/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/apify-audience-analysis"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"apify-audience-analysis","description":"Understand audience demographics, preferences, behavior patterns, and engagement quality across Facebook, Instagram, YouTube, and TikTok."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/apify-audience-analysis"},"updatedAt":"2026-04-25T00:50:27.313Z"}}