mcpField
N
newsletter-monitor

newsletter-monitor

github.com/gooseworks-aiMarketing & growth1.3k50 installsUpdated 3d ago
Repository

About newsletter-monitor

A command-line skill that scans an AgentMail inbox for configurable keyword matches, intended for monitoring accounting-industry newsletters for business signals. It reports matched messages, keywords, nearby text, and detected company names in JSON or a grouped summary.

Key features

  1. 01Configurable keyword campaigns
  2. 02Campaign and date-range filtering
  3. 03JSON or summary output
  4. 04Matched keywords and context snippets
  5. 05Company-name detection near matches

Use cases

  1. 01Monitoring newsletters for acquisition signals
  2. 02Finding Sage Intacct migration mentions
  3. 03Tracking staffing and technology signals in accounting

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/gooseworks-ai/goose-skills --skill newsletter-monitor

After installing, type/newsletter-monitorin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

skill.meta.json
config/
campaigns.json
scripts/
scan_newsletters.py

Details

From the project README

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

FlagDescriptionDefault
--campaign NAMERun only a specific campaignAll campaigns
--days NOnly scan emails from last N daysNo limit
--keywords "a,b,c"Custom keywords (overrides campaigns)Use campaigns.json
--output json|summaryOutput formatjson
--inbox ADDRESSOverride inbox addressAGENTMAIL_INBOX env or [email protected]
--limit NMax messages to fetch100

Output

JSON mode (default)

Returns an array of matched messages with:

  • message_id, from, subject, date
  • matched_campaigns - which campaigns triggered
  • matched_keywords - specific keywords found
  • context_snippets - 200-char window around each match
  • companies_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

Comments

Markdown supported