tavily-key-generator-proxy
tavily-key-generator-proxy — an installable skill for AI agents.
By reason-machines · 1,373 installs
npx skills add reason-machines/trending-skills --skill tavily-key-generator-proxy
Source repository · Upstream listing
Tavily Key Generator + API Proxy
Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection
Automates bulk Tavily account registration using Playwright + CapSolver (Cloudflare Turnstile), then pools the resulting API keys behind a unified proxy gateway with round robin rotation, usage tracking, token management, and a web console.
What It Does
Component Location Purpose
Key Generator root / Playwright driven headless Firefox registers Tavily accounts, solves Turnstile CAPTCHAs, verifies email, extracts API key
API Proxy proxy/ FastAPI service that round robins requests across pooled keys, exposes /api/search and /api/extract , serves web console at /console
Each free Tavily account yields 1,000 API calls/month . The proxy aggregates quota: 10 keys = 10,000 calls/month via one endpoint.
Installation
Key Generator
API Proxy (Docker — recommended)
Configuration ( config.py )
CAPTCHA Solver (required)
Email Backend (required — pick one)
Option A: Cloudflare Email Worker (self hosted, free)
Option B: DuckMail (third party temporary email)
If both backends are configured, the CLI prompts you to choose at runtime.
Registration Throttle (anti ban)
Auto upload to Proxy (optional)
Running the Key Generator
Generated api keys.md format (used for bulk import into proxy):
API Proxy Usage
Calling the Proxy (drop in Tavily replacement)
Token can also be passed in the request body as api key (Tavily SDK compatible):
Python SDK Integration
Admin API Reference
All admin endpoints require header: X Admin Password: your password
Keys Management
Token Management
Stats
Change Admin Password
Proxy Behavior
Round robin : requests distributed evenly across active keys
Auto disable : key disabled after 3 consecutive failures
Quota tracking : total = active keys × 1,000/month; updates automatically on add/delete/toggle
Token format : proxy tokens use tvly prefix, indistinguishable from real Tavily keys to clients
Proxy .env Configuration
Nginx Reverse Proxy + HTTPS
Integration Pattern: Auto replenish Pool
Troubleshooting
Problem Cause Fix
CAPTCHA solve failures Tavily elevated bot detection Pause several hours, reduce THREADS to 1
Email verification timeout Slow email delivery Increase poll timeout in config
Keys immediately disabled in proxy Tavily account flagged/suspended Register from different IP
playwright install firefox fails Missing system deps Run playwright install deps firefox first
Docker compose port conflict 9874 in use Change PORT in .env and docker compose.yml
X Admin Password 401 Wrong password Check .env , restart container after changes
IP ban during registration Too many registrations Use BATCH LIMIT=10 , wait hours between batches
Rate Limit Safe Settings
Security Checklist
[ ] Change ADMIN PASSWORD from default immediately after deploy
[ ] Add config.py to .gitignore (already included, verify before push)
[ ] Deploy behind HTTPS in production
[ ] Rotate proxy tokens periodically
[ ] Never commit api keys.md to public repositories