4ier/neoTransforme qualquer aplicação web em uma API. A extensão do Chrome captura o tráfego do navegador, gera automaticamente esquemas, permite que a IA reproduza APIs diretamente. Nenhuma API oficial necessária.
Transforme qualquer aplicação web em uma API. Sem API oficial necessária. Sem automação de navegador.
Neo é uma extensão do Chrome que captura passivamente toda chamada de API que seu navegador faz, aprende os padrões e permite que IA (ou você) as reproduza diretamente.
Agentes de IA que operam aplicações web hoje têm duas opções, ambas ruins:
| Abordagem | Problema |
|---|---|
| APIs oficiais | A maioria dos SaaS não tem uma, ou expõe apenas 10% dos recursos |
| Automação de navegador | Screenshot → OCR → clique. Lento, frágil, quebra a cada mudança de UI |
Neo é o terceiro caminho. Toda aplicação web já possui uma API interna completa — o frontend a chama toda vez que você clica em algo. Neo captura essas chamadas e as torna reproduzíveis.
v2: Agora com automação de UI. Neo v2 adiciona uma camada de UI baseada em árvore de acessibilidade — snapshot, click, fill, type, press, hover, scroll, select, screenshot, get, wait. Quando uma API existe, use-a diretamente. Quando não existe, Neo pode conduzir a UI através da mesma CLI. Uma ferramenta, ambas as camadas.
Navegue normalmente → Neo grava todo o tráfego de API → Esquema gerado automaticamente → IA reproduz APIs diretamente
→ Ou conduz UI via árvore de acessibilidade
A extensão do Chrome intercepta todo fetch() e XMLHttpRequest — URLs, cabeçalhos, corpos de requisição/resposta, tempo, até mesmo qual elemento DOM acionou a chamada.
Execute neo-schema em um domínio para gerar automaticamente seu mapa de API: endpoints, cabeçalhos de autenticação necessários, parâmetros de consulta, estrutura de resposta, códigos de erro.
Execute chamadas de API dentro do contexto da aba do navegador via Chrome DevTools Protocol. Cookies, tokens CSRF, autenticação de sessão — tudo herdado automaticamente. Sem necessidade de gerenciamento de tokens.
| Navegador | Tipo | Melhor para |
|---|---|---|
| Chrome / Chromium | Navegador completo | Captura de API + automação de UI (padrão) |
| Lightpanda | Headless (Zig) | Agentes de IA, scraping — 11x mais rápido, 9x menos memória |
git clone https://github.com/4ier/neo.git
cd neo && npm install && npm run build
npm link # torna `neo` disponível globalmente
Carregue a extensão:
chrome://extensionsextension/dist/# Instalar Lightpanda
curl -L -o lightpanda https://github.com/lightpanda-io/browser/releases/download/nightly/lightpanda-x86_64-linux
chmod +x lightpanda && sudo mv lightpanda /usr/local/bin/
# Configurar Neo para usar Lightpanda
# Em ~/.neo/config.json:
# { "chromePath": "/usr/local/bin/lightpanda", "browserType": "lightpanda", "cdpPort": 9222 }
neo start # inicia servidor CDP do Lightpanda
neo connect # anexa a ele
neo open https://example.com
neo snapshot # árvore de acessibilidade completa
Todos os comandos passam por uma CLI única: neo <comando>.
Requer um navegador com CDP (Chrome DevTools Protocol) habilitado.
# --- Conexão e Sessões ---
neo connect [port] # Conecta ao CDP, salva sessão
neo connect --electron <app-name> # Descobre automaticamente a porta CDP de um app Electron
neo launch <app> [--port N] # Inicia app Electron com CDP habilitado
neo discover # Encontra endpoints CDP alcançáveis no localhost
neo sessions # Lista sessões salvas
neo tab # Lista alvos CDP na sessão ativa
neo tab <index> | neo tab --url <pattern> # Alterna alvo da aba ativa
neo inject [--persist] [--tab pattern] # Injeta script de captura Neo no alvo
# --- Captura e Tráfego ---
neo status # Visão geral dos dados capturados
neo capture summary # Visão geral rápida
neo capture list github.com --limit 10 # Mostra IDs para reprodução/detalhes
neo capture list --since 1h # Filtrado por tempo
neo capture domains
neo capture search "CreateTweet" --method POST
neo capture watch x.com # Acompanhamento ao vivo (como tail -f)
neo capture stats x.com # Detalhamento por método/status/tempo
neo capture export x.com --since 2h > x.json
neo capture export x.com --format har > x.har # HAR 1.2 para Postman/devtools
neo capture import x-captures.json
neo capture prune --older-than 7d
neo capture gc x.com [--dry-run] # Deduplicação inteligente
# --- Reprodução e Execução de API ---
neo replay <capture-id> --tab x.com # Reproduz uma chamada capturada
neo exec <url> --method POST --body '{...}' --tab example.com --auto-headers
neo api x.com HomeTimeline # Chamada inteligente (consulta de esquema + autenticação automática)
# --- Esquema e Análise ---
neo schema generate x.com # Gera a partir de capturas
neo schema generate --all # Lote para todos os domínios
neo schema show x.com [--json]
neo schema openapi x.com # Exporta especificação OpenAPI 3.0
neo schema diff x.com # Mudanças em relação à versão anterior
neo schema coverage # Domínios com/sem esquemas
neo label x.com [--dry-run] # Rótulos semânticos de endpoints
neo flows x.com [--window 5000] # Padrões de sequência de chamadas de API
neo deps x.com [--min-confidence 1] # Dependências de dados resposta→requisição
neo workflow discover|show|run <name> # Descoberta e reprodução de fluxos de múltiplas etapas
neo suggest x.com # Análise de capacidades por IA
neo export-skill x.com # Gera SKILL.md pronto para agente
# --- Automação de UI (v2) ---
neo snapshot [-i] [-C] [--json] # Árvore de acessibilidade com mapeamento @ref
neo click @ref [--new-tab] # Clica no elemento pelo @ref
neo fill @ref "text" # Limpa + preenche input
neo type @ref "text" # Acrescenta texto ao input
neo press <key> # Tecla do teclado (suporta Ctrl+a, Enter, etc.)
neo hover @ref # Passa o mouse sobre o elemento
neo scroll <dir> [px] [--selector css] # Rola por direção
neo select @ref "value" # Define valor de dropdown
neo screenshot [path] [--full] [--annotate] # Captura screenshot
neo get text @ref | neo get url | neo get title # Extrai informações
neo wait @ref | neo wait --load networkidle | neo wait <ms> # Aguarda elemento/carregamento/tempo
# --- Interação com Página ---
neo read github.com # Extrai texto legível
neo eval "document.title" --tab github.com # Executa JS na página
neo open https://example.com # Abre URL
# --- Mock e Bridge ---
neo mock x.com [--port 8080 --latency 200] # Servidor mock a partir do esquema
neo bridge [--json] [--interactive] # Fluxo de captura em tempo real via WebSocket
# --- Diagnóstico ---
neo doctor # Verifica Chrome, extensão, esquemas
neo reload # Recarrega extensão a partir da CLI
neo tabs [filter] # Lista abas abertas do Chrome
Neo não é só para Chrome. Qualquer aplicativo com suporte a CDP funciona — incluindo aplicativos Electron: