Novada-MCP

Busca, extrae, rastrea, mapea e investiga la web — desde cualquier agente de IA o terminal.

Documentación

Novada MCP

Un único servidor MCP para toda la web en vivo. Búsqueda, extracción, scraping, rastreo, proxy, automatización de navegador e investigación impulsada por IA — todo detrás de una única conexión alojada, o una instalación local si prefieres ejecutarlo tú mismo.

npm version npm downloads CI License: MIT

Inicio rápido · Obtén tu clave · Cómo elegir una herramienta · Por qué Novada · Estructura del repositorio · Enlaces

Free to start — $10 in free credits, up to 1,000 API calls/month, no credit card needed

✅ Funciona con cualquier cliente MCP — Claude, Cursor, Windsurf, VS Code o npx localmente🎯 15 scrapers tipados por plataforma — Amazon, Google, LinkedIn, TikTok, … cada uno con un enum cerrado de operation, para que un agente no pueda llamar a una operación inválida
🎁 $10 de crédito gratis — sin necesidad de tarjeta de crédito — hasta 1,000 llamadas al mes⚡ Alojado primero, cero instalación — apunta a una URL, o auto-aloja con un solo comando

Inicio rápido

Novada es alojado primero — no hay nada que instalar. Apunta tu cliente a la URL alojada y listo.

Nota de seguridad: la URL alojada contiene tu clave de API en el parámetro ?apikey= — trátala como una contraseña. Nunca la compartas, nunca la publiques públicamente y nunca la configures como un conector compartido o a nivel de organización. Clientes con soporte para cabeceras: prefiere Authorization: Bearer <key> en su lugar — mantiene la clave fuera de las URLs y de los registros de acceso.

claude.ai (web)

  1. Ve a Configuración → Conectores → Añadir conector personalizado.
  2. Nómbralo Novada.
  3. Pega la URL (contiene tu clave — consulta la nota de seguridad anterior):
    https://mcp.novada.com/mcp?apikey=YOUR_KEY
    
  4. Haz clic en Añadir.

Claude Code

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

Instalación completa por cliente (Cursor/Windsurf/VS Code + auto-alojamiento local) → npm-package/README.md.

Pruébalo

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

Obtén tu clave

  1. Regístrate en novada.com — sin necesidad de tarjeta de crédito.
  2. Copia tu clave de API desde novada.com.
  3. Comienzas con $10 en crédito gratis, limitado a 1,000 llamadas al mes. Consulta lo que te queda en cualquier momento con novada_account({section: "balance"}) o novada_setup().

Cómo elegir una herramienta

How to choose a Novada MCP tool — decision guide

Estas son las herramientas que usarás con más frecuencia:

HerramientaÚsala cuando
novada_setupPrimera ejecución — valida tu clave y consulta tu saldo. Empieza aquí.
novada_searchEncuentra páginas por consulta (google / duckduckgo / yandex; filtros de tiempo, dominio y geografía).
novada_extractLee una URL conocida — o hasta 10 en paralelo — a través de páginas anti-bot.
novada_researchResponde una pregunta compleja — búsqueda multi-fuente en paralelo + extracción en una sola llamada.
novada_scrapeRegistros estructurados de 16 plataformas (Amazon, LinkedIn, TikTok, …). Además 15 herramientas tipadas por plataformanovada_scrape_amazon, _google, _linkedin, … — cada una con un enum cerrado de operation.
novada_crawlExtrae contenido de un conjunto limitado de páginas relacionadas (≤20) en un solo sitio.
novada_mapDescubre qué URLs existen en un sitio antes de obtenerlas.
novada_browserInteractúa con una página — haz clic, escribe, captura pantalla, ejecuta JS.
novada_proxyEnruta tu propio cliente HTTP a través de un tipo de IP / país / sesión específico.

¿No estás seguro? Llama a novada_discover y devolverá el catálogo completo con el estado de cada herramienta.

📚 Referencia completa — las 38 herramientas →

38 herramientas en 6 categorías. Auto-alojamiento (npx novada-mcp) expone las 38. La superficie predeterminada alojada (mcp.novada.com) expone 30 — el mismo registro menos 8 herramientas que no aplican a un endpoint serverless sin estado: novada_browser_flow (necesita una sesión de navegador persistente), novada_site_copy (escribe archivos en disco), novada_ip_whitelist / novada_static_ip_mgmt / novada_capture_apikey (operaciones de cuenta con control de escritura), novada_session_stats / novada_search_feedback (estado en memoria por proceso), y novada_verify — es derivado del núcleo, no un subconjunto seleccionado a mano. Llama a novada_discover en tu conexión para ver exactamente qué está disponible en ella.

