Inspecione seu tráfego HTTP sem dor
Debug HTTP local pela CLI, pelo inspector no terminal, pela web autenticada ou pelo app desktop separado. Capture e inspecione o tráfego que você encaminhar ao Tucano.
Um proxy. Escolha onde trabalhar.
Use comandos, inspecione no terminal ou abra a interface web local. A CLI independente dispensa o desktop; o app nativo tem download separado.
- CLI
- Automatize capturas e consulte sessões nomeadas com saída JSON estruturada.
- TUI
- Inspecione requisições no terminal. Fechar o inspector mantém o serviço em execução.
- Inspector web
- Abra a interface autenticada no Maestri, no Orca ou no navegador do sistema.
- App desktop
- Instale o app nativo Tauri separadamente para usar uma janela dedicada no desktop.
Inicie uma sessão
O setup guia o primeiro uso. Repita o nome da sessão nos comandos para a TUI e o inspector web exibirem as mesmas capturas.
Ler o guia da CLI →tucano-proxy --session demo setup
tucano-proxy --session demo start
tucano-proxy --session demo tui
tucano-proxy --session demo web --openInstalar a CLI
macOS, Linux e Windows. Escolha como instalar, sem precisar do app desktop.
curl -fsSL https://github.com/plscabral/tucano-proxy/releases/latest/download/install.sh | shDownload manual
Usando um agente de IA?Skill para agentes
Adicione a skill ao seu agente para trabalhar com o Tucano. Ela instala instruções, não o executável da CLI.
npx skills add plscabral/tucano-proxy --skill tucano-proxyInstalar a CLI não instala uma CA confiável nem altera o proxy do sistema. A captura recebe apenas tráfego encaminhado ao listener; confiança HTTPS e roteamento pelo sistema exigem consentimentos separados.
No seu fluxo com Maestri e Orca
O comando web detecta o terminal em uso. No modo interativo, oferece o navegador integrado, o navegador do sistema ou cancelar. Com --json, auto escolhe o app detectado sem perguntar; Maestri tem prioridade quando ambos são detectados.
A abertura usa uma credencial local. Não compartilhe URLs autenticadas. O comando abre o inspector web, não o aplicativo desktop.
tucano-proxy --session demo web --open --target maestri
tucano-proxy --session demo web --open --target orca
tucano-proxy --session demo web --open --target browserTudo que você precisa pra debugar HTTP.
Inspeção local, roteamento explícito e confiança no certificado sob seu controle. Sem telemetria.
MITM em 127.0.0.1:8888
Proxy local com TLS reescrito de ponta a ponta usando uma CA gerada na sua máquina.
Toggle do proxy do sistema
Liga e desliga o proxy do macOS e Windows com um clique. Sem editar configuração à mão.
Certificado raiz auto-assinado
Geração e instalação guiadas. Você decide quando confiar — e quando revogar.
Lista virtualizada
Aguenta dezenas de milhares de requisições sem travar. Scroll suave do começo ao fim.
Filtro com DSL
Filtros poderosos. Combine, inverta, salve.
host:api.foo.com status:>=400Sessões .tucano
Salva tudo num arquivo SQLite. Compartilha com o time, abre depois, sem perder nada.
Do download ao primeiro request.
Escolha CLI ou desktop, encaminhe o tráfego necessário e confie na CA local somente ao inspecionar HTTPS.
- 01
Escolha CLI ou desktop
Confira os canais disponíveis da CLI independente ou baixe o instalador separado do desktop.
- 02
Instale a CA, se for inspecionar HTTPS
O certificado é gerado localmente. Siga a instalação guiada e revogue a confiança quando quiser.
- 03
Ligue a captura
Inicie a captura e encaminhe o aplicativo pelo listener. O proxy do sistema no macOS/Windows é opcional e não inclui apps que ignoram essa configuração.
Capturas reais — não maquetes.
“Fala aí, Paulinho, boa tarde. Hoje fiz uma implementação usando o Tucano e vim aqui te dar um feedback. Cara, que ferramenta boa! Fiz as capturas no site, conectei no Claude, e ele já me trouxe os steps certinhos. Só alguns ajustes finos e estava pronto. Top demais, estou usando bastante. Parabéns pela iniciativa de criar essa ferramenta que vai nos ajudar muito e por toda a história em torno também. Você é um exemplo para nós!”
Quando o Tucano Proxy é a escolha certa.
Ele resolve inspeção HTTP local. Não tenta se apresentar como substituto universal de ferramentas comerciais já maduras.
Escolha Tucano se você quer
- capturar e filtrar tráfego HTTP no seu computador
- salvar sessões portáveis em arquivo .tucano
- usar uma ferramenta aberta, sem licença ou paywall
Considere outra ferramenta se você precisa
- suporte comercial ou contrato de fornecedor
- recursos que não aparecem nas docs ou no repositório do Tucano
- dispensar a instalação de certificado para inspecionar HTTPS
Performance, leveza e propósito.
Pensado pra ser rápido em qualquer máquina, escrito em Rust + Tauri, com design minimalista e desenhado com muito carinho pra ajudar a comunidade.
Performático de verdade
Lista virtualizada, parsing em thread separada, zero copy onde dá. Aguenta milhares de requests sem travar a interface.
Rust + Tauri
Núcleo do proxy em Rust — memória segura, sem GC, binário pequeno. UI nativa via Tauri 2.
Design minimalista
Cada pixel pensado pra sumir de baixo do conteúdo. Cor com propósito, tipografia generosa, sem firula.
Exportação em Markdown pronta pra LLM
Um clique e o Tucano gera um Markdown limpo com prompt customizável e steps estruturados — pra colar direto num Claude, GPT ou agente que está te ajudando a debugar.
- Prompt customizável + linguagem-alvo. Escolhe C#, TypeScript, Python, Go, Java ou livre — o prompt default já orienta o modelo a seguir o padrão do seu repositório.
- Steps estruturados com placeholders. Headers sensíveis mascarados, placeholders cross-step ({var1}, {var2}) e dicas de locator (XPath/JSON-path) pra extração.
- Copia ou salva como .md. Botão de copiar pro clipboard ou salvar como tucano.llm.md. Texto puro, pronto pra colar na conversa.
# Tucano — Fluxo HTTP capturado
> Você é um engenheiro experiente em TypeScript (fetch).
> Antes de gerar código, inspecione o repo e siga o
> padrão usado para chamadas HTTP.
## Contexto
- Total de chamadas: 2
- Hosts: auth.example.com, api.example.com
- Linguagem-alvo: TypeScript (fetch)
- Headers sensíveis mascarados: sim
## Steps (estruturado)
### 1. POST auth.example.com/login → 200
| header | value |
| ------------- | ----------------- |
| content-type | application/json |
| authorization | ***REDACTED*** |
### 2. GET api.example.com/me → 200
| authorization | Bearer {var1} |{
"mcpServers": {
"tucano": {
"type": "http",
"url": "http://127.0.0.1:7878/mcp",
"headers": {
"Authorization": "Bearer paste-the-token-from-tucano-settings"
}
}
}
}Tucano dentro do seu agente
O Tucano fala Model Context Protocol nativamente — sem Node, sem npx. Ligue a bridge MCP e plugue Claude Desktop, Claude Code, Cursor, OpenCode ou Codex direto pra inspecionar, refazer e compor requisições.
Pegue o token em Configurações → MCP do app.
Ver documentação →Ferramentas expostas
tucano_statusStatus da bridge + proxy e contagem de flows. Sem parâmetros.
tucano_list_flowsLista resumos dos flows capturados (sem bodies). Params: limit (1–1000), host, method, status, q, since (epoch-ms pra polling incremental).
tucano_get_flowFlow completo, com bodies. Params: id.
tucano_get_request_bodyBody da request decodificado (utf8 ou base64). Params: id.
tucano_get_response_bodyBody da response decodificado (utf8 ou base64). Params: id.
tucano_replay_flowRe-dispara um flow com overrides opcionais de headers/body; cria flow novo. Params: id, headers (substitui todos quando informado), body.
tucano_compose_requestEnvia uma request nova pelo Tucano. Params: method, url (URL completa), headers, body, log (padrão true — false roda sem persistir).
tucano_delete_flowsApaga flows por id. Params: ids (array).
tucano_clear_flowsLimpa todos os flows capturados — útil pra estabelecer baseline antes de uma automação. Sem parâmetros.
tucano_start_captureLiga o proxy local e flipa o system proxy do OS pra o tráfego passar pelo Tucano. Params: port (opcional, padrão = porta atual, normalmente 8888).
Tirando as dúvidas
Preciso instalar um certificado? +
Sim, para inspecionar HTTPS. O Tucano gera um CA local e te guia na instalação. Você pode revogar a qualquer momento.
Funciona offline? +
Funciona. O proxy roda 100% local e não envia dados pra lugar nenhum.
Como é em comparação ao Fiddler ou Proxyman? +
Mesma ideia, com foco em velocidade, simplicidade e ser open source. Sem licença, sem telemetria.
Tem versão para Linux? +
Os downloads desktop AppImage e .deb estão na página de download. Confira lá a disponibilidade separada dos arquivos nativos da CLI Linux e dos canais de pacotes.
Posso contribuir? +
Por favor! Abra uma issue ou um PR no GitHub.
Preciso do app desktop para usar a CLI? +
Não. A CLI independente inclui TUI e inspector web local. web --open abre essa interface web autenticada no Maestri, Orca ou navegador do sistema; não inicia o app desktop separado.
Pronto pra começar?
Escolha a instalação da CLI ou o download separado do desktop. MIT. Bugs, ideias e PRs bem-vindos.