Cómo instalar CrawlForge MCP y usarlo en Claude Code: guía para principiantes

Si eres nuevo en Claude Code (el asistente de IA basado en terminal de Anthropic) y quieres darle el poder de hacer scraping de sitios web, buscar en la web y extraer contenido, estás en el lugar correcto. Esta guía amigable para principiantes te llevará por todo, desde la instalación hasta tu primer scrape web exitoso.

Lo que aprenderás

Al final de esta guía, serás capaz de:

• Instalar CrawlForge MCP en tu ordenador
• Configurar tu API key gratuita (1.000 credits incluidos)
• Configurar Claude Code para usar CrawlForge
• Ejecutar tus primeros comandos de web scraping

Tiempo necesario: Unos 5-10 minutos

¿Qué es CrawlForge MCP?

Antes de empezar, entendamos qué estamos instalando:

• CrawlForge es un servicio profesional de web scraping con 20 herramientas distintas
• MCP significa Model Context Protocol -- es la forma en que los asistentes de IA como Claude se conectan a herramientas externas
• Claude Code es el asistente de IA de línea de comandos de Anthropic que se ejecuta en tu terminal

Cuando conectas CrawlForge a Claude Code, simplemente puedes pedirle a Claude que "obtenga esta página web" o "busque información sobre X" y usará las herramientas de CrawlForge automáticamente.

Requisitos previos

Antes de empezar, asegúrate de tener:

1. Node.js 18 o superior instalado

   • Compruébalo ejecutando: node --version
   • Descárgalo desde nodejs.org si lo necesitas

2. Claude Code instalado

   • Si aún no lo tienes, instálalo con: npm install -g @anthropic-ai/claude-code

3. Una terminal/símbolo del sistema abierta

¡Eso es todo! Empecemos.

Paso 1: Instala CrawlForge MCP Server

Abre tu terminal y ejecuta este comando:

Qué hace esto:

• Descarga el paquete del CrawlForge MCP server
• Lo instala globalmente en tu ordenador (la opción -g)
• Lo hace disponible desde cualquier directorio

Deberías ver una salida como:

added 1 package in 2s

Paso 2: Configura tu API key

Ahora necesitamos obtener tu API key gratuita y configurarla. Ejecuta:

Este asistente de configuración interactivo:

1. Te preguntará si tienes una API key

   • Si sí: introdúcela cuando te lo pida
   • Si no: abrirá tu navegador para crear una cuenta gratuita

2. Te guiará para obtener tu API key gratuita

   • Ve a crawlforge.dev/signup
   • Crea tu cuenta (sin tarjeta de crédito)
   • Recibirás 1.000 credits gratis al instante
   • Copia tu API key (empieza por cf_live_)

3. Configurará tus credenciales de forma segura

   • La configuración guarda tu API key en ~/.crawlforge/config.json
   • Esto la mantiene segura y separada de tus proyectos

4. Verificará que todo funciona

   • La configuración prueba tu conexión para confirmar que está lista

Alternativa: configuración manual

Si prefieres configurarlo manualmente, puedes:

Opción A: variable de entorno

Opción B: archivo de configuración

Crea ~/.crawlforge/config.json:

Paso 3: Configura Claude Code

Ahora necesitamos informar a Claude Code sobre CrawlForge. Hay dos formas de hacerlo:

Método 1: añadir a la configuración de Claude Code (recomendado)

Ejecuta Claude Code y usa el comando /mcp para añadir el servidor:

Esto añade CrawlForge a tu configuración de Claude Code automáticamente.

Método 2: editar el archivo de configuración

También puedes editar manualmente la configuración MCP de Claude Code. La ubicación del archivo de configuración depende de tu sistema operativo:

macOS:

~/.config/claude/mcp_servers.json

Windows:

%APPDATA%\claude\mcp_servers.json

Linux:

~/.config/claude/mcp_servers.json

Añade esta configuración:

Paso 4: Reinicia Claude Code

Para que los cambios surtan efecto, reinicia Claude Code:

1. Si Claude Code está en ejecución, sal de él (escribe exit o pulsa Ctrl+C)
2. Vuelve a iniciarlo:

Deberías ver CrawlForge listado en las herramientas MCP disponibles.

Paso 5: ¡Tu primer scrape web!

Ahora viene lo divertido -- ¡vamos a probarlo! Inicia Claude Code y prueba estos comandos:

