` | Código de país ISO (predeterminado: US) |
| `--timeout ` | Tiempo máximo de espera en milisegundos (predeterminado: 60000) |
| `--ignore-invalid-urls` | Excluir URLs no válidas para otros endpoints de Firecrawl |
| `--scrape` | Hacer scraping de resultados de búsqueda |
| `--scrape-formats ` | formatos para contenido obtenido mediante scraping |
| `--only-main-content` | Incluir solo el contenido principal al scraping (predeterminado: true) |
| `--json` | Salida como JSON |
| `--output ` | Guardar la salida en un archivo |
| `--pretty` | Imprimir salida JSON con formato legible |
***
### Desarrollador
Busca en el [Índice para desarrolladores](/es/features/developer): issues, pull requests fusionadas y archivos README de repositorios de código públicos, además de sitios de documentación seleccionados.
```bash CLI theme={null}
firecrawl developer "how do I configure retries" --limit 10
```
**Opciones disponibles:**
| Opción | Descripción |
| - | - |
| `--limit ` | Número de resultados que se devolverán (predeterminado: 10, máx.: 100) |
| `--skills-only` | Busca solo archivos de skills de agentes indexados (predeterminado: false) |
| `--json` | Muestra la salida como JSON compacto |
| `--output ` | Guarda la salida en un archivo |
| `--pretty` | Formatea la salida JSON para facilitar su lectura |
***
### Map
Obtén rápidamente todas las URL de un sitio web.
```bash CLI theme={null}
# Descubre todas las URLs de un sitio web
firecrawl map https://example.com
# Output as JSON
firecrawl map https://example.com --json
# Limit number of URLs
firecrawl map https://example.com --limit 500
```
#### Opciones de mapeo
```bash CLI theme={null}
# Filter URLs by search query
firecrawl map https://example.com --search "blog"
# Include subdomains
firecrawl map https://example.com --include-subdomains
# Control sitemap usage
firecrawl map https://example.com --sitemap include # Use sitemap
firecrawl map https://example.com --sitemap skip # Skip sitemap
firecrawl map https://example.com --sitemap only # Solo usar sitemap
# Ignore query parameters (dedupe URLs)
firecrawl map https://example.com --ignore-query-parameters
# Wait for map to complete with timeout
firecrawl map https://example.com --wait --timeout 60
# Save to file
firecrawl map https://example.com -o urls.txt
firecrawl map https://example.com --json --pretty -o urls.json
```
**Opciones disponibles:**
| Opción | Descripción |
| - | - |
| `--url ` | URL que se va a mapear (alternativa al argumento posicional) |
| `--limit ` | Número máximo de URLs a descubrir |
| `--search ` | Filtrar URLs por consulta de búsqueda |
| `--sitemap ` | Manejo del sitemap: `include`, `skip`, `only` |
| `--include-subdomains` | Incluir subdominios |
| `--ignore-query-parameters` | Tratar URLs con distintos parámetros de consulta como la misma |
| `--wait` | Esperar a que finalice el mapeo |
| `--timeout ` | Tiempo de espera en segundos |
| `--json` | Salida en formato JSON |
| `--output ` | Guardar la salida en un archivo |
| `--pretty` | Imprimir la salida JSON con formato legible |
***
### Interact
Haz scraping de una página y luego interactúa con ella usando lenguaje natural o código. Interact usa el scraping más reciente de forma predeterminada, o puedes pasar un ID de scraping específico.
```bash CLI theme={null}
# 1. Scrape la página principal de Amazon (el ID de scrape se guarda automáticamente)
firecrawl scrape https://www.amazon.com
# 2. Interactúa — busca un producto y obtén su precio
firecrawl interact "Search for iPhone 16 Pro Max"
firecrawl interact "Click on the first result and tell me the price"
# 3. Detén la sesión
firecrawl interact stop
```
**Opciones disponibles:**
| Opción | Descripción |
| - | - |
| `-p, --prompt ` | Prompt de IA (alternativa al argumento posicional) |
| `-c, --code ` | Código que se ejecutará en la sesión activa de la página |
| `-s, --scrape-id ` | ID de trabajo de scraping (predeterminado: último scraping) |
| `--python` | Ejecuta el código como Python/Playwright |
| `--node` | Ejecuta el código como Node.js/Playwright (predeterminado) |
| `--bash` | Ejecuta el código como Bash |
| `--timeout ` | Timeout en segundos (1-300, predeterminado: 30) |
| `--output ` | Guarda la salida en un archivo |
| `--json` | Salida en formato JSON |
***
### Rastrear
Rastrea todo un sitio web a partir de una URL.
```bash CLI theme={null}
# Iniciar un rastreo (devuelve el ID del trabajo inmediatamente)
firecrawl crawl https://example.com
# Wait for crawl to complete
firecrawl crawl https://example.com --wait
# Wait with progress indicator
firecrawl crawl https://example.com --wait --progress
```
#### Consultar el estado del rastreo
```bash CLI theme={null}
# Verificar estado del crawl usando el ID del trabajo
firecrawl crawl
# Ejemplo con un ID de trabajo real
firecrawl crawl 550e8400-e29b-41d4-a716-446655440000
```
#### Opciones de rastreo
```bash CLI theme={null}
# Limit crawl depth and pages
firecrawl crawl https://example.com --limit 100 --max-depth 3 --wait
# Include only specific paths
firecrawl crawl https://example.com --include-paths /blog,/docs --wait
# Exclude specific paths
firecrawl crawl https://example.com --exclude-paths /admin,/login --wait
# Include subdomains
firecrawl crawl https://example.com --allow-subdomains --wait
# Crawl entire domain
firecrawl crawl https://example.com --crawl-entire-domain --wait
# Rate limiting
firecrawl crawl https://example.com --delay 1000 --max-concurrency 2 --wait
# Pasar opciones de scraping a cada página rastreada
firecrawl crawl https://example.com --scrape-options '{"formats":["markdown"],"onlyMainContent":true}'
# Enviar eventos de finalización de rastreo a un webhook
firecrawl crawl https://example.com --webhook '{"url":"https://example.com/webhook","events":["completed"]}'
# Cancelar un rastreo activo
firecrawl crawl --cancel
# Intervalo de consulta y tiempo de espera personalizados
firecrawl crawl https://example.com --wait --poll-interval 10 --timeout 300
# Save results to file
firecrawl crawl https://example.com --wait --pretty -o results.json
```
**Opciones disponibles:**
| Opción | Descripción |
| - | - |
| `--url ` | URL a rastrear (alternativa al argumento posicional) |
| `--wait` | Esperar a que el rastreo termine |
| `--progress` | Mostrar indicador de progreso mientras se espera |
| `--poll-interval ` | Intervalo de sondeo (por defecto: 5) |
| `--timeout ` | Tiempo máximo de espera |
| `--status` | Consultar el estado de un trabajo de rastreo existente |
| `--limit ` | Número máximo de páginas a rastrear |
| `--max-depth ` | Profundidad máxima de rastreo |
| `--include-paths ` | Rutas a incluir (separadas por comas) |
| `--exclude-paths ` | Rutas a excluir (separadas por comas) |
| `--sitemap ` | Manejo del sitemap: `include`, `skip`, `only` |
| `--allow-subdomains` | Incluir subdominios |
| `--allow-external-links` | Seguir enlaces externos |
| `--crawl-entire-domain` | Rastrear todo el dominio |
| `--ignore-query-parameters` | Considerar URLs con distintos parámetros como iguales |
| `--delay ` | Retraso entre solicitudes |
| `--max-concurrency ` | Número máximo de solicitudes concurrentes |
| `--scrape-options ` | Opciones de scraping en JSON que se pasan a cada página |
| `--scrape-options-file ` | Ruta al archivo JSON de opciones de scraping |
| `--webhook ` | URL o configuración del webhook |
| `--cancel` | Cancelar un trabajo de rastreo activo mediante el ID de trabajo |
| `--output ` | Guardar el resultado en un archivo |
| `--pretty` | Imprimir la salida JSON con formato legible |
***
### Monitor
Crea scrapes o crawls recurrentes que calculen las diferencias de cada ejecución con respecto a la instantánea anterior. Añade un objetivo cuando quieras que Firecrawl determine qué páginas modificadas son relevantes para tu caso de uso.
```bash CLI theme={null}
firecrawl monitor create --name "Hacker News AI" \
--schedule "every 30 minutes" \
--goal "Alert when a new Hacker News story related to AI enters the top 10. Ignore changes to stories that are not about AI. Do not alert on changes outside the top 10." \
--page https://news.ycombinator.com
firecrawl monitor run
firecrawl monitor checks --limit 10
firecrawl monitor check --page-status changed
firecrawl monitor update \
--goal "Alert when a new Hacker News story related to AI enters the top 10. Do not alert on changes outside the top 10."
firecrawl monitor delete
```
Los objetivos del monitor deben ser breves y fieles a la intención del usuario: indica qué debe activar una alerta, reformula cualquier alcance especificado e incluye exclusiones solo cuando sean obvias o se soliciten explícitamente. Si el usuario pide "cualquier cambio", mantén el objetivo amplio.
**Opciones disponibles:**
| Opción | Descripción |
| - | - |
| `--name ` | Nombre del monitor |
| `--goal ` | Objetivo para evaluar cambios significativos |
| `--cron ` | Programación cron, por ejemplo `*/30 * * * *` |
| `--schedule ` | Programación en lenguaje natural, por ejemplo `hourly` |
| `--timezone ` | Zona horaria de la programación, predeterminada `UTC` |
| `--page ` | URL de una sola página para hacer scraping en cada comprobación |
| `--scrape-urls ` | URLs de páginas separadas por comas para hacer scraping en cada comprobación |
| `--crawl-url ` | URL raíz de un objetivo de rastreo |
| `--webhook-url ` | Destino del webhook |
| `--webhook-events ` | Eventos del monitor separados por comas |
| `--email ` | Destinatarios de correo electrónico separados por comas |
| `--retention-days ` | Periodo de retención de snapshots |
| `--page-status ` | Filtrar páginas en `monitor check` |
| `--state ` | Establecer el estado del monitor en `monitor update`: active/paused |
***
### Agente
Busca y recopila datos de la web usando indicaciones en lenguaje natural.
```bash CLI theme={null}
# Uso básico - las URLs son opcionales
firecrawl agent "Find the top 5 AI startups and their funding amounts" --wait
# Focus on specific URLs
firecrawl agent "Compare pricing plans" --urls https://slack.com/pricing,https://teams.microsoft.com/pricing --wait
# Use a schema for structured output
firecrawl agent "Get company information" --urls https://example.com --schema '{"type":"object","properties":{"name":{"type":"string"},"founded":{"type":"number"}}}' --wait
# Use schema from a file
firecrawl agent "Get product details" --urls https://example.com --schema-file schema.json --wait
```
#### Opciones del agente
```bash CLI theme={null}
# Spark 2 es el predeterminado: todas las ejecuciones se realizan con él
firecrawl agent "Competitive analysis across multiple domains" --model spark-2 --wait
# Obsoleto: los nombres de modelo de Spark 1 aún se aceptan, pero se redirigen a spark-2.
# Set max credits to limit costs
firecrawl agent "Gather contact information from company websites" --max-credits 100 --wait
# Check status of an existing job
firecrawl agent --status
# Enviar eventos del agente a un webhook
firecrawl agent "Extract product details" --urls https://example.com --webhook '{"url":"https://example.com/webhook","events":["completed","failed"]}'
# Cancelar un trabajo de agente activo
firecrawl agent --cancel
# Custom polling interval and timeout
firecrawl agent "Summarize recent blog posts" --wait --poll-interval 10 --timeout 300
# Save output to file
firecrawl agent "Find pricing information" --urls https://example.com --wait -o pricing.json --pretty
```
**Opciones disponibles:**
| Opción | Descripción |
| - | - |
| `--urls ` | Lista opcional de URL en las que enfocar el agente (separadas por comas) |
| `--model ` | Modelo que se utilizará. El valor predeterminado es `spark-2`, el modelo con el que se ejecutan todas las ejecuciones. Los modelos Spark 1 están obsoletos y se redirigen a `spark-2` |
| `--schema ` | Esquema JSON para salida estructurada (cadena JSON en línea) |
| `--schema-file ` | Ruta al archivo de esquema JSON para salida estructurada |
| `--max-credits ` | Créditos máximos que se pueden gastar (el trabajo falla si se alcanza el límite) |
| `--webhook ` | URL o configuración del webhook |
| `--status` | Consultar el estado de un trabajo de agente existente |
| `--cancel` | Cancelar un trabajo de agente activo mediante el ID de trabajo |
| `--wait` | Esperar a que el agente termine antes de devolver los resultados |
| `--poll-interval ` | Intervalo de sondeo mientras se espera (predeterminado: 5) |
| `--timeout ` | Tiempo máximo de espera (predeterminado: sin límite) |
| `--output ` | Guardar la salida en un archivo |
| `--json` | Salida en formato JSON |
***
### Uso de créditos
Consulta el saldo y el uso de créditos de tu equipo.
```bash CLI theme={null}
# View credit usage
firecrawl credit-usage
# Salida en formato JSON
firecrawl credit-usage --json --pretty
```
***
### Versión
Mostrar la versión de la CLI.
```bash CLI theme={null}
firecrawl version
# o
firecrawl --version
```
## Opciones globales
Estas opciones están disponibles para todos los comandos:
| Opción | Abrev. | Descripción |
| - | - | - |
| `--status` | | Muestra la versión, el estado de autenticación, la concurrencia y los créditos |
| `--api-key ` | `-k` | Sobrescribe la clave de API almacenada para este comando |
| `--api-url ` | | Usa una URL de API personalizada (para entornos autogestionados/desarrollo local) |
| `--help` | `-h` | Muestra la ayuda para un comando |
| `--version` | `-V` | Muestra la versión de la CLI |
`init` también acepta `--skip-auth`, `--skip-install`, `--skip-skills` y `--agent `. Consulta `firecrawl init --help`.
## Manejo de la salida
La CLI envía la salida a stdout de forma predeterminada, lo que facilita usarla en pipes o redirigirla:
```bash CLI theme={null}
# Canalizar markdown a otro comando
firecrawl https://example.com | head -50
# Redirigir a un archivo
firecrawl https://example.com > output.md
# Guardar JSON con formato legible
firecrawl https://example.com --format markdown,links --pretty -o data.json
```
### Comportamiento de los formatos
* **Un solo formato**: Devuelve contenido sin procesar (texto markdown, HTML, etc.)
* **Varios formatos**: Devuelve JSON con todos los datos solicitados
```bash CLI theme={null}
# Salida de markdown sin procesar
firecrawl https://example.com --format markdown
# Salida JSON con múltiples formatos
firecrawl https://example.com --format markdown,links
```
## Ejemplos
### Scrape rápido
```bash CLI theme={null}
# Obtener contenido markdown de una URL (usar --only-main-content para una salida limpia)
firecrawl https://docs.firecrawl.dev --only-main-content
# Get HTML content
firecrawl https://example.com --html -o page.html
```
### Rastreo completo del sitio web
```bash CLI theme={null}
# Rastrear un sitio de documentación con límites
firecrawl crawl https://docs.example.com --limit 50 --max-depth 2 --wait --progress -o docs.json
```
### Descubrimiento de sitios web
```bash CLI theme={null}
# Buscar todas las publicaciones del blog
firecrawl map https://example.com --search "blog" -o blog-urls.txt
```
### Flujo de trabajo de investigación
```bash CLI theme={null}
# Buscar y extraer resultados para investigación
firecrawl search "machine learning best practices 2024" --scrape --scrape-formats markdown --pretty
```
### Agente
```bash CLI theme={null}
# URLs are optional
firecrawl agent "Encuentra las 5 principales startups de IA y sus montos de financiación" --wait
# Focus on specific URLs
firecrawl agent "Compare pricing plans" --urls https://slack.com/pricing,https://teams.microsoft.com/pricing --wait
```
### Combínalo con otras herramientas
```bash CLI theme={null}
# Extract URLs from search results
jq -r '.data.web[].url' search-results.json
# Obtener títulos de resultados de búsqueda
jq -r '.data.web[] | "\(.title): \(.url)"' search-results.json
# Extraer enlaces como JSON e imprimir una URL por línea
firecrawl https://example.com --format links --json | jq -r '.links[]'
# Count URLs from map
firecrawl map https://example.com | wc -l
```
## Telemetría
La CLI recopila datos de uso anónimos durante la autenticación para ayudar a mejorar el producto:
* Versión de la CLI, sistema operativo y versión de Node.js
* Detección de herramientas de desarrollo (por ejemplo, Cursor, VS Code, Claude Code)
**No se recopilan datos de comandos, URL ni contenido de archivos a través de la CLI.**
Para desactivar la telemetría, configura la siguiente variable de entorno:
```bash CLI theme={null}
export FIRECRAWL_NO_TELEMETRY=1
```
## Código abierto
La CLI de Firecrawl y los tres segmentos de skills son de código abierto en GitHub:
* [`firecrawl/cli`](https://github.com/firecrawl/cli) — la CLI y las skills de CLI (trabajo web en vivo)
* [`firecrawl/skills`](https://github.com/firecrawl/skills) — skills de Build (integrar Firecrawl en el código de la aplicación)
* [`firecrawl/firecrawl-workflows`](https://github.com/firecrawl/firecrawl-workflows) — skills de flujo de trabajo (entregables repetibles, como informes de investigación, auditorías SEO, listas de leads y clones de diseño)
> ¿Eres un agente de IA que necesita una clave de API de Firecrawl? Consulta [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) para obtener instrucciones de incorporación automatizada.