newsletter-events

Local Media Tools

▶️ Watch: I Made a Claude Code Plugin to Automate Local Media

A Claude Code plugin for scraping local events from Instagram and web sources, with support for ad-hoc Facebook event URLs.

Created by Aniket Panjwani

💡 Non-technical? Book a consultation for guided setup. You'll leave ready to scrape events from any Instagram profile or webpage yourself.

What It Does

Create hyper-local event newsletters by aggregating events from:

• Instagram - Public profiles via ScrapeCreators API
• Facebook - Direct event URLs (pass to /research command)
• Web Aggregators - Event listing websites via Firecrawl

Events are deduplicated, stored in SQLite, and formatted according to your preferences.

Quick Start

/plugin marketplace add aniketpanjwani/local_media_tools
/plugin install newsletter-events
/newsletter-events:setup

Then:

1. Add API keys to ~/.config/local-media-tools/.env
2. Add sources: /newsletter-events:add-source
3. Scrape events: /newsletter-events:research
4. Generate newsletter: /newsletter-events:write

Full Getting Started Guide

Documentation

Guide	Description
Getting Started	First newsletter in 10 minutes
Configuration	Source setup and API keys
Commands	Complete command reference
Troubleshooting	Common issues and solutions

Platform Guides

Instagram	Facebook	Web Aggregators

For Developers

Architecture	Development	Changelog

Requirements

• Python 3.12+ with uv
• bun (for Facebook event scraping)
• Claude Code
• API keys: ScrapeCreators (Instagram) or Firecrawl (web)

Output

• Database: ~/.config/local-media-tools/data/events.db
• Newsletters: newsletter_YYYY-MM-DD.md in current directory

Maintenance

Old plugin versions accumulate in ~/.claude/plugins/cache/ (~30-40MB each). To clean up:

# Remove all old versions, keep only current (check version in plugin.json first)
ls ~/.claude/plugins/cache/local-media-tools/newsletter-events/ | grep -v "CURRENT_VERSION" | xargs -I {} rm -rf ~/.claude/plugins/cache/local-media-tools/newsletter-events/{}

Support

• Issues: GitHub Issues
• Email: aniket@contentquant.io
• YouTube: @aniketapanjwani
• Consultation: Book a guided setup session

Author

Aniket Panjwani, PhD - Building AI solutions for small businesses. Schedule a Growth Mapping Call.

License

MIT