newsletter-events-research

<essential_principles>

How This Skill Works

This skill gathers raw event data from configured sources. It does NOT write newsletter content - use newsletter-events-write for that.

Data Sources

1. Instagram - Via ScrapeCreators API (requires API key)
2. Web Aggregators - Via Firecrawl (requires API key)
3. Facebook Events - Pass event URLs directly (e.g., https://facebook.com/events/123456)

Output

Research produces structured data saved to ~/.config/local-media-tools/data/:

• data/raw/instagram_<handle>.json - Raw API responses
• data/images/instagram/<handle>/ - Downloaded flyer images
• data/events.db - SQLite database with profiles, posts, events, venues

Key Principle