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
npm install -g crawlforge-mcp-serverLas dependencias, incluida crawlforge-extractors, se instalan automáticamente.
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.
- 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_)
Nunca comparta su API key ni la incluya en el control de versiones. Guárdela de forma segura.
macOS
Abra el archivo de configuración en:
~/Library/Application Support/Claude/claude_desktop_config.jsonAgregue la siguiente configuración:
{
"mcpServers": {
"crawlforge": {
"command": "npx",
"args": ["-y", "crawlforge-mcp-server"]
}
}
}Windows
Abra el archivo de configuración en:
%APPDATA%\Claude\claude_desktop_config.jsonAgregue la siguiente configuración:
{
"mcpServers": {
"crawlforge": {
"command": "npx.cmd",
"args": ["-y", "crawlforge-mcp-server"]
}
}
}Linux
Abra el archivo de configuración en:
~/.config/Claude/claude_desktop_config.jsonAgregue la siguiente configuración:
{
"mcpServers": {
"crawlforge": {
"command": "npx",
"args": ["-y", "crawlforge-mcp-server"]
}
}
}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.
- 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 31 herramientas de CrawlForge MCP:
| Herramienta | Descripción | Credits |
|---|---|---|
| fetch_url | Obtenga HTML de URLs | 1 credit |
| extract_text | Extraiga texto limpio | 1 credit |
| extract_links | Extraiga todos los enlaces | 1 credit |
| extract_metadata | Obtenga metadatos de la página | 1 credit |
| 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 | Búsqueda web en vivo | 5 credits |
Consulte la referencia de la API completa para ver las 31 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
Contacte con soporte en simon@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.