From hamel-tools
Fetches Kit (ConvertKit) newsletter broadcasts as JSON via CLI for writing context, style reference, content analysis, or performance review.
npx claudepluginhub hamelsmu/hamel --plugin hamel-toolsThis skill uses the workspace's default tool permissions.
Use the `kit-broadcasts` CLI to fetch newsletters from Kit (ConvertKit). Useful for retrieving past newsletter content as context for writing new newsletters in a consistent style.
Automates ConvertKit (Kit) tasks via Rube MCP (Composio): list/search subscribers, manage tags, broadcasts, and stats. Requires active Kit connection.
Produces email newsletter editions with subject line formulas, section structure, personalization, link placement, growth tactics, sponsorship placement, and engagement optimization. Activates on 'newsletter', 'weekly digest', subscriber growth, or open rates queries.
Guides creation, curation, and growth of email newsletters in 6 formats: curated roundups, story-driven, educational, interviews, data-driven, personal updates. Covers editorial structure, workflows, subject lines, and metrics.
Share bugs, ideas, or general feedback.
Use the kit-broadcasts CLI to fetch newsletters from Kit (ConvertKit). Useful for retrieving past newsletter content as context for writing new newsletters in a consistent style.
# Fetch all broadcasts to stdout (JSON format)
kit-broadcasts
# Save to file
kit-broadcasts -o broadcasts.json
# Verbose mode shows progress
kit-broadcasts -v -o broadcasts.json
# Include all fields (not just simplified data)
kit-broadcasts --full -o broadcasts.json
# Use specific API key
kit-broadcasts --api-key "your-key"
| Argument | Short | Description |
|---|---|---|
--output | -o | Output file path (default: stdout) |
--api-key | -k | Kit API key (or set KIT_API_KEY env var) |
--full | Include all fields, not just subject/preview/content | |
--verbose | -v | Show progress info |
Default (simplified):
[
{
"id": 123,
"subject": "Newsletter Subject",
"preview_text": "Preview text...",
"content": "<html>...</html>",
"created_at": "2024-01-15T10:00:00Z",
"send_at": "2024-01-15T12:00:00Z",
"stats": {"open_rate": 45.2, "click_rate": 3.1}
}
]
Install the hamel package:
pip install hamel
Set environment variable:
export KIT_API_KEY="your-v4-api-key"
Get your V4 API key from Kit Developer Settings. The API key is tied to your Kit account - no separate account ID needed.
Fetch newsletters as writing context:
kit-broadcasts -o newsletters.json
# Use the content field as examples for writing new newsletters
Get recent newsletters for style reference:
kit-broadcasts | jq '.[0:5]' # First 5 (most recent) newsletters
Analyze newsletter performance:
kit-broadcasts -o newsletters.json
# Check stats.open_rate and stats.click_rate to identify best-performing content
Pipe to AI for summarization:
kit-broadcasts | ai-gem "List the main topics covered in these newsletters"