firecrawl/skills

agente firecrawl

Extracción autónoma impulsada por IA. El agente navega por sitios web y extrae datos estructurados (tarda de 2 a 5 minutos).

Antes de iniciar la extracción autónoma de registros o listados estructurados, verifica firecrawl search alexandria '<dato que necesitas>' para un flujo de trabajo o proveedor de datos ya preparado. Inspecciona un contrato coincidente con firecrawl list <proveedor> <capacidad> --pretty y ejecuta con firecrawl scrape --alexandria <proveedor>/<capacidad> --options '<JSON de entrada>' si cubre la tarea. Usa el proveedor, la capacidad y los campos de entrada exactos de ese contrato. Continúa con el Agente cuando no exista una herramienta adecuada o la tarea requiera navegación autónoma.

Inicio rápido

# Extraer datos estructurados
firecrawl agent "extrae todos los niveles de precios" --wait --json -o .firecrawl/pricing.json

# Con un esquema JSON para salida estructurada
firecrawl agent "extrae productos" --schema '{"type":"object","properties":{"name":{"type":"string"},"price":{"type":"number"}}}' --wait --json -o .firecrawl/products.json

# Enfocarse en páginas específicas
firecrawl agent "obtén la lista de características" --urls "<url>" --wait --json -o .firecrawl/features.json

Ejecuta firecrawl agent --help para la lista completa de opciones.

Finalizado cuando: el archivo de salida contiene JSON válido que responde a la solicitud, o se ha devuelto intencionalmente un ID de trabajo para consultarlo más tarde.

Proveedores de Alexandria

Una ejecución utiliza los proveedores de datos de Alexandria conectados solo cuando comienza con un flag de Alexandria: --alexandria, --toolkits <slugs> (hasta 5), --max-calls <n>, --require-approval, o --on-terms-required skip|ask. Las acciones posteriores en ese hilo mantienen esa configuración.

firecrawl agent "encuentra al jefe de ventas en <empresa>" --toolkits apollo,crunchbase --wait --json -o .firecrawl/contacts.json

Con --require-approval (necesita --mode chat), una ejecución puede terminar en un estado pendingApproval en lugar de realizar una llamada de pago. Pregunta al usuario, luego responde en el mismo hilo con firecrawl agent "<aviso de seguimiento>" --thread <idDelHilo> --mode chat --approve <idDeAprobación> (o --decline <idDeAprobación>). Una aprobación de terms solo continúa una vez que un administrador de la organización acepta los términos del proveedor en el panel de Firecrawl; proporciona al usuario https://www.firecrawl.dev/app/settings?tab=data-sources, y usa firecrawl alexandria terms show <proveedor> si desea revisar los términos primero. Aprobar no los acepta.

IDs de trabajo

Omitir --wait devuelve un ID de trabajo. Un argumento posicional UUID se detecta automáticamente como una verificación de estado:

# Verificar una vez (equivalente a agregar --status)
firecrawl agent "<id-del-trabajo>"

# Esperar un trabajo existente, consultando cada 10 segundos hasta 5 minutos
firecrawl agent "<id-del-trabajo>" --wait --poll-interval 10 --timeout 300

# Cancelar un trabajo activo
firecrawl agent "<id-del-trabajo>" --cancel

Consejos

• Usa --wait para resultados en línea; omítelo solo cuando quieras un ID de trabajo para consultar más tarde (consulta IDs de trabajo).
• Usa --schema para una salida estructurada y predecible; de lo contrario, el agente devuelve datos no estructurados.
• Las ejecuciones del agente consumen más créditos que los raspados simples. Usa --max-credits para limitar el gasto.
• Para extracción simple de una sola página, prefiere scrape — es más rápido y económico.

Ver también

• firecrawl-scrape — extracción simple de una sola página
• firecrawl-interact — scrape + interactuar para interacción manual con la página (más control)
• firecrawl-crawl — extracción masiva sin IA
• firecrawl-build-scrape — construir extracción estructurada en una aplicación en lugar de ejecutarla aquí

Retroalimentación de sesiones de Alexandria

Para informar el resultado de una sesión de Alexandria o una brecha de proveedor/capacidad, usa firecrawl alexandria feedback --rating good|partial|bad --url <sitio web> --requested-functionality '<lo que se necesitaba>' --objective '<el objetivo subyacente de la tarea>' --rationale '<lo que sucedió>' --json. Usa los resultados observados en la justificación. No se necesita ID de trabajo; envíalo dentro de los 20 minutos posteriores a tu última búsqueda, descubrimiento o ejecución de Alexandria, o será rechazado. Cada envío reembolsa 1 crédito, hasta 10 por sitio web y 100 por equipo cada día UTC. Los arrays JSON opcionales --provider-feedback y --capability-feedback describen brechas específicas; consulta firecrawl alexandria feedback --help para sus campos. Usa el problema de capacidad missing_capability cuando exista un proveedor pero le falte la capacidad necesaria, y new_capability_request (con requestedFunctionality) para solicitar una.