// 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.
| 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. |
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"
Manage your YouTube channel — upload, list, edit metadata, schedule/unschedule videos, set thumbnails, download your own private videos, get transcripts, generate AI chapter summaries, and post comments (with a Chrome-automation playbook for pinning). Use when asked to upload to YouTube, schedule a video, edit video metadata, download a private YouTube video, get a transcript, generate chapters, or post/pin a comment.
Unified X (Twitter) CLI — fetch follows, diff snapshots, get likes/bookmarks, fetch latest posts, and take screenshots. Uses the official X API v2 with Bearer Token and OAuth 2.0 user-context auth.
Create annotated blog posts from technical talks with slides. Use when asked to convert a video presentation to a blog post, create written content from a talk, or annotate slides with transcript.
Multimodal AI processing and image generation using Google Gemini. Use for analyzing PDFs, images, videos, YouTube links, and other large documents. Also generates images with Nano Banana Pro. Ideal when you need to extract information from files that require vision or multimodal understanding, or generate images from text prompts.