# tavily-key-generator-proxy

Automates Tavily API key generation with browser scripting and pools tokens behind a balancing FastAPI proxy.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1400 installs · ★ 88
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/tavily-key-generator-proxy/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/tavily-key-generator-proxy

## What it does

This skill guides the setup of a dual-part infrastructure: an account registrar and an API reverse proxy. The generator drives headless Firefox via Playwright to register accounts, solve Turnstile challenges, and complete email confirmation. Every free account provides 1,000 requests monthly.

The proxy server runs in Docker on port 9874, routing calls across all pooled tokens using round-robin. It exposes `/api/search` and `/api/extract` drop-in endpoints alongside a web dashboard at `/console`. When any key encounters 3 consecutive errors, the proxy disables it automatically.

Running the generator requires an external mail provider, either DuckMail or a Cloudflare Email Worker, plus a CapSolver token for captcha handling.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill tavily-key-generator-proxy -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/tavily-key-generator-proxy/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/tavily-key-generator-proxy/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill tavily-key-generator-proxy -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/tavily-key-generator-proxy/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill tavily-key-generator-proxy -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/tavily-key-generator-proxy/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/trending-skills tavily-key-generator-proxy
```

2. **Manually: put the files in place**
- File: `.github/skills/tavily-key-generator-proxy/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill tavily-key-generator-proxy -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/trending-skills --path skills/tavily-key-generator-proxy
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/tavily-key-generator-proxy/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill tavily-key-generator-proxy -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/tavily-key-generator-proxy/SKILL.md

## When to use it
- Batch register Tavily accounts using headless browser automation
- Pool individual free monthly quotas into a unified API endpoint
- Route Tavily SDK traffic through a self-hosted load-balancing proxy
- Disable failing API tokens after repeated request errors

## Example prompts
- Configure the Tavily key generator using DuckMail for verification
- Start the Tavily proxy container with Docker Compose on port 9874
- Route Python TavilyClient requests through my local proxy URL

## Similar
- [remotion-render](https://affpapa.org/en/nevibecode/skills/remotion-render.md) — skill · 3 installs
- [recipe-share-event-materials](https://affpapa.org/en/nevibecode/skills/recipe-share-event-materials.md) — skill · 29700 installs
- [blogwatcher](https://affpapa.org/en/nevibecode/skills/blogwatcher.md) — skill · 5400 installs
- [ego-browser](https://affpapa.org/en/nevibecode/skills/ego-browser.md) — skill · 12200 installs
- [composio](https://affpapa.org/en/nevibecode/skills/composio.md) — skill · 8100 installs
- [remote-browser](https://affpapa.org/en/nevibecode/skills/remote-browser.md) — skill · 4700 installs

From the same set: [reason-machines/trending-skills](https://affpapa.org/en/nevibecode/by/reason-machines/trending-skills.md) — 186 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md