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.
View on GitHubplugins/hamel-tools/skills/kit/SKILL.md
January 21, 2026
Select agents to install to:
npx add-skill https://github.com/hamelsmu/hamel/blob/main/plugins/hamel-tools/skills/kit/SKILL.md -a claude-code --skill kitInstallation paths:
.claude/skills/kit/# 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
```bash
# 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):
```json
[
{
"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
1. **Install the hamel package:**
```bash
pip install hamel
```
2. **Set environment variable:**
```bash
export KIT_API_KEY="your-v4-api-key"
```
Get your V4 API key from [Kit Developer Settings](https://app.kit.com/account_settings/developer_settings). The API key is tied to your Kit account - no separate account ID needed.
## Examples
**Fetch newsletters as writing context:**
```bash
kit-broadcasts -o newsletters.json
# Use the content field as examples for writing new newsletters
```
**Get recent newsletters for style reference:**
```bash
kit-broadcasts | jq '.[0:5]' # First 5 (most recent) newsletters
```
**Analyze newsletter performance:**
```bash
kit-broadcasts -o newsletters.json
# Check stats.open_rate and stats.click_rate to