Sentiment Analysis

Track what people say about anything — brands, crypto, products, competitors — across Twitter/X, Reddit, YouTube, Hacker News, and news sites.

One-shot analysis for quick checks. Scheduled monitoring for ongoing tracking. Multi-entity dashboards to compare multiple things at once.

Setup

On first use, read setup.md and follow its guidelines. Data is stored locally in ~/sentiment-analysis/.

When to Use

User wants to know public opinion about something. Could be:

• "What are people saying about [brand]?"
• "How's sentiment on [crypto] right now?"
• "Monitor [product] mentions and alert me on negative spikes"
• "Compare sentiment: [brand A] vs [brand B]"

Architecture

Data lives in ~/sentiment-analysis/. See memory-template.md for setup.

~/sentiment-analysis/
├── memory.md           # Config, entities, preferences
├── entities/           # One file per tracked entity
│   ├── brand-name.md
│   └── crypto-xyz.md
├── reports/            # Generated analysis reports
│   └── YYYY-MM-DD-entity.md
└── alerts.md           # Alert history

Quick Reference

Core Rules

1. Source Diversity Matters

Never rely on a single platform. Each source has bias:

• Twitter/X: Real-time, emotional, viral content
• Reddit: Longer discussions, honest opinions, niche communities
• YouTube: Comments show product experiences
• Hacker News: Tech-focused, skeptical, early adopter views
• News sites: Official narratives, PR-filtered

Use at least 2-3 sources per analysis. Note source distribution in reports.

2. Time Windows Change Everything

Sentiment shifts fast. Always specify and report time window:

• Last 24h: Breaking news, viral events
• Last 7d: Weekly trends, sustained campaigns
• Last 30d: Product launches, seasonal patterns

Default: Last 7 days unless user specifies otherwise.

3. Quantify, Don't Guess

Every report includes concrete metrics:

📊 Entity: [Name]
🕐 Period: [Date range]
📈 Volume: [X mentions found]
😊 Positive: XX% | 😠 Negative: XX% | 😐 Neutral: XX%

Top Themes:
1. [Theme] — XX mentions, XX% negative
2. [Theme] — XX mentions, XX% positive

Notable Posts:
- [Quote] — [Platform, engagement]

4. Alerts Are Specific

Don't alert on every change. Track baselines and alert on:

• Negative spike >20% above baseline
• Viral negative post (>10x normal engagement)
• New negative theme appearing
• Competitor positive spike

5. Multi-Entity Comparison

When tracking multiple entities, always show relative performance:

📊 Sentiment Comparison (Last 7d)

| Entity | Volume | Positive | Negative | Trend |
|--------|--------|----------|----------|-------|
| Brand A | 1,240 | 62% | 18% | ↗️ +5% |
| Brand B | 890 | 45% | 32% | ↘️ -8% |