Scan an AgentMail inbox for newsletter signals using configurable keyword campaigns. Extracts matched keywords, context snippets, and company mentions from incoming emails. Use for monitoring accounting industry newsletters for buying signals like acquisitions, migrations, and staffing news.
npx gooseworks install --all # then, in Claude Code, Cursor, or Codex: /gooseworks use the newsletter-monitor skill
Scan an AgentMail inbox for newsletter signals using configurable keyword campaigns. Designed for monitoring accounting industry newsletters for buying signals like acquisitions, Sage Intacct migrations, staffing challenges, and technology adoption.
# Set your API key
export AGENTMAIL_API_KEY="your_key_here"
# Scan inbox with all campaigns (summary view)
python3 skills/newsletter-monitor/scripts/scan_newsletters.py --output summary
# Scan specific campaign, last 7 days
python3 skills/newsletter-monitor/scripts/scan_newsletters.py --campaign acquisitions --days 7 --output summary
# JSON output for downstream processing
python3 skills/newsletter-monitor/scripts/scan_newsletters.py --output json --limit 50pip3 install agentmail python-dotenvKeyword campaigns are defined in config/campaigns.json. Each campaign has a description and a list of keywords for case-insensitive substring matching.
Built-in campaigns:
| Flag | Description | Default |
|---|---|---|
--campaign NAME | Run only a specific campaign | All campaigns |
--days N | Only scan emails from last N days | No limit |
--keywords "a,b,c" | Custom keywords (overrides campaigns) | Use campaigns.json |
--output json|summary | Output format | json |
--inbox ADDRESS | Override inbox address | AGENTMAIL_INBOX env or supergoose@agentmail.to |
--limit N | Max messages to fetch | 100 |
Returns an array of matched messages with:
message_id, from, subject, datematched_campaigns - which campaigns triggeredmatched_keywords - specific keywords foundcontext_snippets - 200-char window around each matchcompanies_mentioned - capitalized multi-word phrases near matchesHuman-readable report showing matched emails grouped by campaign with snippets and detected companies.
When newsletter signals are found, chain to:
message_id, from, subject, dateDiscover rising category conversations, formats, sounds, questions, and creator patterns across social platforms, then separate durable demand signals from short-lived noise.
Turn TikTok, Instagram, YouTube, Facebook, X, LinkedIn, Reddit, or Rumble transcripts into timestamped hooks, claims, objections, proof, calls to action, sponsorship signals, and reusable content atoms. Use directly for transcript analysis or as support for creator, competitor, trend, demand, and repurposing work.
Produce a decision-ready brief of current brand, product, category, and competitor conversations across social platforms, including sentiment drivers, questions, risks, and growth opportunities.