Newsletter monitor
Quick answer
- 01What is it?
- Scan an AgentMail inbox for newsletter signals using configurable keyword campaigns. It stands out by giving email marketing a defined shape, so the agent asks for better context and returns a more usable result.
- 02Inputs
- Context for email marketing: your goals, audience, constraints, and any source material the skill asks for.
- 03Output
- A ready-to-use result for email marketing: the analysis, copy, or recommendations the agent produces.
Add this skill
Install as a package
Installs this one skill package for your coding agent, including any supporting files that skill ships with — not every skill in the repository. Read the tutorial.
$ npx skills add gooseworks-ai/goose-skills --skill newsletter-monitorSkill instructions
The instruction file for this skill. The skill also includes other files you need to install to use it.
Newsletter Monitor
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.
Quick Start
# 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 50
Dependencies
pip3 install agentmail python-dotenv
Configuration
Keyword 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:
- acquisitions - CPA firm M&A activity
- sage_intacct - Sage Intacct migration and implementation signals
- staffing - Accounting talent and staffing challenges
- technology - Accounting technology adoption
CLI Options
| 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 |
Output
JSON mode (default)
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 matches
Summary mode
Human-readable report showing matched emails grouped by campaign with snippets and detected companies.
Downstream Skills
When newsletter signals are found, chain to:
- company-contact-finder - look up contacts at mentioned companies
- accounting-news-monitor - combine with direct news monitoring for fuller signal coverage
Common questions
How do I install Newsletter monitor in Cursor, Claude Code, or Codex?
Run npx skills add gooseworks-ai/goose-skills --skill newsletter-monitor in the project where you want it, then ask your agent for the skill by name. The --skill flag installs only Newsletter monitor, not every skill in the repository.
Where does Newsletter monitor come from and what license is it under?
Newsletter monitor comes from the gooseworks-ai/goose-skills repository on GitHub. That repository has 912 GitHub stars. The skill is published under the MIT license.
Prefer plain text? Read the Newsletter monitor guide as markdown.
Related skills
More from gooseworks-ai