Social Insights

Social media analytics and performance tracking. Track engagement, optimal posting times, competitor analysis, AI-powered insights, auto-generated charts, an...

Security Scan

The skill claims multi-platform live analytics but the shipped code only runs a local demo report and the SKILL.md / metadata contain inconsistent environment and capability requirements — this mismatch is suspicious and worth clarifying before use.

Purpose & Capability

The skill advertises real-time analytics across many platforms (Twitter, LinkedIn, Threads, Bluesky, etc.) and auto-generated reports, but the included script (scripts/analyzer.py) only produces static demo reports and only checks for the presence of a single TWITTER_API_KEY env var — it does not implement API calls or platform integrations. The metadata and README claim broad capabilities that the code does not implement, which is an incoherence between claimed purpose and actual capability.

Instruction Scope

SKILL.md instructs users to set multiple API credentials and shows commands/prompts for live analytics, CSV imports, and automatic report delivery, but the runtime instructions do not direct the agent to read unexpected system files or secrets beyond the declared env vars. However the instructions imply behaviors (network API calls, scheduled auto-delivery) that are not present in the provided code — the scope is overstated.

Install Mechanism

There is no install spec (instruction-only skill) and the only code file is a small Python script. Nothing in the package downloads or executes remote code during installation, which is low risk from an install-mechanism standpoint.

Credentials

The skill's metadata and SKILL.md list a number of optional API credentials (Twitter keys/secrets/tokens, LinkedIn token, Threads token, Bluesky handle/password, ANALYTICS_PLATFORMS). The registry-level requirements show no required env vars, and the metadata's env list does not exactly match the env var names referenced in the README (e.g., SKILL.md mentions TWITTER_ACCESS_TOKEN and TWITTER_ACCESS_TOKEN_SECRET which are not present in the metadata section). Because the code never uses these credentials beyond a single existence check, the extensive credential list is disproportionate to the actual implementation and could be used to solicit sensitive tokens unnecessarily.

Persistence & Privilege

The skill is not marked always:true and does not request system-wide config changes. It creates a local data directory when run (SOCIAL_ANALYTICS_DATA_DIR defaulting to .social-analytics), which is reasonable for saving reports. No elevated persistence or cross-skill configuration is requested.

What to consider before installing

This package advertises live, multi-platform social analytics but the included Python script only generates static demo reports and does not call any external APIs. Before installing or supplying credentials: 1) Confirm whether there are additional source files or a newer version that actually implements API integrations; ask the publisher for a homepage or source repository. 2) Do not provide real API keys/tokens until you can review code that uses them and confirm the network endpoints it contacts. 3) If you need to test it, run the script in an isolated environment (sandbox/container) and monitor outbound network activity to see whether it contacts expected platform APIs. 4) Ask the author to fix the metadata mismatches (env var names and documented requirements) and provide documentation for how report delivery and scheduling are performed. These inconsistencies may be benign (unfinished/demo code) but they should be clarified before trusting any sensitive credentials.

Social Analytics 📊

Know what works. Double down on it. AI-powered social media analytics with actionable insights.

Time saved: 3 hours/week reporting → 5 minutes/week review
Result: 3x engagement in 30 days
Reports: Auto-generated weekly/monthly (PNG/PDF)

What It Does

• 📈 Performance Tracking: Real-time monitoring of followers, impressions, engagement rates
• ⏰ Optimal Timing: AI determines best posting times for YOUR audience
• 🏆 Top Content Analysis: Identifies your best performing posts (and why they worked)
• 📊 Competitor Comparison: Benchmark against 3-5 competitors with visual charts
• 💡 AI Recommendations: Specific, actionable improvement suggestions
• 📋 Auto Reports: Weekly/monthly reports delivered automatically (PNG/PDF)
• 📉 Data Visualization: Beautiful charts and graphs for stakeholder presentations
• 🧵 Threads Support (v1.3 NEW): Track Threads post performance and engagement
• 🦋 Bluesky Support (v1.3 NEW): Monitor Bluesky analytics via AT Protocol
• 📈 Trend Prediction: AI-powered growth forecasting (next 30/60/90 days)
• 🎯 Goal Tracking: Set engagement goals and track progress with alerts

Installation

clawhub install social-analytics

Commands

View Weekly Analytics

Show my Twitter analytics for last week

View Monthly Report

Generate social media report for last month

Competitor Analysis

Compare my engagement with @competitor1 and @competitor2

Best Posting Times

When should I post for maximum engagement?

Content Insights

What type of content performs best for my audience?

Trend Analysis

Show my follower growth trend for the last 30 days

Configuration

Environment Variables

# Twitter API credentials (for Twitter analytics)
export TWITTER_API_KEY="your_key"
export TWITTER_API_SECRET="your_secret"
export TWITTER_ACCESS_TOKEN="your_token"
export TWITTER_ACCESS_TOKEN_SECRET="your_token_secret"

# LinkedIn API (optional)
export LINKEDIN_ACCESS_TOKEN="your_token"

# Platforms to analyze
export ANALYTICS_PLATFORMS="twitter"  # twitter, linkedin, or all

Without API Access

If you don't have API access, the skill can still:

