frederico-kluser

Tavily Agent Skill — AI skill for Claude Code

AI community

Pesquisa web para agentes de LLM via API Tavily com rotação AUTOMÁTICA de chaves — se a request morrer (429/432/401/5xx/rede), puxa outra chave e refaz a MESMA request; o agente nunca vê o erro.

How to install Tavily Agent Skill

This entry records only its repository, not the path inside it, so there is no exact command to give. Open frederico-kluser/tavily-agent-skill and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Tavily Agent Skill does

Pesquisa web para agentes de LLM via API Tavily com rotação AUTOMÁTICA de chaves — se a request morrer (429/432/401/5xx/rede), puxa outra chave e refaz a MESMA request; o agente nunca vê o erro. Funciona em qualquer agente/terminal, dentro ou fora do DSH.

Alternatives in AI

  • CliRelay — Self-hosted AI gateway for coding CLIs — one OpenAI/Claude/Gemini/Codex-compatible endpoint, with a multi-tena 1k ★
  • Free GPT4 WEB API — Not just GPT4 690 ★
  • onWatch — Open-source Go CLI that tracks AI API quota usage across 7 providers (Synthetic, Z.ai, Anthropic, Codex, GitHu 397 ★

README

tavily-agent-skill

[![ci](https://github.com/frederico-kluser/tavily-agent-skill/actions/workflows/ci.yml/badge.svg)](https://github.com/frederico-kluser/tavily-agent-skill/actions/workflows/ci.yml)

Pesquisa web para agentes de LLM via **API Tavily** com **rotação automática de chaves** — **round-robin estrito** (cada chamada troca de chave) e **ban de 24 h** para qualquer chave que falhe (429 rate limit, 432 cota, 401 chave morta, timeout, 5xx, rede): a chave falhada fica de fora e não é selecionável; o script puxa **outra chave e refaz a mesma request**. O agente que chama nunca vê o erro nem precisa de gerir nada. O controlo global é o comando **`keys`**.

Por cima disso, um **modo pesquisa profunda** focado só em qualidade — ativado **exclusivamente pela flag `--deep-research`** (`search --deep-research "…"` / `research init|lint --deep-research`), nunca por contexto: decomposição em sub-perguntas, subagentes em paralelo, rondas até a auditoria de lacunas fechar, fontes académicas, verificação adversarial e um **dossiê Markdown com FAQ em árvore** — com **escudo nativo contra injeção de prompts** em todo o texto que vem da web.

Agent Skill (spec aberta) que funciona em **qualquer agente/terminal**, dentro ou fora do DeepSeek Harness — sem plugin, sem dependências (Python stdlib).

Instalar (global, via symlink)

git clone https://github.com/frederico-kluser/tavily-agent-skill.git
ln -s "$(pwd)/tavily-agent-skill" ~/.agents/skills/tavily-agent-skill

Usar

python3 ~/.agents/skills/tavily-agent-skill/scripts/tavily.py search "o que diz a web sobre X"
python3 ~/.agents/skills/tavily-agent-skill/scripts/tavily.py search "..." --json   # para citar
python3 ~/.agents/skills/tavily-agent-skill/scripts/tavily.py status               # estado do pool + saldo + próxima da rotação
python3 ~/.agents/skills/tavily-agent-skill/scripts/tavily.py keys                 # controlo global de chaves/bans
python3 ~/.agents/skills/tavily-agent-skill/sc