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.
Inicio rápido · Obtén tu clave · Cómo elegir una herramienta · Por qué Novada · Estructura del repositorio · Enlaces
✅ 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: prefiereAuthorization: Bearer <key>en su lugar — mantiene la clave fuera de las URLs y de los registros de acceso.
claude.ai (web)
- Ve a Configuración → Conectores → Añadir conector personalizado.
- Nómbralo
Novada. - Pega la URL (contiene tu clave — consulta la nota de seguridad anterior):
https://mcp.novada.com/mcp?apikey=YOUR_KEY - 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
- Regístrate en novada.com — sin necesidad de tarjeta de crédito.
- Copia tu clave de API desde novada.com.
- 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"})onovada_setup().
Cómo elegir una herramienta
Estas son las herramientas que usarás con más frecuencia:
| Herramienta | Úsala cuando |
|---|---|
novada_setup | Primera ejecución — valida tu clave y consulta tu saldo. Empieza aquí. |
novada_search | Encuentra páginas por consulta (google / duckduckgo / yandex; filtros de tiempo, dominio y geografía). |
novada_extract | Lee una URL conocida — o hasta 10 en paralelo — a través de páginas anti-bot. |
novada_research | Responde una pregunta compleja — búsqueda multi-fuente en paralelo + extracción en una sola llamada. |
novada_scrape | Registros estructurados de 16 plataformas (Amazon, LinkedIn, TikTok, …). Además 15 herramientas tipadas por plataforma — novada_scrape_amazon, _google, _linkedin, … — cada una con un enum cerrado de operation. |
novada_crawl | Extrae contenido de un conjunto limitado de páginas relacionadas (≤20) en un solo sitio. |
novada_map | Descubre qué URLs existen en un sitio antes de obtenerlas. |
novada_browser | Interactúa con una página — haz clic, escribe, captura pantalla, ejecuta JS. |
novada_proxy | Enruta 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
| Herramienta | Local (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 deoperationlimitado a esa plataforma en lugar del par genérico de cadenas abiertasnovada_scrape+platformdeoperation, para que un agente no pueda adivinar una operación inválida para la plataforma equivocada. - Superficie de herramientas honesta. Cada
operationlistado 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.tses la única fuente de verdad para el catálogo de herramientas; una prueba verifica que las herramientas registradas, las herramientas conectadas y la salida denovada_discovernunca 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_discoverynovada_setupson 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-mcparranca en frío sin clave;novada_setupte 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 denovada-mcp. Servidor MCP stdio local (npx novada-mcp); fuente de verdad para toda la lógica de herramientas.hosted-server/— lo que se ejecuta enhttps://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
- Sitio web: novada.com
- Obtén una clave de API: novada.com
- Regístrate (gratis): novada.com
- npm: npmjs.com/package/novada-mcp
- GitHub: github.com/NovadaLabs/novada-mcp
- Problemas: github.com/NovadaLabs/novada-mcp/issues
Licencia
MIT