• Analyze manually provided data
• Generate reports from exported CSV files
• Provide optimization recommendations

Output Examples

Weekly Report

📊 Social Media Weekly Report
Week of Mar 1-7, 2026

📈 Key Metrics:
• Followers: 1,234 (+56 this week)
• Impressions: 45,678 (+12%)
• Engagement Rate: 3.2% (industry avg: 1.8%)

🏆 Top Performing Posts:
1. "AI automation saves 20hrs/week" - 234 likes, 45 retweets
2. "New skill released!" - 189 likes, 32 retweets
3. "Client results showcase" - 156 likes, 28 retweets

⏰ Best Posting Times:
• Tuesday 10am-12pm
• Thursday 2pm-4pm
• Sunday 7pm-9pm

💡 Recommendations:
• Post more case studies (highest engagement)
• Increase posting frequency on Tuesdays
• Try video content (competitors seeing 2x engagement)

Competitor Comparison

📊 Competitor Analysis Report

Your Account vs Competitors (Last 30 Days)

Metric          You      Comp1    Comp2    Industry Avg
-----------------------------------------------------------------
Engagement Rate 3.2%     2.8%     4.1%     1.8%
Posts/Week      5        7        3        4
Avg Likes       156      134      289      95
Avg Retweets    23       18       45       12
Follower Growth +4.5%    +2.1%    +6.8%    +1.5%

💡 Insights:
• Your engagement rate is 78% above industry average! Great job!
• Comp2 gets more engagement with video content
• You post less frequently than competitors
• Opportunity: Increase posting to 7/week

🎯 Action Items:
1. Add 2 video posts this week
2. Test posting on Wednesday mornings
3. Analyze Comp2's top posts for content ideas

Best Posting Times

⏰ Optimal Posting Times for Your Audience

Based on your last 100 posts:

🥇 Best: Tuesday 10:00-12:00
   Avg Engagement: 4.2%
   Avg Reach: 12,500

🥈 Second: Thursday 14:00-16:00
   Avg Engagement: 3.8%
   Avg Reach: 11,200

🥉 Third: Sunday 19:00-21:00
   Avg Engagement: 3.5%
   Avg Reach: 9,800

❌ Worst: Monday 6:00-8:00
   Avg Engagement: 1.2%
   Avg Reach: 3,200

💡 Recommendation:
Schedule 60% of posts during top 3 time slots for maximum impact.

Integration with Other Skills

rss-to-social

rss-to-social publishes content → social-analytics tracks performance
→ Optimize RSS sources based on engagement

social-media-automator

social-media-automator generates posts → social-analytics measures results
→ Improve content generation based on data

seo-content-pro

seo-content-pro creates articles → social-analytics tracks social shares
→ Identify topics that resonate with audience

Complete data-driven content loop! 🔄

Use Cases

Content Marketers

• Track campaign performance
• Prove ROI to stakeholders
• Optimize content calendar

Solopreneurs

• Understand audience preferences
• Maximize limited posting time
• Compete with larger accounts

Agencies

• Client reporting automation
• Multi-account management
• Benchmark across industries

Social Media Managers

• Data-driven strategy decisions
• Identify trending content types
• Justify budget increases

Pricing Integration

This skill powers LobsterLabs analytics services:

Service	Price	Delivery
Single Analysis	$99	One-time report
Monthly Subscription	$299/month	Weekly reports + insights
Competitor Tracking	$199/month	Up to 5 competitors
Enterprise (10 accounts)	$999/month	Custom dashboards

Bundle Discounts:

• Content Automation + Analytics: Save 20%
• Annual Subscription: Save 15%

Contact: PayPal [e-mail]

Tips for Best Results

1. Connect API Access: Full data requires API credentials
2. Consistent Tracking: Run analytics weekly for trend insights
3. Compare Competitors: Benchmark against 3-5 similar accounts
4. Act on Insights: Implement recommendations within 48 hours
5. Track Changes: Monitor metrics before/after strategy changes

Troubleshooting

No API Access

• Use manual data export from platform
• Upload CSV files for analysis
• Skill will work with provided data

Incomplete Data

• Verify API credentials are correct
• Check API rate limits
• Ensure account is public (for some platforms)

Slow Analysis

• Large date ranges take longer
• Reduce to last 7-30 days for faster results
• Run during off-peak hours

Changelog

1.1.0 (2026-03-09) ⭐

• 📉 NEW: Auto-generated charts and graphs (PNG/PDF export)
• 📈 NEW: AI-powered trend prediction and forecasting
• 🎯 NEW: Goal tracking and milestone alerts
• 📊 NEW: Competitor benchmarking with visual comparison
• 🔄 IMPROVED: Enhanced data visualization
• ⚡ IMPROVED: Faster report generation (50% speedup)
• 📱 IMPROVED: Mobile-friendly report formats

1.0.0 (2026-03-07)

• Initial release
• Twitter analytics integration
• Competitor comparison
• Optimal timing analysis
• AI-powered recommendations
• Automated weekly/monthly reports

---

💖 支持作者

如果你觉得这个技能有用，请考虑打赏支持：

• PayPal: [e-mail]
• 邮箱: [e-mail]

你的支持是我持续改进的动力！