Preguntas Frecuentes

CrawlForge MCP es una plataforma integral de scraping web que ofrece 23 herramientas especializadas para extraer datos de sitios web. Está diseñada para aplicaciones de IA y es compatible con el Model Context Protocol (MCP), lo que la hace perfecta para usar con Claude, Cursor y otras herramientas de IA.

Las funciones principales incluyen:

• 23 potentes herramientas de scraping (fetch_url, deep_research, stealth_mode, etc.)
• Precios basados en credits con costos predecibles
• Compatibilidad con API RESTful y el protocolo MCP
• Nivel gratuito con 1,000 credits de prueba por única vez
• Seguridad y fiabilidad de nivel empresarial

Comenzar es sencillo y lleva menos de 5 minutos:

1. Regístrese: Cree una cuenta gratuita en crawlforge.dev/signup
2. Obtenga su clave de API: Vaya a Panel → Configuración y genere su clave de API
3. Realice su primera solicitud: Use la clave de API para llamar a cualquiera de nuestras 23 herramientas

¡Comenzará con 1,000 credits gratis, sin tarjeta de crédito!

Consulte nuestra guía de primeros pasos para obtener instrucciones detalladas.

El nivel gratuito incluye:

• 1,000 credits de prueba por única vez (no se reinician mensualmente)
• Acceso a las 23 herramientas (las mismas funciones que en los planes de pago)
• Límite de tasa: 2 solicitudes por segundo
• Retención de datos: 30 días de registros de uso
• Soporte: soporte de la comunidad a través de Discord y la documentación

Perfecto para pruebas, proyectos pequeños y prototipos. No se requiere tarjeta de crédito para registrarse.

Ver todos los planes →

El Model Context Protocol (MCP) es un estándar abierto creado por Anthropic para permitir una comunicación fluida entre las aplicaciones de IA y las fuentes de datos externas. Permite que modelos de IA como Claude accedan directamente a herramientas de scraping web sin necesidad de integración manual de la API.

Ventajas de MCP:

• Use las herramientas de CrawlForge directamente en Claude Desktop, Cursor y otras aplicaciones compatibles con MCP
• No se requiere código: solo instrucciones en lenguaje natural
• Selección automática de herramientas según sus necesidades
• Interfaz estandarizada en todos los MCP servers

Obtenga más información en nuestra guía del protocolo MCP.

Aquí tiene un ejemplo sencillo con la herramienta fetch_url (1 credit):

O con TypeScript:

Consulte nuestra guía de primeros pasos para ver más ejemplos.

Para generar una clave de API:

1. Inicie sesión en su cuenta
2. Vaya a Panel → Configuración
3. Desplácese hasta la sección "API Keys"
4. Haga clic en "Generate New API Key"
5. Asigne a su clave un nombre descriptivo (p. ej., "Production", "Development")
6. Copie la clave de inmediato: ¡no se volverá a mostrar!

CrawlForge MCP admite la autenticación con clave de API mediante el encabezado X-API-Key:

Formato de la clave de API:

• cf_test_... - Entorno de prueba (desarrollo)
• cf_live_... - Entorno de producción

Todas las solicitudes deben realizarse a través de HTTPS. Las solicitudes HTTP serán rechazadas.

Los límites de tasa varían según el plan:

Cuando alcance el límite de tasa, recibirá una respuesta 429 Too Many Requests.

CrawlForge MCP usa códigos de estado HTTP estándar:

• 200 OK: La solicitud se realizó correctamente
• 400 Bad Request: Parámetros no válidos o campos obligatorios faltantes
• 401 Unauthorized: Clave de API faltante o no válida
• 402 Payment Required: Credits insuficientes
• 429 Too Many Requests: Límite de tasa superado
• 500 Internal Server Error: Error del lado del servidor (lo investigaremos)

Ejemplo de respuesta de error:

Implemente lógica de reintentos con retroceso exponencial para los errores 429 y 500. Consulte nuestra guía de gestión de errores.

¡Sí! CrawlForge MCP funciona perfectamente con funciones sin servidor en Vercel, AWS Lambda, Cloudflare Workers y más.

Consejos para entornos sin servidor:

• Establezca tiempos de espera adecuados (la mayoría de las herramientas responden en 200-500 ms)
• Use variables de entorno para las claves de API
• Implemente la agrupación de conexiones para aplicaciones de alto volumen
• Considere usar batch_scrape para múltiples URL

Ejemplo para Vercel Edge Functions:

Los credits son la unidad de uso en CrawlForge MCP. Cada herramienta cuesta una cantidad específica de credits por solicitud:

• 1 credit: Herramientas básicas (fetch_url, extract_text, extract_links, extract_metadata)
• 2 credits: Extracción estructurada (scrape_structured, extract_content, map_site)
• 3-4 credits: Procesamiento avanzado (analyze_content, track_changes, extract_structured, summarize_content)
• 5 credits: Automatización del navegador (scrape_with_actions, search_web, stealth_mode, batch_scrape, generate_llms_txt)
• 10 credits: Investigación profunda (agregación de múltiples fuentes)

Los credits se descuentan únicamente en las solicitudes exitosas. Las solicitudes fallidas no consumen credits.

