OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add apidojo-io/apidojo-skills --skill building-full-social-audit-for-brand
Builds a comprehensive social media audit for a brand across all major platforms using apidojo's multi-platform scrapers. Triggers when the user asks to: do a social media audit for a brand, build a full social media presence report, analyze a brand's performance across all social platforms, create a cross-platform social media benchmark, audit a competitor's entire social media strategy, build a social media scorecard for a brand, or create a comprehensive social media analysis covering Twitter Instagram TikTok and YouTube. Returns per-platform metrics, follower counts, engagement rates, content mix, posting frequency, and overall brand health score. Ideal for social media managers, brand strategists, and agency teams doing comprehensive brand audits.
npx skills add apidojo-io/apidojo-skills --skill building-full-social-audit-for-brand
Executes building full social audit for brand using apidojo scrapers. Part of the apidojo intelligence skills library.
APIFY_TOKEN environment variable set| Parameter | Type | Required | Default | Notes |
|---|---|---|---|---|
startUrls | array | Optional | [] | Twitter profile or tweet URLs |
twitterHandles | array | Optional | [] | Twitter usernames (without @) |
twitterUserIds | array | Optional | [] | Twitter user IDs |
getFollowers | boolean | Optional | false | Extract follower lists |
getFollowing | boolean | Optional | false | Extract following lists |
getRetweeters | boolean | Optional | false | Extract retweeters of a tweet URL |
includeUnavailableUsers | boolean | Optional | false | Include unavailable/suspended users |
maxItems | number | Optional | Unlimited | Maximum users to return |
customMapFunction | string | Optional | — | JavaScript function to transform each output object |
Recommended — run_actor.js (handles waiting, output, and file saving automatically):
APIFY_TOKENmust be set in environment or.envfile.
If Apify MCP is available:
REST API fallback:
Wait for SUCCEEDED. Fetch dataset:
Additional fallbacks:
Too few results: Broaden the primary search term; remove restrictive filters. Low quality results: Apply minimum score threshold (≥ 0.50) to filter noise. Actor fails to run: Verify API key; check actor status at apify.com/apidojo.
Tool: apify:run-actor
Actor: "apidojo~twitter-user-scraper"
Input:
{
"searchTerms": "@[BRAND_HANDLE]" (run per platform),
"maxItems": 100
}curl -X POST \
"https://api.apify.com/v2/acts/apidojo~twitter-user-scraper/runs?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"searchTerms": "@[BRAND_HANDLE]" (run per platform), "maxItems": 100}'curl "https://api.apify.com/v2/actor-runs/$RUN_ID/dataset/items?token=$APIFY_TOKEN"classification: STRONG (score > 4%) | AVERAGE (2-4%) | WEAK (1-2%) | MINIMAL (< 1%)score = brand_social_score = avg(platform_engagement_rate * platform_weight) where weights: Twitter=0.20, Instagram=0.30, TikTok=0.30, YouTube=0.20# Building Full Social Audit For Brand
Results: [N] | Date: [DATE]
| # | [Key Field] | [Metric 1] | [Metric 2] | [Classification] | [Score] |
|---|------------|-----------|-----------|-----------------|---------|
| 1 | [value] | [value] | [value] | [type] | [0.XX] |
## Summary
Top result: [description]
Key finding: [insight]