Cómo usar CrawlForge con Windsurf IDE

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 31 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:

npm install -g crawlforge-mcp-server

Verifica la instalación:

crawlforge-mcp-server --version

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:

# Open or create the MCP config
code ~/.windsurf/mcp_config.json

Windows:

code %APPDATA%\Windsurf\mcp_config.json

Añade el servidor CrawlForge al objeto mcpServers:

// ~/.windsurf/mcp_config.json
{
  "mcpServers": {
    "crawlforge": {
      "command": "crawlforge-mcp-server",
      "args": [],
      "env": {
        "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here"
      }
    }
  }
}

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):

// .windsurf/mcp_config.json
{
  "mcpServers": {
    "crawlforge": {
      "command": "crawlforge-mcp-server",
      "args": [],
      "env": {
        "CRAWLFORGE_API_KEY": "${CRAWLFORGE_API_KEY}"
      }
    }
  }
}

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:

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:

Cascade listará las 31 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:

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

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

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

Usa extract_content para leer la página y filtra por fecha. Costo: 2 credits.

Desglose de costos en credits

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:

• Referencia completa de configuración: Integración con Windsurf en la documentación de CrawlForge
• 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 31 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.