| name | profile-analysis |
| description | Analyze social media profiles using Apify scrapers for Instagram, TikTok, Twitter, LinkedIn, or YouTube. Extract posts, engagement, patterns (hooks, topics, formats, timing). Use when user provides profile URLs (youtube.com, youtu.be, instagram.com, twitter.com, linkedin.com, tiktok.com) or asks to analyze accounts, profiles, channels, videos, or content creators. |
Profile Analysis
Purpose
Analyze social media profiles across all major platforms using Apify's scraper ecosystem to extract patterns, top content, and actionable insights.
Instructions
When user provides a social media profile URL or username:
Detect platform from URL (instagram.com → Instagram, tiktok.com → TikTok, etc.) or user request
Verify correct username using Exa search (CRITICAL STEP)
- Search: "[Person Name] [Platform] profile username"
- Extract exact username from search results
- Example: "Varun Mayya Instagram" → Found @thevarunmayya (not @varunmayya)
- This prevents failed scrapes due to incorrect usernames
Select appropriate Apify actor using search-actors and fetch-actor-details tools. See reference/apify-tools.md for complete actor mapping and tool documentation.
Calculate cost and get approval before scraping. Typical costs: $0.01-0.05 for most profiles. See reference/cost-examples.md for detailed cost calculations.
Execute scraping using call-actor with verified username and appropriate parameters, then retrieve results with get-actor-output.
Analyze patterns in the scraped posts: top performers, hook types, topic clusters, format distribution, posting timing.
Log cost to jarvis-sidecar/memories.md with date, platform, and amount.
Create profile summary showing what works for this account.
If user declines cost: Exit gracefully with clear message.
If apify fails: Suggest manual analysis or retry later.
For complete examples and step-by-step flows, see: reference/usage-examples.md
Reference Documentation
This Skill includes comprehensive Apify documentation:
reference/apify-tools.md- Complete tool reference (search-actors, call-actor, get-actor-output) with platform mappingreference/usage-examples.md- 5 real-world examples with actual flows and responsesreference/cost-examples.md- Cost calculation formulas, budget tracking, optimization strategiesreference/workflow-integration.md- Integration with analyze-profile, learn-voice, competitive-analysis workflows
For complete workflow orchestration, see:
bmad/agents/content-intelligence/jarvis-sidecar/workflows/analyze-profile/instructions.md
Example
User provides: "Analyze Varun Mayya's Instagram"
You:
- Search with Exa: "Varun Mayya Instagram profile username"
- Find correct username: @thevarunmayya (not @varunmayya)
- Detect Instagram → Select
apify/instagram-scraper✅ VERIFIED - Estimate $0.05 (20 posts) → Get approval
- Scrape 20 posts with verified username
- Analyze patterns → Create summary → Log cost
For spoken transcript (voice learning):
- Use
sian.agency/instagram-ai-transcript-extractoron specific reels - Cost: $0.025 per reel
See reference/usage-examples.md Example 1 for complete flow. See reference/apify-tools.md for all verified actors.