Ejemplo 1: obtener una página web simple

Fetch the content from https://example.com

Claude usará la herramienta fetch_url (1 credit) y te mostrará el contenido HTML.

Ejemplo 2: extraer texto limpio

Extract the main text content from https://news.ycombinator.com

Claude usará extract_text (1 credit) para obtener texto limpio y legible sin etiquetas HTML.

Ejemplo 3: obtener todos los enlaces de una página

List all the links on https://crawlforge.dev

Claude usará extract_links (1 credit) para encontrar y listar todos los enlaces.

Ejemplo 4: buscar en la web

Search the web for "best practices for web scraping in 2026"

Claude usará search_web (5 credits) para encontrar resultados relevantes.

Ejemplo 5: investigación profunda

Research the latest developments in AI and summarize your findings

Claude usará deep_research (10 credits) para buscar en múltiples fuentes, verificar la información y sintetizar una respuesta completa.

Entender los credits

CrawlForge usa un sistema basado en credits. Cada herramienta cuesta un cierto número de credits:

Tu cuenta gratuita incluye 1.000 credits -- suficiente para:

• 1.000 obtenciones de páginas básicas, O
• 100 consultas de investigación profunda, O
• Una mezcla de distintas operaciones

Consejo profesional: ¡Empieza con herramientas básicas como fetch_url y extract_text para conservar credits mientras aprendes!

Las 20 herramientas disponibles

Esto es lo que puedes hacer con CrawlForge:

Herramientas básicas (1 credit cada una)

• fetch_url - Obtén el HTML en bruto de cualquier URL
• extract_text - Extrae texto limpio sin HTML
• extract_links - Obtén todos los enlaces de una página
• extract_metadata - Obtén metadatos SEO, etiquetas Open Graph, etc.

Herramientas de contenido (2-3 credits)

• scrape_structured - Extrae datos usando selectores CSS
• extract_content - Extracción inteligente de artículos/contenido principal
• summarize_content - Resumen impulsado por IA
• analyze_content - Análisis de sentimiento, idioma y temas

Herramientas de sitio (2-5 credits)

• map_site - Descubre todas las páginas de un sitio web
• crawl_deep - Rastrea múltiples páginas con control de profundidad
• batch_scrape - Procesa muchas URLs a la vez

Herramientas de investigación (5-10 credits)

• search_web - Búsqueda web vía Google/DuckDuckGo
• deep_research - Investigación multietapa con verificación

Herramientas avanzadas (3-10 credits)

• stealth_mode - Navegación con anti-detección
• scrape_with_actions - Automatización del navegador (clics, formularios)
• process_document - Extrae texto de PDFs
• localization - Scraping con geolocalización
• track_changes - Detecta cambios de contenido en páginas monitorizadas

Solución de problemas

"Command not found: npx"

Asegúrate de que Node.js esté instalado:

Si no, descárgalo desde nodejs.org.

"API key not found"

Ejecuta la configuración de nuevo:

O comprueba manualmente tu archivo de configuración en ~/.crawlforge/config.json.

"Insufficient credits"

Consulta tu saldo en crawlforge.dev/dashboard. Puedes:

• Subir a un plan de pago para obtener más credits
• Comprar packs de credits adicionales

Claude Code no ve CrawlForge

1. Asegúrate de haber reiniciado Claude Code tras la configuración
2. Comprueba que el MCP server esté configurado correctamente
3. Prueba a ejecutar npx crawlforge-mcp-server manualmente para ver si hay errores

¿Qué sigue?

Ahora que tienes CrawlForge configurado, aquí van algunas ideas:

1. Construye un flujo de investigación - Pídele a Claude que investigue temas y elabore informes
2. Monitoriza a la competencia - Rastrea cambios en los sitios de competidores
3. Recopila datos - Extrae información de productos, precios o reseñas
4. Crea contenido - Reúne información para publicaciones de blog o documentación

Planes de precios

Cuando necesites más credits:

¡Los credits nunca caducan y se acumulan de mes a mes en los planes de pago!

¿Necesitas ayuda?

• Documentación: crawlforge.dev/docs
• GitHub Issues: github.com/mysleekdesigns/crawlforge-mcp/issues
• Email: support@crawlforge.dev
• Discord: Únete a nuestra comunidad

---

¿Listo para empezar? Tienes 1.000 credits gratis esperándote en crawlforge.dev/signup. ¡Feliz scraping!