Manage your Keitaro tracker with natural language. Create campaigns, optimize flows, generate landings, analyze performance — all through Claude Code. Built for affiliate marketers and media buyers.
Talk to your Keitaro tracker like a human:
You: create campaign for gambling, GEO Germany, 3 landings
Claude: Created campaign "gambling_de_20260327" with 3 flows...
You: what's losing money?
Claude: Campaign #21 "dating_us" — ROI -56%, burning $45/day. Kill it?
You: optimize all campaigns
Claude: Found 5 flows to kill (saving $85/day), 3 to scale (+$45/day). Apply?
You: setup cloaking for campaign 12
Claude: Created default flow (white page) + offer flow with GEO/referrer filters. Done.
curl -fsSL https://raw.githubusercontent.com/iso73-ops/claude-keitaro/main/install.sh | bashirm https://raw.githubusercontent.com/iso73-ops/claude-keitaro/main/install.ps1 | iexgit clone https://github.com/iso73-ops/claude-keitaro.git
cd claude-keitaro
./install.sh- Set environment variables:
export KEITARO_URL="https://your-tracker.com"
export KEITARO_API_KEY="your-api-key"- Start Claude Code and verify:
claude
/keitaro setup| Command | Description |
|---|---|
/keitaro setup |
Connect to Keitaro API, verify access, show tracker status |
/keitaro campaigns |
Create, list, update, disable, enable, clone, delete campaigns |
/keitaro flows |
Manage flows, weights, filters, A/B tests, cloaking patterns |
/keitaro reports |
Analytics by campaign, flow, landing, offer, GEO, device, time |
/keitaro optimize |
Auto-optimize: kill losers, scale winners, rebalance weights |
/keitaro landing |
Generate landing/prelanding/white page content for any vertical |
/keitaro audit |
Health check: 35 checks across campaigns, flows, postbacks, domains |
All verticals with built-in benchmarks (ROI/CR/EPC thresholds, typical payouts, top GEOs):
| Vertical | Key Metrics | Typical Payouts |
|---|---|---|
| Gambling / Casino / Betting | FTD, CPA per FTD | $50-200 CPA, 25-45% RevShare |
| Crypto / Trading / Forex | CPL, FTD deposit | $200-1000 CPA |
| Nutra / Health & Beauty | Sale CR, approve rate | $15-80 CPA (COD/SS) |
| Dating / Adult | SOI/DOI reg rate | $2-60 per action |
| Finance / Loans / Insurance | CPL, approval rate | $10-300 CPL |
| Sweepstakes / Leadgen | SOI/DOI/CC submit | $0.50-25 per action |
| E-commerce / Dropshipping | ROAS, AOV, purchase CR | Varies |
| Medical / Health Clinics | CPL, lead quality | $50-500 per lead |
| Software / Apps / Utilities | Install rate, trial-to-paid | $0.50-80 per action |
Unlike tools that work with exports and screenshots, Claude Keitaro connects directly to your tracker via the Admin API. Supports Admin API v1 + Click API v3.
Full CRUD operations:
- Campaigns (create, list, get, update, disable, enable, clone, delete, costs)
- Streams/Flows (create, update, disable, enable, clone, restore)
- Landing Pages (create, list, update, clone, upload files, download)
- Offers (create, list, update, clone, with payout config)
- Domains (list, check DNS/SSL status, register via Namecheap)
- Affiliate Networks, Traffic Sources, Groups
- Reports, Click Log, Conversion Log
- Bot List management
- Facebook Integration
| Category | Checks | Key Areas |
|---|---|---|
| Campaign Health | 10 | Active flows, default flow, traffic source, domain, costs |
| Flow Health | 10 | Landing/offer assigned, filter logic, weights, traffic |
| Postback & Tracking | 8 | Postback URL, macros, conversion matching, S2S vs pixel |
| Domain Health | 4 | DNS, SSL, blocking, age |
| Landing Health | 3 | Accessibility, load time, tracking pixel |
Weighted scoring (Critical 15pts, High 8pts, Medium 4pts, Low 2pts) with letter grades A-F.
- Kill rules: auto-detect flows with ROI below vertical threshold (e.g., < -30% on 100+ clicks)
- Scale rules: identify flows with strong ROI for weight increase
- Minimum sample sizes: prevents premature decisions (100-400 clicks depending on vertical)
- A/B test logic: 95% confidence before declaring winner
- Day-parting awareness: doesn't kill campaigns based on 1 bad day
Pre-built patterns ready to deploy:
| Pattern | Use Case |
|---|---|
| White + Offer (Cloaking) | Facebook, Google, TikTok campaigns |
| A/B Test Landings | Testing multiple landings with equal/weighted split |
| GEO Split | Different offers/landings per country |
| Device/OS Split | iOS vs Android vs Desktop routing |
| Offer Rotation | Testing multiple networks/payouts |
| Time-Based Routing | Day-parting by vertical (gambling: night, B2B: business hours) |
| Sub-ID Routing | Message match between ad creative and landing |
| Funnel (Pre > Land > Offer) | Multi-step warmup flow |
Generate content in any language for any vertical:
- Prelandings: advertorials, quiz funnels, review pages, success stories
- Landings: product pages, registration forms, bonus pages
- White pages: safe blog articles for moderation (cooking, travel, tech)
Follows vertical-specific templates with required compliance elements.
4 levels of protection to prevent breaking live traffic:
| Level | What It Does | How It Works |
|---|---|---|
| Dry Run | Preview without executing | --dry-run flag blocks all writes, shows payload |
| Auto Snapshots | Save state before changes | JSON backup to ~/.claude/keitaro-snapshots/ |
| Traffic Detection | Warn about live campaigns | Checks last 24h clicks/cost before modification |
| Last-Flow Guard | Block killing all traffic | Prevents disabling the only active flow (requires --force) |
# Always safe — see what would happen without doing it
python3 keitaro_api.py --dry-run campaign disable --id 12
# Output:
# [DRY RUN] Would execute: POST /campaigns/12/disable
# [SAFETY] WARNING: Campaign #12 has LIVE TRAFFIC!
# [SAFETY] Last 24h: 5,432 clicks, $271.60 spent~/.claude/skills/keitaro/ # Main orchestrator + references + API helper
~/.claude/skills/keitaro/references/ # 5 reference files
keitaro-api.md # Full Admin API + Click API v3 reference
verticals.md # Benchmarks by vertical (9 verticals)
optimization-rules.md # Kill/scale/A/B test decision logic
landing-specs.md # Landing templates by vertical
flow-patterns.md # 8 flow patterns with examples
~/.claude/skills/keitaro/scripts/
keitaro_api.py # Python API helper (548 lines)
~/.claude/skills/keitaro-*/ # 7 sub-skills
keitaro-setup/ # API connection & verification
keitaro-campaigns/ # Campaign CRUD
keitaro-flows/ # Flow/stream management
keitaro-reports/ # Analytics & reporting
keitaro-optimize/ # Auto-optimization engine
keitaro-landing/ # Landing page generation
keitaro-audit/ # 35-check health audit
~/.claude/agents/ # 3 subagents
campaign-analyzer.md # Campaign performance analysis
flow-optimizer.md # Flow health & optimization
landing-generator.md # Landing content generation
- Orchestrator (
/keitaro) routes commands to specialized sub-skills - Sub-skills handle specific domains (campaigns, flows, reports, etc.)
- Agents run in parallel for audits and bulk analysis
- References load on-demand (RAG pattern) — only what's needed per operation
- API helper (
keitaro_api.py) handles all Keitaro API calls with built-in safety - Snapshots auto-saved before any destructive operation
The Python helper can also be used standalone:
# Test connection
python3 keitaro_api.py test
# List campaigns
python3 keitaro_api.py campaigns
# Create campaign
python3 keitaro_api.py campaign create --name "gambling_de" --alias "gamb-de-1" \
--type weight --cost-type CPC --cost-value 0.05
# Get campaign flows
python3 keitaro_api.py streams --campaign-id 12
# Build report
python3 keitaro_api.py report --grouping campaign_id --range 7d \
--metrics clicks,conversions,revenue,cost,profit,roi,cr,epc
# Dry run (safe preview)
python3 keitaro_api.py --dry-run stream disable --id 45- Claude Code CLI
- Python 3.10+ with
requestspackage - Keitaro tracker with Admin API access (API key from Account > API keys)
curl -fsSL https://raw.githubusercontent.com/iso73-ops/claude-keitaro/main/uninstall.sh | bashMIT License - see LICENSE for details.
Built for Claude Code by @iso73-ops