social-insights

# Social Analytics 📊

Track, analyze, and optimize your social media performance with AI-powered insights.

## What It Does

- 📈 **Performance Tracking**: Monitor followers, impressions, engagement rates
- ⏰ **Optimal Timing**: Find best posting times for your audience
- 🏆 **Top Content Analysis**: Identify your best performing posts
- 📊 **Competitor Comparison**: Benchmark against competitors
- 💡 **AI Recommendations**: Get actionable improvement suggestions
- 📋 **Auto Reports**: Weekly/monthly reports delivered automatically

## Installation

```bash
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

```bash
# 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/w...