Agent skill · software engineering · aradotso
tavily-key-generator-proxy
Auto batch-register Tavily API keys via browser automation and pool them behind a unified proxy gateway with web console
Why this skill is useful
Adds a complete automation script for bulk Tavily account registration and API key management that isn't available in public documentation.
What it needs
Requires docker, playwright, python installed locally. Requires capsolver account access. About 5k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
Tavily Key Generator + API Proxy Skill by 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 apikeys.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 apikey (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 = activekeys × 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 Re …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/tavily-key-generator-proxy