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's requirements, instructions, and included code are coherent with a local social-media analytics tool (demo mode by default); nothing in the bundle indicates data exfiltration or unrelated privileged access.

Purpose & Capability

The skill is described as social media analytics and includes a Python analyzer script and optional API environment variables — all consistent. Minor inconsistency: metadata requires the binary 'curl' but the provided script is pure Python and does not call curl. The SKILL.md uses the install command 'clawhub install social-analytics' while the skill slug/name is 'social-insights' — this naming mismatch is likely a packaging/documentation oversight, not a security problem.

Instruction Scope

Runtime instructions and examples focus on analytics, reports, and optional use of Twitter/LinkedIn API credentials. The SKILL.md does not instruct reading unrelated system files or transmitting data to unknown endpoints. It does instruct writing to a local data directory (defaults to .social-analytics), which is expected for a reporting tool.

Install Mechanism

There is no install spec (instruction-only), so nothing is downloaded or installed by the skill itself. A small Python script is included; it runs locally and does not fetch remote code. This minimizes install-time risk.

Credentials

No required environment variables are declared in the registry. SKILL.md documents optional API keys/tokens for Twitter and LinkedIn, which are reasonable for the stated functionality. The included analyzer.py only checks for TWITTER_API_KEY and otherwise runs in demo mode; the SKILL.md references additional token env vars (ACCESS_TOKEN, SECRET) that are optional. This is proportionate but slightly inconsistent: the script does not use all documented vars.

Persistence & Privilege

The skill does not request persistent or elevated privileges. always is false and the skill does not attempt to modify other skills or system-wide settings. It writes local files under a hidden directory in the current working directory, which is normal for this class of tool.

Assessment

This skill appears to be a local/demo social analytics tool and is internally consistent. Points to consider before installing or running: 1) The included Python script runs in demo mode unless you provide API credentials — only supply minimum-scoped API tokens you trust. 2) The script creates a local data directory (.social-analytics) and can save reports; make sure you run it from a directory where writing files is acceptable. 3) The package metadata mentions curl but the script does not use it — you can ignore or ask the author whether curl is actually required. 4) There is a minor naming mismatch between 'social-insights' and 'social-analytics' in SKILL.md; treat this as a documentation bug. If you plan to enable real API access, review network calls and token handling in any extended code you add; the included files in this bundle do not perform hidden network requests or credential exfiltration.

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
• 📈 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]

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