Novada-MCP

Pesquise, extraia, rastreie, mapeie e explore a web — a partir de qualquer agente de IA ou terminal.

Documentação

Novada MCP

Um servidor MCP para toda a web ao vivo. Pesquise, extraia, faça scraping, rastreie, use proxy, automatize navegadores e realize pesquisas com IA — tudo por meio de uma única conexão hospedada, ou uma instalação local, se preferir executar você mesmo.

[screenshot: Novada conectado em um cliente MCP, lista de ferramentas visível]

Início rápido · Obtenha sua chave · Como escolher uma ferramenta · Por que Novada · Estrutura do repositório · Links


✅ Funciona com qualquer cliente MCP — Claude, Cursor, Windsurf, VS Code ou `npx` localmente	🎯 15 scrapers tipados por plataforma — Amazon, Google, LinkedIn, TikTok, … cada um com um enum `operation` fechado, para que um agente não possa chamar uma operação inválida
🎁 $10 em créditos grátis — sem cartão de crédito — até 1.000 chamadas/mês	⚡ Hospedado primeiro, zero instalação — aponte para uma URL ou hospede você mesmo com um comando

Início rápido

Novada é hospedado primeiro — não há nada para instalar. Aponte seu cliente para a URL hospedada e pronto.

Nota de segurança: a URL hospedada contém sua chave de API no parâmetro ?token= — trate-a como uma senha. Nunca a compartilhe, nunca a publique publicamente e nunca a configure como um conector compartilhado ou de nível organizacional.

claude.ai (web)

Vá para Configurações → Conectores → Adicionar conector personalizado.
Nomeie-o como Novada.
Cole a URL (contém sua chave — veja a nota de segurança acima):
```
https://mcp.novada.com/mcp?token=YOUR_KEY
```
Clique em Adicionar.

Claude Code

claude mcp add --transport http novada "https://mcp.novada.com/mcp?token=YOUR_KEY"

Instalação completa por cliente (Cursor/Windsurf/VS Code + auto-hospedagem local) → npm-package/README.md.

Experimente

novada_setup()                                          — validates your key, shows balance
novada_search({query: "Claude MCP tutorials"})          — web search
novada_extract({url: "https://example.com"})            — read any URL
novada_research({question: "how do MCP servers work?"}) — parallel multi-source research

[screenshot: agente chamando novada_search e retornando resultados]

Obtenha sua chave

Cadastre-se em novada.com — sem cartão de crédito.
Copie sua chave de API de novada.com.
Você começa com $10 em créditos grátis, limitados a 1.000 chamadas/mês. Verifique o saldo a qualquer momento com novada_account({section: "balance"}) ou novada_setup().

Como escolher uma ferramenta

Estas são as ferramentas que você usará com mais frequência:

Ferramenta	Use quando
`novada_setup`	Primeira execução — valide sua chave e veja seu saldo. Comece aqui.
`novada_search`	Encontre páginas por consulta (google / duckduckgo / yandex; filtros de tempo, domínio, geo).
`novada_extract`	Leia uma URL conhecida — ou até 10 em paralelo — atravessando páginas anti-bot.
`novada_research`	Responda a uma pergunta complexa — busca multi-fonte paralela + extração em uma única chamada.
`novada_scrape`	Registros estruturados de 16 plataformas (Amazon, LinkedIn, TikTok, …). Além de 15 ferramentas tipadas por plataforma — `novada_scrape_amazon`, `_google`, `_linkedin`, … — cada uma com um enum `operation` fechado.
`novada_crawl`	Extraia conteúdo de um conjunto limitado de páginas relacionadas (≤20) em um único site.
`novada_map`	Descubra quais URLs existem em um site antes de buscar.
`novada_browser`	Interaja com uma página — clique, digite, tire screenshot, execute JS.
`novada_proxy`	Roteie seu próprio cliente HTTP através de um tipo de IP / país / sessão específico.

Não tem certeza? Chame novada_discover e ele retornará o catálogo completo com o status de cada ferramenta.

📚 Referência completa — todas as 38 ferramentas →

38 ferramentas em 6 categorias. Auto-hospedagem (npx novada-mcp) expõe todas as 38. A superfície padrão hospedada (mcp.novada.com) expõe 30 — o mesmo registro menos 8 ferramentas que não se aplicam a um endpoint serverless sem estado: novada_browser_flow (precisa de uma sessão de navegador persistente), novada_site_copy (grava arquivos em disco), novada_ip_whitelist / novada_static_ip_mgmt / novada_capture_apikey (operações de conta com gate de escrita), novada_session_stats / novada_search_feedback (estado em memória por processo) e novada_verify — é derivado do núcleo, não um subconjunto selecionado manualmente. Chame novada_discover na sua conexão para ver exatamente o que está disponível nela.

Por que Novada

15 scrapers dedicados por plataforma. novada_scrape_amazon, _google, _bing, _duckduckgo, _yandex, _youtube, _instagram, _facebook, _tiktok, _x, _walmart, _shein, _linkedin, _github, _perplexity — cada um expõe um enum operation fechado e tipado, limitado àquela plataforma, em vez do par de strings abertas novada_scrape+platform+operation do genérico, para que um agente não possa adivinhar uma operação inválida para a plataforma errada.
Superfície de ferramentas honesta. Cada operation listado é verificado e funcional — operações que não podemos entregar atualmente são marcadas e excluídas, não deixadas para falhar no meio da tarefa.
Auto-relato testado por contrato. As descrições das ferramentas são testadas contra o comportamento real, não apenas escritas e esquecidas — o que uma ferramenta afirma retornar é verificado contra o que ela realmente retorna.
Registro de ferramentas protegido contra desvios. npm-package/src/tools/registry.ts é a fonte única de verdade para o catálogo de ferramentas; um teste garante que as ferramentas registradas, as ferramentas conectadas e a saída de novada_discover nunca possam divergir.
confirm:true gate de escrita. Toda ferramenta mutável (criação de subconta de proxy, alterações na lista de IPs permitidos, compras de IP estático, redefinições de chave de captura) exige uma confirmação explícita em duas etapas — sem escritas silenciosas.
Onboarding chamável. novada_discover e novada_setup são ferramentas que seu agente pode chamar sozinho para encontrar a ferramenta certa ou validar uma chave, sem nunca ler este README.

Estrutura do repositório

Este é um monorepo com dois artefatos:

npm-package/ — o pacote npm novada-mcp. Servidor MCP stdio local (npx novada-mcp); fonte de verdade para toda a lógica de ferramentas.
hosted-server/ — o que roda em https://mcp.novada.com. Um wrapper HTTP (auth, cota, limite de taxa) na Vercel em torno da saída compilada do pacote npm.

Mapa completo da arquitetura (entradas, núcleo de despacho, onde cada coisa vive) → ARCHITECTURE.md; roteamento para contribuidores → CONTRIBUTING.

Licença

MIT