En esta página
La API de Claude de Anthropic admite el uso nativo de herramientas: defines herramientas con esquemas JSON y Claude decide cuándo invocarlas durante una conversación. Las 20 herramientas de web scraping de CrawlForge encajan de forma natural: le dan a Claude la capacidad de buscar en la web, extraer contenido, hacer scraping de datos estructurados y realizar investigaciones profundas, todo a través de la API estándar de tool_use.
Esta guía te lleva paso a paso por la definición de las herramientas de CrawlForge para la API de Claude, el manejo de las respuestas de uso de herramientas y la creación de un asistente de investigación de nivel de producción.
Tabla de contenidos
- Requisitos previos
- Cómo funciona el uso de herramientas de Claude con CrawlForge
- Paso 1: define los esquemas de herramientas de CrawlForge
- Paso 2: maneja el bucle de uso de herramientas
- Paso 3: crea un asistente de investigación
- Avanzado: streaming con uso de herramientas
- Desglose de costo en credits
- Buenas prácticas
- Preguntas frecuentes
- Próximos pasos
Requisitos previos
Obtén tu API key de CrawlForge en crawlforge.dev/signup: incluye 1,000 credits gratis. Para acceder a la API de Claude, visita console.anthropic.com y sigue la guía de primeros pasos de la API.
Cómo funciona el uso de herramientas de Claude con CrawlForge
El uso de herramientas de Claude sigue un bucle de petición-respuesta:
- Envías un mensaje con las definiciones de herramientas y un prompt del usuario
- Claude responde con texto o con un bloque de contenido
tool_use - Ejecutas la herramienta (llamas a la API de CrawlForge) y devuelves el resultado
- Claude incorpora el resultado y continúa su respuesta
You -> Claude: "What's on the Hacker News front page?"
Claude -> You: tool_use { name: "extract_content", input: { url: "https://news.ycombinator.com" } }
You -> CrawlForge: POST /api/v1/tools/extract_content { url: "..." }
CrawlForge -> You: { content: "..." }
You -> Claude: tool_result { content: "..." }
Claude -> You: "Here are the top stories on Hacker News right now: ..."
Paso 1: define los esquemas de herramientas de CrawlForge
Define las herramientas que Claude puede usar. Cada herramienta necesita un name, una description y un input_schema (formato JSON Schema):
Paso 2: maneja el bucle de uso de herramientas
El patrón central: envía mensajes a Claude, comprueba si quiere usar una herramienta, ejecuta la herramienta a través de CrawlForge y devuelve el resultado.
Este bucle maneja el uso de herramientas en varios pasos de forma automática. Claude podría buscar, luego extraer contenido de un resultado y después buscar de nuevo: el bucle continúa hasta que produce una respuesta de texto final.
Paso 3: crea un asistente de investigación
Envuelve el agente en una aplicación más estructurada:
Avanzado: streaming con uso de herramientas
Para una mejor experiencia de usuario, usa streaming para mostrar el razonamiento de Claude en tiempo real:
Desglose de costo en credits
| Flujo | Herramientas usadas | Credits |
|---|---|---|
| Respuesta rápida (1 página) | extract_content | 2 |
| Buscar + leer el primer resultado | search_web + extract_content | 7 |
| Investigación a fondo (3 fuentes) | search_web + 3x extract_content | 11 |
| Extracción de datos estructurados | scrape_structured | 2 |
| Comprobación de metadatos de página | extract_metadata | 1 |
| Obtención de HTML en bruto | fetch_url | 1 |
| Informe profundo multifuente | deep_research | 10 |
El nivel Free (1,000 credits únicos) admite aproximadamente 140 extracciones de una sola página o 90 flujos de buscar y leer para empezar. El plan Hobby ($19/mes, 5,000 credits) es ideal para desarrollo y uso ligero en producción.
Buenas prácticas
Escribe descripciones de herramientas descriptivas. Claude usa el campo description para decidir qué herramienta llamar. Incluye qué hace la herramienta, cuándo usarla y su costo en credits. "Extract the main readable content from a web page" es mejor que "Get content".
Incluye el costo en credits en las descripciones. Cuando Claude sabe que fetch_url cuesta 1 credit y deep_research cuesta 10, elige de forma natural la opción más barata para tareas sencillas.
Maneja los errores con elegancia. Devuelve los mensajes de error como resultados de herramienta en lugar de lanzar excepciones. Claude puede adaptar su estrategia cuando una herramienta falla: por ejemplo, probar una URL distinta o reformular una búsqueda.
Configura max_tokens de forma adecuada. El contenido web puede ser largo. Configura max_tokens en al menos 4096 para darle a Claude espacio para incorporar los resultados de las herramientas en respuestas completas.
Usa system prompts para guiar el uso de herramientas. Indícale a Claude cuándo buscar y cuándo acceder directamente a una URL conocida. Esto evita llamadas innecesarias a search_web (5 credits) cuando bastaría con un extract_content directo (2 credits).
Preguntas frecuentes
¿Puedo usar CrawlForge con Claude 3.5 Haiku para reducir costos?
Sí. Todos los modelos de Claude que admiten uso de herramientas funcionan con las herramientas de CrawlForge. Haiku es más barato por token, pero puede necesitar instrucciones más explícitas para elegir la herramienta correcta. Claude Sonnet ofrece el mejor equilibrio entre costo y precisión en el uso de herramientas.
¿Cómo manejo los límites de velocidad?
La API de CrawlForge incluye cabeceras de límite de velocidad (X-RateLimit-Remaining). Si recibes una respuesta 429, añade un reintento con retroceso exponencial. Para uso de alto volumen, el plan Professional incluye límites de velocidad más altos.
¿Puede Claude llamar a varias herramientas de CrawlForge en un solo turno?
Sí. Claude puede solicitar el uso de varias herramientas en una sola respuesta. El bucle de uso de herramientas del Paso 2 lo maneja: itera sobre todos los bloques tool_use y devuelve todos los resultados a la vez.
¿Qué ocurre cuando se acaban los credits de CrawlForge?
La API devuelve un error 402 Payment Required. Devuélvelo como resultado de herramienta para que Claude pueda informar al usuario. Puedes comprobar los credits restantes a través del dashboard o del endpoint de credits de la API.
Próximos pasos
Ahora tienes una aplicación impulsada por Claude con acceso web en vivo. Explora más:
- Inicio rápido de CrawlForge para la integración nativa de MCP con Claude Code
- Las 20 herramientas explicadas con costos en credits y ejemplos de uso
- Crear un asistente de investigación con IA con Claude y CrawlForge
- Comparativa CrawlForge vs Firecrawl para elegir la herramienta adecuada
Dale a Claude acceso a la web en vivo. Empieza gratis con 1,000 credits: sin tarjeta de crédito.
