En esta página
Windsurf es un editor de código con IA de nueva generación creado por Codeium, diseñado en torno al concepto de "Flows": acciones de IA de varios pasos que entienden toda tu base de código (consulta la documentación oficial de inicio de Windsurf). CrawlForge MCP amplía las capacidades de Windsurf más allá de tus archivos locales y hacia la web en vivo conectándose al soporte MCP de Cascade, permitiendo que la IA obtenga documentación, haga scraping de implementaciones de referencia, investigue APIs y extraiga datos, todo desde dentro de tu editor.
Esta guía te muestra cómo configurar CrawlForge como un MCP server en Windsurf y usarlo para tareas de desarrollo reales.
Tabla de contenidos
- Requisitos previos
- Por qué CrawlForge en Windsurf
- Paso 1: instalar el servidor CrawlForge MCP
- Paso 2: configurar los ajustes MCP de Windsurf
- Paso 3: verificar la conexión
- Casos de uso prácticos
- Desglose de costos en credits
- Solución de problemas
- Próximos pasos
Requisitos previos
- Windsurf IDE instalado (windsurf.com)
- Node.js 18+ instalado
- Una API key de CrawlForge: regístrate gratis para obtener 1.000 credits
Por qué CrawlForge en Windsurf
El agente de IA Cascade de Windsurf ya puede leer tu base de código y hacer ediciones en varios archivos. Pero no puede acceder a recursos externos:
- No puede leer la última documentación de API de una librería que estás usando
- No puede comprobar cómo un competidor implementa una función específica
- No puede obtener HTML del mundo real para probar tu parser
- No puede investigar mejores prácticas en múltiples fuentes
CrawlForge resuelve esto. Una vez configurado, el agente de IA de Windsurf obtiene acceso a las 20 herramientas de CrawlForge y selecciona la adecuada según lo que pidas.
Paso 1: instalar el servidor CrawlForge MCP
Abre tu terminal e instala el servidor CrawlForge MCP de forma global:
Verifica la instalación:
Paso 2: configurar los ajustes MCP de Windsurf
Windsurf lee las configuraciones de los MCP server desde un archivo JSON. Abre tu configuración MCP de Windsurf:
macOS / Linux:
Windows:
Añade el servidor CrawlForge al objeto mcpServers:
Reemplaza cf_live_your_api_key_here con tu API key real del panel de CrawlForge.
Alternativa: configuración a nivel de proyecto
Para proyectos de equipo, crea un .windsurf/mcp_config.json en la raíz de tu proyecto. Esto mantiene la configuración bajo control de versiones (pero recuerda añadir tu API key mediante variables de entorno en lugar de codificarla directamente):
Paso 3: verificar la conexión
Reinicia Windsurf para que tome la nueva configuración MCP. Luego abre el panel de Cascade (Cmd+L / Ctrl+L) y escribe:
Fetch the homepage of https://crawlforge.dev and tell me what the product does.
Windsurf debería invocar automáticamente la herramienta fetch_url o extract_content de CrawlForge y devolver un resumen. Si ves los resultados, la conexión está funcionando.
Puedes verificar qué herramientas están disponibles preguntando:
What CrawlForge tools do you have access to?
Cascade listará las 20 herramientas con sus descripciones.
Casos de uso prácticos
Obtener documentación mientras programas
Pídele a Cascade que lea la documentación más reciente de cualquier librería:
Read the Next.js docs for the App Router metadata API and show me how to add Open Graph tags.
La herramienta extract_content de CrawlForge obtiene la página de documentación, y Cascade la aplica directamente a tu código. Costo: 2 credits.
Investigar patrones de diseño de API
Search for best practices for REST API pagination in 2026 and summarize the top 3 approaches.
Cascade usa search_web para encontrar artículos y luego extract_content para leerlos. Costo: ~11 credits (5 por la búsqueda + 2 por página para 3 páginas).
Generar datos de prueba a partir de sitios web reales
Scrape 5 product listings from https://books.toscrape.com and generate TypeScript interfaces that match the data structure.
La herramienta scrape_structured de CrawlForge extrae los datos, y Cascade genera interfaces tipadas a partir de la respuesta. Costo: 2 credits.
Monitorear el changelog de un competidor
Fetch the changelog at https://competitor.com/changelog and list all features released in the last 30 days.
Usa extract_content para leer la página y filtra por fecha. Costo: 2 credits.
Desglose de costos en credits
| Tarea | Herramienta | Credits |
|---|---|---|
| Obtener una página de documentación | extract_content | 2 |
| Buscar artículos | search_web | 5 |
| Extraer datos estructurados | scrape_structured | 2 |
| Rastrear un sitio de documentación de varias páginas | crawl_deep | 5 |
| Obtener metadatos de página | extract_metadata | 1 |
| Analizar el sentimiento del contenido | analyze_content | 3 |
Una sesión de desarrollo típica usa entre 10 y 30 credits. El plan Free (1.000 credits únicos) cubre la mayoría de las necesidades iniciales de los desarrolladores.
Solución de problemas
"MCP server not found": verifica que la ruta de instalación global esté en el PATH de tu sistema. Ejecuta which crawlforge-mcp-server para comprobarlo. Si no devuelve nada, reinstala con npm install -g crawlforge-mcp-server.
"Authentication failed": vuelve a comprobar tu API key en mcp_config.json. Las claves empiezan con cf_live_ para producción o cf_test_ para desarrollo.
Las herramientas no aparecen: reinicia Windsurf después de editar la configuración MCP. El servidor se carga al iniciar el IDE.
Respuestas lentas: las herramientas de CrawlForge que renderizan JavaScript (scrape_with_actions, stealth_mode) tardan entre 3 y 8 segundos. Las herramientas estáticas como fetch_url y extract_text responden en menos de 1 segundo.
Próximos pasos
Con CrawlForge configurado en Windsurf, explora estos flujos de trabajo:
- Usa el modo stealth para acceder a sitios con protección anti-bot
- Construye un flujo de trabajo de agente de investigación para análisis de mercado
- Explora la guía de inicio rápido de CrawlForge completa para ver las opciones de configuración MCP
- Consulta las 20 herramientas y sus capacidades
Dale a tu editor con IA acceso a la web en vivo. Empieza gratis con 1.000 credits, sin tarjeta de crédito.
