Plugin

newsletter-events

Name: newsletter-events
Author: aniketpanjwani

Collect local event listings from Instagram accounts, Facebook pages, and web aggregators by scraping posts and flyer images. Store extracted event data in a local SQLite database and generate Markdown newsletters with configurable formatting preferences.

What's Inside

Slash Commands7

newsletter-events:add-source

/add-source

Add Instagram accounts or web aggregators to sources.yaml (web sources require profiling)

newsletter-events:list-sources

/list-sources

List all configured event sources (Instagram, Facebook, web aggregators)

newsletter-events:remove-source

/remove-source

Remove Instagram accounts, Facebook pages, or web aggregators from sources.yaml

newsletter-events:research

/research

Research and collect events from all configured sources (Instagram, web aggregators, Facebook)

newsletter-events:setup

/setup

Set up or verify Local Media Tools environment (runtimes, dependencies, config)

Agents1

Config Validator Agent

/config-validator

Validates newsletter plugin configuration before research operations. Use proactively before running Facebook Discover or any research workflow that depends on external services.

Skills7

newsletter-events-add-source

/skills/newsletter-events-add-source

Add Instagram accounts or web aggregators to sources.yaml configuration

newsletter-events-list-sources

/skills/newsletter-events-list-sources

List all configured event sources (Instagram, web aggregators)

newsletter-events-remove-source

/skills/newsletter-events-remove-source

Remove Instagram accounts or web aggregators from sources.yaml configuration

newsletter-events-research

/skills/newsletter-events-research

Research events from Instagram, web aggregators, and Facebook event URLs. Use when scraping event sources, downloading flyer images, or extracting event details.

newsletter-events-setup

/skills/newsletter-events-setup

Set up environment for local newsletter events plugin. Use when first installing, updating dependencies, or verifying configuration.

Stats

Version0.17.8

LanguagePython

Stars39

Forks13

MaintenanceExcellent

LicenseMIT

Last CommitDec 26, 2025

AddedDec 19, 2025

Actions

View on GitHub View README Plugin Marketplace JSON

Safety Signals

Caution

Uses power tools

Uses Bash, Write, or Edit tools

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.

Research output showing scraped events

Quick Start

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

Then:

Add API keys to ~/.config/local-media-tools/.env
Add sources: /newsletter-events:add-source
Scrape events: /newsletter-events:research
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: [email protected]
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

newsletter-events

What's Inside

newsletter-events

Popularity

What's Inside

Confidence

README

Local Media Tools

What It Does

Quick Start

Documentation

Platform Guides

For Developers

Requirements

Output

Maintenance

Support

Author

License

Similar Plugins

caveman

ui-design

llm-council-plugin

open-agent-hub

nanobanana

Local Media Tools

What It Does

Quick Start

Documentation

Platform Guides

For Developers

Requirements

Output

Maintenance

Support

Author

License

Popularity

Health & Quality

Similar Plugins

caveman

ui-design

llm-council-plugin

open-agent-hub

nanobanana