> ## 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.

# Instalación

> Instala Octoparse CLI con npm, comprueba los requisitos de Node.js y la plataforma, y verifica el motor local, Chrome y el navegador del usuario.

Octoparse CLI se distribuye como paquete npm y funciona con Node.js 20 o una versión posterior.

## Requisitos

Antes de instalar Octoparse CLI, asegúrate de que tu entorno disponga de:

* Node.js 20 o posterior
* npm 8 o posterior
* Un terminal o shell de línea de comandos

Comprueba las versiones de Node.js y npm:

```bash theme={null}
node -v
npm -v
```

Si tu versión de Node.js es anterior a la 20, actualízala antes de continuar.

<Card title="Descargar Node.js" href="https://nodejs.org/">
  Instala Node.js 20 o posterior para tu sistema operativo.
</Card>

### Plataformas compatibles con la extracción local

La extracción local utiliza una instancia independiente de Chrome. Plataformas compatibles:

* macOS (x64 y arm64)
* Windows (x64)
* Linux (x64)

<Warning>
  Linux arm64 no es compatible con la extracción local. Chrome for Testing no ofrece un paquete para Linux arm64. Si utilizas un servidor ARM o un contenedor de Apple Silicon con una imagen Linux arm64, los comandos locales `run` y `detect` fallarán. La extracción en la nube (`octoparse cloud start`) funciona en cualquier plataforma.
</Warning>

## Instalar con npm

Instala Octoparse CLI globalmente:

```bash theme={null}
npm install -g @octoparse-ai/octoparse-cli
```

Después de la instalación, el comando `octoparse` estará disponible globalmente.

## Verificar la instalación

### Comprobaciones rápidas

Comprueba la versión instalada:

```bash theme={null}
octoparse --version
```

Abre la ayuda:

```bash theme={null}
octoparse --help
```

### Interpretar el resultado de doctor

Ejecuta los diagnósticos:

```bash theme={null}
octoparse doctor
```

`octoparse doctor` comprueba Node.js, el motor integrado de Octoparse, las extensiones del entorno de ejecución, la disponibilidad de Chrome y el modo del navegador.

Un resultado correcto devuelve `"ok": true`:

```json theme={null}
{
  "ok": true,
  "checks": [
    { "name": "node", "ok": true, "message": "v24.0.0" },
    { "name": "engine", "ok": true, "message": "..." },
    { "name": "electron-client", "ok": true, "message": "not required" },
    { "name": "browser-mode", "ok": true, "message": "independent Chrome only" }
  ]
}
```

* `electron-client: not required`: la aplicación de escritorio de Octoparse no es necesaria para ejecutar la CLI.
* `browser-mode: independent Chrome only`: la extracción local utiliza una instancia independiente de Chrome, no el navegador del cliente de escritorio.

Si `chrome` muestra `ok: false`, consulta la sección [Solución de problemas](#solución-de-problemas) más adelante.

Si es necesario, utiliza una ruta personalizada de Chrome:

```bash theme={null}
octoparse doctor --chrome-path /path/to/chrome
```

### Comprobar si el navegador del usuario está listo

```bash theme={null}
octoparse browser status
```

Utiliza la salida JSON para realizar comprobaciones estructuradas del entorno y del navegador del usuario:

```bash theme={null}
octoparse doctor --json
octoparse browser status --json
```

## Gestionar la instalación

### Actualizar Octoparse CLI

Vuelve a ejecutar el comando de instalación de npm para actualizarla:

```bash theme={null}
npm install -g @octoparse-ai/octoparse-cli
octoparse --version
```

### Desinstalar Octoparse CLI

```bash theme={null}
npm uninstall -g @octoparse-ai/octoparse-cli
```

Si el shell devuelve `octoparse: command not found`, el comando se ha eliminado.

## Solución de problemas

| Problema                                        | Qué comprobar                                                                                                                                                                                                                 |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `octoparse: command not found`                  | Confirma que el directorio global de binarios de npm esté incluido en tu `PATH`                                                                                                                                               |
| Error de permisos durante la instalación        | Comprueba los permisos de los paquetes globales de npm o utiliza un gestor de versiones de Node.js. [Consulta la guía de npm →](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally) |
| La versión de Node.js es demasiado antigua      | Actualiza a Node.js 20 o posterior                                                                                                                                                                                            |
| La instalación de npm agota el tiempo de espera | Comprueba el registro de npm y la configuración del Proxy, la VPN o el cortafuegos                                                                                                                                            |
| Chrome no se descarga                           | Comprueba el acceso de red a la CDN de Chrome for Testing. Prueba `--chrome-path` para usar una instalación local de Chrome                                                                                                   |
| Linux arm64 no es compatible                    | Usa un entorno Linux x64 o cambia a la extracción en la nube mediante `octoparse cloud start`                                                                                                                                 |
| `doctor` muestra una comprobación fallida       | Corrige la dependencia indicada (Node.js, Chrome o archivos del motor) y vuelve a ejecutar `octoparse doctor`. Si el problema continúa, comparte con el equipo de soporte de Octoparse el resultado que contiene `ok: false`  |

## Siguientes pasos

<CardGroup cols={3}>
  <Card title="Obtener una clave de API e iniciar sesión" href="/docs/es/cli/quick-start/get-api-key-and-log-in">
    Crea una clave de API de Octoparse y autentica la CLI.
  </Card>

  <Card title="Ejecutar tu primera tarea" href="/docs/es/cli/quick-start/run-your-first-task">
    Enumera las tareas, examina una, ejecútala localmente y exporta los datos.
  </Card>

  <Card title="Consultar todos los comandos" href="../reference/command-cheatsheet">
    Consulta los comandos habituales de la CLI para tareas, ejecuciones locales, ejecuciones en la nube y exportaciones.
  </Card>
</CardGroup>