New to Claude Skills? Learn how to install them →

Get Claude Skills
sickn33 on GitHub

Audience Analysis

Free

Extract and analyze social media audience insights.

by sickn3344.7k stars on sickn33/agentic-awesome-skills
1 views
Updated Aug 10, 2026
Get this skill

Free · Opens the source repo

What Audience Analysis does

The Audience Analysis skill leverages Apify Actors to provide in-depth insights into audience demographics, engagement patterns, and behavior across popular social media platforms like Facebook, Instagram, YouTube, and TikTok. By utilizing this skill, users can efficiently gather structured data about their audience, which is crucial for tailoring content and marketing strategies. The skill is designed for developers and data analysts who require a systematic approach to understanding audience dynamics, helping them make data-driven decisions.

To use the Audience Analysis skill, users must follow a structured workflow that begins with identifying the type of audience analysis required. This involves selecting the appropriate Apify Actor based on specific needs, such as scraping follower demographics from Instagram or analyzing engagement behavior on Facebook. Once the Actor is selected, users can fetch its schema dynamically, allowing them to understand the input parameters and output fields available for their analysis.

After setting up the environment, users can run the analysis script, choosing their preferred output format—whether it be a quick answer in chat, a CSV file, or a JSON file. The skill then summarizes the findings, providing key insights into the analyzed audience, including demographic details and engagement metrics. This structured approach ensures that users can efficiently extract valuable insights without getting lost in the complexities of data extraction and analysis.

The Audience Analysis skill is ideal for marketers, social media managers, and data analysts who need to understand their audience better. By providing a clear path to gather and interpret audience data, this skill enables users to enhance their engagement strategies and optimize their content for better reach and effectiveness.

When to use it

Use this skill when you need to extract and analyze audience demographics and engagement patterns from social media platforms.

When not to use it

Avoid this skill if your analysis does not align with the supported platforms or if you require real-time data updates.

What you can build with it

Marketing Campaign Analysis

Use this skill to gather insights about your audience demographics before launching a new marketing campaign.

Content Strategy Development

Analyze engagement patterns to inform your content strategy and improve audience interaction.

Social Media Performance Review

Extract and summarize audience behavior data to evaluate the performance of your social media efforts.

How to install Audience Analysis

View source

1. Install with the skills CLI

npx skills add sickn33/agentic-awesome-skills/apify-audience-analysis --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by sickn33

Audience Analysis

Analyze and understand your audience using Apify Actors to extract follower demographics, engagement patterns, and behavior data from multiple platforms.

When to Use

  • You need audience demographics, engagement patterns, or follower behavior from social platforms.
  • The task is to choose and run Apify Actors for audience analysis across Facebook, Instagram, YouTube, or TikTok.
  • You need structured extraction plus a summarized interpretation of audience findings.

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 NeedActor IDBest For
Facebook follower demographicsapify/facebook-followers-following-scraperFB followers/following lists
Facebook engagement behaviorapify/facebook-likes-scraperFB post likes analysis
Facebook video audienceapify/facebook-reels-scraperFB Reels viewers
Facebook comment analysisapify/facebook-comments-scraperFB post/video comments
Facebook content engagementapify/facebook-posts-scraperFB post engagement metrics
Instagram audience sizingapify/instagram-profile-scraperIG profile demographics
Instagram location-basedapify/instagram-search-scraperIG geo-tagged audience
Instagram tagged networkapify/instagram-tagged-scraperIG tag network analysis
Instagram comprehensiveapify/instagram-scraperFull IG audience data
Instagram API-basedapify/instagram-api-scraperIG API access
Instagram follower countsapify/instagram-followers-count-scraperIG follower tracking
Instagram comment exportapify/export-instagram-comments-postsIG comment bulk export
Instagram comment analysisapify/instagram-comment-scraperIG comment sentiment
YouTube viewer feedbackstreamers/youtube-comments-scraperYT comment analysis
YouTube channel audiencestreamers/youtube-channel-scraperYT channel subscribers
TikTok follower demographicsclockworks/tiktok-followers-scraperTT follower lists
TikTok profile analysisclockworks/tiktok-profile-scraperTT profile demographics
TikTok comment analysisclockworks/tiktok-comments-scraperTT comment engagement

Step 2: Fetch Actor Schema

Fetch the Actor's input schema and details dynamically using mcpc:

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):

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT'

CSV:

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:

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT' \
  --output YYYY-MM-DD_OUTPUT_FILE.json \
  --format json

Step 5: Summarize Findings

After completion, report:

  • Number of audience members/profiles analyzed
  • File location and name
  • Key demographic insights
  • Suggested next steps (deeper analysis, segmentation)

Error Handling

APIFY_TOKEN not found - Ask user to create .env with APIFY_TOKEN=your_token mcpc not found - Ask user to install npm install -g @apify/mcpc Actor not found - Check Actor ID spelling Run FAILED - Ask user to check Apify console link in error output Timeout - Reduce input size or increase --timeout

Limitations

  • Use this skill only when the task clearly matches the scope described above.
  • Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
  • Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

Frequently asked questions about Audience Analysis

Similar skills

Power BI Semantic Modeling

Optimize your Power BI data models with best practices.

Data Context Extractor

Tailor data analysis skills to your company's needs.

Power BI Performance Troubleshooting

Systematic guidance for optimizing Power BI performance.

Power BI Model Design Review

Optimize your Power BI data models with expert reviews.

Power BI DAX Formula Optimizer

Optimize your DAX formulas for better performance and clarity.

Fabric Lakehouse

Optimize your data solutions with Lakehouse best practices.