¿Dónde se ejecuta?

Desglose completo local/alojado, las 38 herramientas
HerramientaLocal (npx novada-mcp)Alojado (mcp.novada.com)
novada_search
novada_extract
novada_crawl
novada_research
novada_map
novada_site_copy❌ escribe en disco local
novada_search_feedback❌ estado en memoria por proceso
novada_scrape
novada_scrape_amazon_perplexity (15 herramientas de plataforma)
novada_ai_monitor
novada_monitor
novada_verify❌ no está en el listado alojado de novada_discover
novada_proxy
novada_browser
novada_browser_flow❌ necesita una sesión de navegador persistente
novada_account
novada_proxy_account_create❌ operación de cuenta con control de escritura
novada_proxy_account_list
novada_ip_whitelist❌ operación de cuenta con control de escritura
novada_capture_apikey❌ operación de cuenta con control de escritura
novada_static_ip_mgmt❌ operación de cuenta con control de escritura
novada_discover
novada_setup
novada_session_stats❌ estado en memoria por proceso

Referencia completa por herramienta (misma columna) → docs/TOOLS.md.


Por qué Novada

  • 15 scrapers dedicados por plataforma. novada_scrape_amazon, _google, _bing, _duckduckgo, _yandex, _youtube, _instagram, _facebook, _tiktok, _x, _walmart, _shein, _linkedin, _github, _perplexity — cada uno expone un enum cerrado y tipado de operation limitado a esa plataforma en lugar del par genérico de cadenas abiertas novada_scrape+platform de operation, para que un agente no pueda adivinar una operación inválida para la plataforma equivocada.
  • Superficie de herramientas honesta. Cada operation listado está verificado y funcionando — las operaciones que actualmente no podemos entregar están marcadas y excluidas, no se dejan para que fallen a mitad de tu tarea.
  • Autoreporte probado por contrato. Las descripciones de las herramientas se prueban contra el comportamiento real, no solo se escriben y se olvidan — lo que una herramienta afirma devolver se verifica contra lo que realmente devuelve.
  • Registro de herramientas protegido contra desviaciones. npm-package/src/tools/registry.ts es la única fuente de verdad para el catálogo de herramientas; una prueba verifica que las herramientas registradas, las herramientas conectadas y la salida de novada_discover nunca puedan divergir.
  • Control de escritura confirm:true. Cada herramienta mutante (creación de subcuentas proxy, cambios en la lista blanca de IP, compras de IP estática, restablecimientos de clave de captura) requiere una confirmación explícita en dos pasos — sin escrituras silenciosas.
  • Incorporación invocable. novada_discover y novada_setup son herramientas que tu agente puede llamar por sí mismo para encontrar la herramienta correcta o validar una clave, sin necesidad de leer este README.

vs Firecrawl / Tavily (medido, no marketing):

  • 4.9× más compacto. Una consulta de búsqueda idéntica con 5 resultados devolvió 2,761 bytes desde Novada frente a 13,421 bytes desde Firecrawl — menos costo de tokens de agente por respuesta.
  • Sin clave para empezar. npx -y novada-mcp arranca en frío sin clave; novada_setup te guía hacia una solo cuando una herramienta la necesita.
  • Fallos anti-bot con nombre. En un objetivo irresoluble, la respuesta de Novada nombra el bloqueador exacto (por ejemplo, anti_bot:kasada) en lugar de un error genérico, para que un agente pueda ramificar según ello.

Estructura del repositorio

Este es un monorepo con dos artefactos:

  • npm-package/ — el paquete npm de novada-mcp. Servidor MCP stdio local (npx novada-mcp); fuente de verdad para toda la lógica de herramientas.
  • hosted-server/ — lo que se ejecuta en https://mcp.novada.com. Un envoltorio HTTP (autenticación, cuota, límite de velocidad) en Vercel alrededor de la salida compilada del paquete npm.

Mapa completo de arquitectura (entradas, núcleo de despacho, dónde vive cada cosa) → ARCHITECTURE.md; enrutamiento de contribuciones → CONTRIBUTING.


Enlaces

Licencia

MIT