Consulte el desglose completo en nuestra guía de optimización de credits.

Las recargas de credits dependen de su plan:

• Plan Free: 1,000 credits de prueba por única vez (sin recarga mensual; actualice a un plan de pago para obtener credits mensuales)
• Planes de pago: Los credits se recargan en su fecha de facturación (el día en que se suscribió o actualizó)

Ejemplo: si actualizó a Hobby el 15 de enero, recibirá 5,000 credits el día 15 de cada mes.

Buenas noticias: ¡Los credits no utilizados se trasladan al mes siguiente, así que nunca pierde los credits que ha pagado!

Puede consultar su saldo de credits y la próxima fecha de recarga en su panel.

¡Los credits no utilizados se trasladan al mes siguiente! Su saldo restante se acumula cuando recibe su asignación mensual.

Ejemplo:

• Tiene el plan Hobby (5,000 credits/mes)
• Usó 3,000 credits este mes, dejando 2,000 sin utilizar
• En su fecha de recarga, tendrá 7,000 credits (2,000 + 5,000)

CrawlForge MCP usa Stripe para el procesamiento seguro de pagos:

1. Suscríbase: Haga clic en "Upgrade" en la página de precios
2. Introduzca los datos de pago: Stripe gestiona toda la información de pago de forma segura
3. Facturación automática: Se le cobrará mensualmente en la fecha de su suscripción
4. Activación instantánea: Los credits se añaden de inmediato tras un pago exitoso

Aceptamos:

• Tarjetas de crédito (Visa, Mastercard, American Express)
• Tarjetas de débito
• Apple Pay y Google Pay
• Transferencias bancarias (solo plan Business)

Puede cancelar o cambiar su plan en cualquier momento desde su panel.

Según los datos de uso, las 5 herramientas más populares son:

1. fetch_url (1 credit) - Obtención básica de páginas, la más rápida y económica
2. extract_text (1 credit) - Extracción de texto limpio sin HTML
3. scrape_structured (2 credits) - Extraiga datos específicos con selectores CSS
4. deep_research (10 credits) - Investigación y agregación de múltiples fuentes
5. stealth_mode (5 credits) - Evada la detección anti-bots

Vea las 23 herramientas en la referencia de la API.

Use batch_scrape cuando:

• Necesite hacer scraping de 3 o más URL a la vez
• Quiera paralelizar las solicitudes para obtener un mejor rendimiento
• Esté dispuesto a intercambiar credits por velocidad (50% más rápido en promedio)

Use solicitudes individuales cuando:

• Solo necesite 1 o 2 URL
• Necesite procesar los resultados de forma secuencial
• Quiera una gestión de errores más granular

Comparación de costos:

• Individual: 10 URL × 1 credit = 10 credits, ~5 segundos (secuencial)
• Por lotes: 10 URL × 1 credit = 10 credits, ~1 segundo (paralelo)

Consulte nuestra guía de procesamiento por lotes para ver ejemplos.

Use scrape_with_actions cuando:

• El contenido se carga mediante JavaScript (SPA, aplicaciones de React, Vue, Angular)
• Necesite interactuar con la página (hacer clic en botones, rellenar formularios, desplazarse)
• El contenido requiera autenticación (flujos de inicio de sesión)
• Las páginas usen scroll infinito o carga diferida

No lo use cuando:

• La página sirve HTML estático (use fetch_url por 1 credit en lugar de 5)
• Haya un endpoint de API disponible (use fetch_url)
• Solo necesite una extracción de texto básica

Obtenga más información en nuestra guía de scraping avanzado.

Está alcanzando el límite de tasa de su plan. Esto ocurre cuando envía demasiadas solicitudes con demasiada rapidez.

Soluciones:

• Implemente lógica de reintentos: Espere 1-2 segundos y reintente con retroceso exponencial
• Use batch_scrape: Agrupe varias URL en una sola solicitud
• Añada retrasos: Espacie sus solicitudes (p. ej., 500 ms entre llamadas en el plan Free)
• Actualice su plan: Los planes superiores tienen límites de tasa más altos

Ejemplo de lógica de reintentos:

Problemas de conexión comunes y soluciones:

1. Clave de API no válida (error 401):
   • Verifique que su clave de API sea correcta (compruebe que no haya errores tipográficos)
   • Asegúrese de usar el encabezado X-API-Key (no Authorization)
   • Regenere su clave de API si es necesario
2. Errores de CORS (navegador):
   • Las llamadas a la API desde navegadores no son compatibles (riesgo de seguridad)
   • Realice las llamadas a la API desde su backend o sus funciones sin servidor en su lugar
   • Nunca exponga las claves de API en el código del lado del cliente
3. Errores de SSL/TLS:
   • Asegúrese de usar https:// y no http://
   • Actualice sus certificados SSL si usa un entorno antiguo
4. Tiempos de espera de red:
   • Compruebe la configuración de su firewall o proxy
   • Aumente el tiempo de espera de la solicitud (la mayoría de las herramientas responden en <500 ms)

¿Sigue teniendo problemas? Consulte nuestra página de estado o contacte con el soporte.