| name | keitaro-setup |
| description | Keitaro API connection setup and verification. Configures KEITARO_URL and KEITARO_API_KEY, tests connection, shows tracker status. Use when user says "setup", "connect", "configure keitaro", "API key", or first-time setup.
|
Keitaro Setup
Process
- Ask user for their Keitaro tracker URL (e.g. https://tracker.example.com)
- Ask for API key (found in Account → API keys in Keitaro dashboard)
- Test connection by calling
GET /campaigns via the API helper
- If successful, show tracker status (number of campaigns, domains, etc.)
- Save config for session
Connection Test
Run the API helper to verify connection:
KEITARO_URL="<user-url>" KEITARO_API_KEY="<user-key>" \
python3 ~/.claude/skills/keitaro/scripts/keitaro_api.py test
Expected Output on Success
Connection successful!
Tracker: https://tracker.example.com
Campaigns: 15 active, 3 archived
Domains: 5 active
Offers: 23 active
If Connection Fails
Common issues:
- 401 Unauthorized — wrong API key. Check Account → API keys
- Connection refused — wrong URL or tracker is down
- SSL error — tracker uses self-signed cert or HTTP instead of HTTPS
- 404 — URL path is wrong, ensure no trailing slash
Environment Variables
After successful connection, remind user to set in their shell profile:
export KEITARO_URL="https://tracker.example.com"
export KEITARO_API_KEY="your-api-key-here"
Or in Claude Code settings for persistent use across sessions.
Security Note
- Never display the full API key — show only first 4 and last 4 characters
- Never commit API keys to files
- Recommend using environment variables, not hardcoded values
