Claude Desktop
Integración con Claude Desktop
Habilite el web scraping en Claude Desktop con CrawlForge MCP. Configuración completa en menos de 5 minutos con un sencillo archivo de configuración JSON.
Requisitos previos
1
Instalar el servidor de CrawlForge MCP
Instale el paquete del servidor de CrawlForge MCP globalmente con npm.
Bash
Verificar la instalación: Ejecute
crawlforge --version para confirmar la instalación. La instalación global agrega dos lanzadores de servidor —crawlforge-mcp y crawlforge-mcp-server— además del CLI crawlforge.2
Obtener su API key
Regístrese para obtener una cuenta gratuita y genere su API key.
- Cree una cuenta gratuita — Obtenga 1.000 credits gratis, sin tarjeta de crédito. Regístrese gratis
- Vaya a API Keys — Diríjase a Dashboard → API Keys
- Genere una nueva clave — Haga clic en "Create API Key" y copie la clave (empieza con
cf_)
Seguridad: Nunca comparta su API key ni la incluya en el control de versiones. Guárdela de forma segura.
3
Configurar Claude Desktop
Agregue CrawlForge MCP al archivo de configuración de Claude Desktop.
macOS
Abra el archivo de configuración en:
Bash
Agregue la siguiente configuración:
Json
Windows
Abra el archivo de configuración en:
Bash
Agregue la siguiente configuración:
Json
Linux
Abra el archivo de configuración en:
Bash
Agregue la siguiente configuración:
Json
¿Dónde está la API key? Esta configuración no tiene una clave en línea: el servidor lee las credenciales que
npx crawlforge-setup guardó en ~/.crawlforge/config.json. Si instaló globalmente, también puede usar "command": "crawlforge-mcp" (sin args) en lugar de npx: se resuelve en su PATH y sobrevive a los cambios de versión de Node/nvm.4
Reiniciar y probar
Reinicie Claude Desktop y pruebe la integración.
- Reinicie Claude Desktop — Cierre por completo y vuelva a abrir la aplicación
- Abra una nueva conversación — Inicie un chat nuevo para cargar el servidor MCP
- Pruebe con un prompt sencillo — Pruebe: "Usa CrawlForge para obtener https://example.com"
Ejemplos de prompts
"Obtén el contenido de https://example.com"
"Extrae todos los enlaces de https://example.com"
"Obtén los metadatos de https://example.com"
Herramientas disponibles
Después de la configuración, Claude tendrá acceso a las 23 herramientas de CrawlForge MCP:
| Herramienta | Descripción | Credits |
|---|---|---|
| fetch_url | Obtenga HTML de URLs | 1 credits |
| extract_text | Extraiga texto limpio | 1 credits |
| extract_links | Extraiga todos los enlaces | 1 credits |
| extract_metadata | Obtenga metadatos de la página | 1 credits |
| scrape_structured | Extracción con selectores CSS | 2 credits |
| batch_scrape | Scrapeo por lotes en paralelo | 1/URL |
| deep_research | Investigación con IA | 10 credits |
| search_web | Integración de búsqueda de Google | 5 credits |
Consulte la referencia de la API completa para ver las 23 herramientas y sus parámetros.
Solución de problemas
¿Las herramientas no aparecen?
- Verifique que la ruta del archivo de configuración sea correcta para su sistema operativo
- Compruebe que la sintaxis JSON sea válida (use un validador de JSON)
- Asegúrese de que Node.js 18+ esté instalado:
node --version - Reinicie Claude Desktop por completo (no solo cerrar la ventana)
¿Errores de autenticación?
- Verifique que la API key empiece con
cf_ - Compruebe que no haya espacios o comillas alrededor de la API key
- Genere una nueva API key desde el panel
- Asegúrese de que la clave no se haya eliminado ni haya caducado
¿Problemas con el límite de tasa?
- Revise los límites de tasa de su plan en el panel
- Plan Free: 2 solicitudes/segundo, 1.000 credits en total
- Actualice a un plan de pago para obtener límites más altos
- Espere unos segundos entre solicitudes si alcanza los límites de tasa
¿Sigue teniendo problemas? Contacte con soporte en support@crawlforge.dev indicando su mensaje de error y su archivo de configuración (elimine la API key antes de enviarlo).
¿Integración completada con éxito?
Explore todas las herramientas disponibles y empiece a crear con web scraping impulsado por IA.