kit
Fetch Kit (ConvertKit) newsletter broadcasts for writing context. Use when asked to download newsletters, get past email content for style reference, or fetch broadcasts for analysis.
When & Why to Use This Skill
The Kit Broadcasts Fetcher is a specialized Claude skill designed to bridge the gap between your Kit (formerly ConvertKit) newsletter history and AI-driven content creation. It allows users to programmatically retrieve past broadcasts, including subject lines, content, and performance metrics, providing a rich data source for maintaining brand voice consistency and performing deep analysis of email marketing efforts.
Use Cases
- Brand Voice Consistency: Fetch historical newsletters to provide Claude with specific examples of your writing style, ensuring newly generated drafts align perfectly with your established brand persona.
- Performance-Driven Content Strategy: Retrieve broadcast statistics like open and click rates to identify high-performing topics and use them as a foundation for planning future content briefs.
- Automated Content Repurposing: Extract newsletter content to quickly transform successful email campaigns into social media posts, blog articles, or video scripts using AI summarization.
- Contextual Drafting: Provide the AI with a comprehensive history of recent communications to ensure continuity in messaging and avoid repeating topics in upcoming newsletter sequences.
| name | kit |
|---|---|
| description | Fetch Kit (ConvertKit) newsletter broadcasts for writing context. Use when asked to download newsletters, get past email content for style reference, or fetch broadcasts for analysis. |
Kit Broadcasts Fetcher
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.
Usage
# 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"
Arguments
| 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 |
Output Format
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}
}
]
Requirements
Install the hamel package:
pip install hamelSet 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.
Examples
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"