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

Topic	File
Setup process	setup.md
Memory template	memory-template.md

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% |

6. Scheduled Monitoring

For ongoing tracking, use cron. Default schedules: - Critical entities: Daily at 09:00 - Regular entities: Every 3 days - Background entities: Weekly

Store schedule in memory.md. Deliver reports to user's preferred channel.

7. Save Everything

After each analysis: 1. Update entity file with new data 2. Compare to previous analysis 3. Note trend changes 4. Archive raw findings

Common Traps

• Single-source analysis → Completely skewed view. Reddit hates everything, Twitter loves drama. Always cross-reference.
• No time window → "Sentiment is positive" means nothing without dates. A product can be loved one week, hated the next.
• Vanity metrics → High volume ≠ positive sentiment. 1000 mentions with 80% negative is worse than 100 mentions with 60% positive.
• Ignoring context → A spike in "crypto X is dead" might be sarcasm or memes. Read actual posts, not just keyword counts.
• Alert fatigue → Alerting on every fluctuation makes users ignore alerts. Only signal meaningful changes.

External Endpoints

Endpoint	Data Sent	Purpose
Search engines (via web_search)	Query text	Find mentions
Social platforms (via web_fetch)	URL requests	Read content

No API keys required. No data stored externally. All analysis happens locally.

Security & Privacy

Data that leaves your machine: - Search queries sent to web search (query text only) - URL requests to public posts (reading only)

Data that stays local: - All entity tracking in ~/sentiment-analysis/ - Historical sentiment data - Alert configurations

This skill does NOT: - Require accounts on any platform - Store data on external servers - Send personal information anywhere - Access private/protected content

Related Skills

Install with clawhub install <slug> if user confirms: - analytics — web traffic and conversion data - branding — brand strategy and guidelines - monitor — system and service monitoring

Feedback

• If useful: clawhub star sentiment-tracker
• Stay updated: clawhub sync