> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Ejecutar tu primera tarea de Octoparse CLI

> Busca y valida una tarea de Octoparse, ejecuta una extracción local limitada, revisa las filas recopiladas y exporta el resultado desde la CLI.

Esta guía recorre el flujo completo más corto de la CLI: buscar una tarea, ejecutarla localmente, comprobar el resultado y exportar los datos.

Antes de empezar, completa [Instalación](/docs/es/cli/quick-start/installation) y [Autenticación](/docs/es/cli/quick-start/get-api-key-and-log-in).

## Buscar una tarea

Enumera las tareas disponibles en tu cuenta:

```bash theme={null}
octoparse task list
```

Usa la salida JSON cuando necesites copiar el ID exacto de una tarea:

```bash theme={null}
octoparse task list --limit 10 --json
```

Inspecciona la tarea seleccionada:

```bash theme={null}
octoparse task show <taskId> --json
octoparse task validate <taskId>
```

## Ejecutar la tarea localmente

```bash theme={null}
octoparse run <taskId>
```

Para una primera ejecución pequeña, detén el proceso tras un número limitado de filas:

```bash theme={null}
octoparse run <taskId> --max-rows 20
```

En un servidor o en una automatización, usa un navegador independiente sin interfaz gráfica:

```bash theme={null}
octoparse run <taskId> --headless --max-rows 20 --json
```

<Note>
  La extracción local basada en navegador es compatible con macOS x64/arm64, Windows x64 y Linux x64. Linux arm64 no es compatible.
</Note>

## Comprobar el resultado

Consulta el historial local y el número de filas:

```bash theme={null}
octoparse data history <taskId> --source local --json
octoparse data count <taskId> --source local
octoparse data preview <taskId> --source local --limit 5
```

## Exportar los datos

```bash theme={null}
octoparse data export <taskId> --source local --format xlsx
```

Elige otro formato o nombre de archivo:

```bash theme={null}
octoparse data export <taskId> --source local --format csv --file result.csv
```

Los formatos compatibles son `xlsx`, `csv`, `html`, `json` y `xml`.

## Opcional: ejecutar en la nube

```bash theme={null}
octoparse cloud start <taskId>
octoparse cloud status <taskId> --json
```

La Extracción en la nube se ejecuta en la infraestructura de Octoparse y no requiere que el proceso del navegador local permanezca abierto.

## Seguir aprendiendo

<CardGroup cols={2}>
  <Card title="Gestionar tareas y grupos" href="../guides/tasks-and-groups">
    Copia, cambia de nombre, mueve, elimina y organiza tareas.
  </Card>

  <Card title="Configurar modos de navegador" href="../guides/browser-modes">
    Reutiliza un perfil de Chrome o Edge con una sesión iniciada cuando sea necesario.
  </Card>

  <Card title="Controlar ejecuciones locales" href="../guides/local-runs">
    Desacopla, pausa, reanuda, detén e inspecciona ejecuciones locales.
  </Card>

  <Card title="Ejecutar y programar tareas en la nube" href="../guides/cloud-runs-and-schedules">
    Gestiona el historial en la nube y las ejecuciones programadas recurrentes.
  </Card>
</CardGroup>
