# FlashData CLI

Busca en Google, consulta datos de YouTube y entrega audio o vídeo desde tu terminal o agente de IA. Un solo ejecutable, sin necesidad de Node.js ni Python.

Referencia canónica: https://flashdata.dev/es/docs/guides/flashdata-cli
Revisado: 2026-11-04 por FlashData

- [Descargar la CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1) — v1.2.1 · Linux / macOS / Windows
- [Referencia de comandos](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md) — Comandos, opciones y códigos de salida

<a id="install"></a>

## 1. Instala la CLI

Elige tu plataforma y ejecuta los comandos en una carpeta donde puedas escribir. Los ejecutables nativos no necesitan Node.js ni Python. Los comandos de descarga directa comprueban la suma SHA-256 del archivo antes de extraerlo.

### macOS

Con Homebrew instalado:

#### Homebrew

```bash
brew install flashdatadev/tap/flashdata
flashdata --version
```

- [Instalar sin Homebrew](https://flashdata.dev/es/docs/guides/flashdata-cli/reference.md#manual-install)

### Linux x64

En Bash, ejecuta primero uname -m. Usa esta descarga si devuelve x86_64. Las opciones para ARM64 y los gestores de paquetes están más abajo.

#### Linux x64

```bash
# Run in Bash, in a writable parent directory.
(
  set -eu
  mkdir "flashdata-cli-1.2.1"
  cd "flashdata-cli-1.2.1"
  curl --fail --show-error --location 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/flashdata_1.2.1_linux_amd64.tar.gz' -o 'flashdata_1.2.1_linux_amd64.tar.gz'
  curl --fail --show-error --location 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/SHA256SUMS' -o SHA256SUMS
  grep '  flashdata_1.2.1_linux_amd64.tar.gz$' SHA256SUMS | sha256sum -c -
  tar -xzf 'flashdata_1.2.1_linux_amd64.tar.gz'
  chmod +x flashdata
  ./flashdata --version
 ) &&
export PATH="$PWD/flashdata-cli-1.2.1:$PATH" &&
flashdata --version
```


### Windows x64

#### PowerShell

```powershell
# Run in PowerShell, in a writable parent directory.
& {
  $ErrorActionPreference = 'Stop'
  $archive = 'flashdata_1.2.1_windows_amd64.zip'
  $installDir = Join-Path (Get-Location) 'flashdata-cli-1.2.1'
  if (Test-Path -LiteralPath $installDir) { throw 'Directory exists; choose a fresh parent directory.' }
  New-Item -ItemType Directory -Path $installDir | Out-Null
  Invoke-WebRequest 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/flashdata_1.2.1_windows_amd64.zip' -OutFile (Join-Path $installDir $archive)
  Invoke-WebRequest 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/SHA256SUMS' -OutFile (Join-Path $installDir 'SHA256SUMS')
  $entry = Get-Content (Join-Path $installDir 'SHA256SUMS') | Where-Object { $_.EndsWith('  ' + $archive) }
  if (@($entry).Count -ne 1) { throw 'Archive checksum entry missing or ambiguous.' }
  $expected = ($entry -split '\s+')[0]
  $actual = (Get-FileHash (Join-Path $installDir $archive) -Algorithm SHA256).Hash
  if ($actual -ne $expected) { throw 'Checksum mismatch; stop installation.' }
  Expand-Archive -LiteralPath (Join-Path $installDir $archive) -DestinationPath $installDir
  $env:PATH = $installDir + [IO.Path]::PathSeparator + $env:PATH
  & (Join-Path $installDir 'flashdata.exe') --version
}
```


- [Otras plataformas y gestores de paquetes](https://flashdata.dev/es/docs/guides/flashdata-cli/reference.md#manual-install)

<a id="manual-install"></a>

### Otras opciones de instalación

Los comandos de descarga directa añaden el directorio del ejecutable a PATH solo en esta terminal. Para usarlo en futuras sesiones, añade ese directorio al PATH de tu usuario o ejecuta el archivo mediante su ruta absoluta.

#### Linux ARM64

##### Linux ARM64

```bash
# Run in Bash, in a writable parent directory.
(
  set -eu
  mkdir "flashdata-cli-1.2.1"
  cd "flashdata-cli-1.2.1"
  curl --fail --show-error --location 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/flashdata_1.2.1_linux_arm64.tar.gz' -o 'flashdata_1.2.1_linux_arm64.tar.gz'
  curl --fail --show-error --location 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/SHA256SUMS' -o SHA256SUMS
  grep '  flashdata_1.2.1_linux_arm64.tar.gz$' SHA256SUMS | sha256sum -c -
  tar -xzf 'flashdata_1.2.1_linux_arm64.tar.gz'
  chmod +x flashdata
  ./flashdata --version
 ) &&
export PATH="$PWD/flashdata-cli-1.2.1:$PATH" &&
flashdata --version
```


#### macOS Intel

##### macOS Intel

```bash
# Run in Bash, in a writable parent directory.
(
  set -eu
  mkdir "flashdata-cli-1.2.1"
  cd "flashdata-cli-1.2.1"
  curl --fail --show-error --location 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/flashdata_1.2.1_darwin_amd64.tar.gz' -o 'flashdata_1.2.1_darwin_amd64.tar.gz'
  curl --fail --show-error --location 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/SHA256SUMS' -o SHA256SUMS
  grep '  flashdata_1.2.1_darwin_amd64.tar.gz$' SHA256SUMS | shasum -a 256 -c -
  tar -xzf 'flashdata_1.2.1_darwin_amd64.tar.gz'
  chmod +x flashdata
  ./flashdata --version
 ) &&
export PATH="$PWD/flashdata-cli-1.2.1:$PATH" &&
flashdata --version
```


#### macOS Apple Silicon

##### macOS Apple Silicon

```bash
# Run in Bash, in a writable parent directory.
(
  set -eu
  mkdir "flashdata-cli-1.2.1"
  cd "flashdata-cli-1.2.1"
  curl --fail --show-error --location 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/flashdata_1.2.1_darwin_arm64.tar.gz' -o 'flashdata_1.2.1_darwin_arm64.tar.gz'
  curl --fail --show-error --location 'https://github.com/flashdatadev/flashdata-cli/releases/download/v1.2.1/SHA256SUMS' -o SHA256SUMS
  grep '  flashdata_1.2.1_darwin_arm64.tar.gz$' SHA256SUMS | shasum -a 256 -c -
  tar -xzf 'flashdata_1.2.1_darwin_arm64.tar.gz'
  chmod +x flashdata
  ./flashdata --version
 ) &&
export PATH="$PWD/flashdata-cli-1.2.1:$PATH" &&
flashdata --version
```


- [Instalar con APT o RPM](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/installation.md)
- [Descargas de la versión](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)

<a id="existing-key"></a>

## 2. Configura el acceso

Elige una opción. Estos comandos usan el perfil predeterminado; conserva el mismo perfil para las búsquedas y para vincular la prueba a tu cuenta.

### Tengo una clave API

Crea o reutiliza una clave API con permiso para Google Search. Ejecuta auth login y pega la clave cuando se solicite; no se mostrará en pantalla.

#### Guardar y comprobar el acceso

```bash
flashdata auth login
flashdata auth status
```

- [Crear una clave API](https://flashdata.dev/app/api-keys)

### Configurar mi agente

Ejecuta setup desde tu proyecto y elige Codex, Claude Code o Cursor. Instala 16 skills y reutiliza tu acceso o solicita una prueba si cumples los requisitos. No ejecuta consultas de pago. Un agente puede añadir --agent codex --non-interactive; sustituye codex por el identificador de la aplicación compatible que uses.

#### Configuración guiada

```bash
flashdata setup
flashdata auth status
```

- [Skills en OpenClaw y otras aplicaciones](https://flashdata.dev/es/docs/guides/agent-skill/reference.md#other-hosts)

### Probar desde la terminal

Inicia una prueba si cumples los requisitos, sin instalar skills. Por defecto solicita Google Search y YouTube Metadata. Si ya tienes acceso válido guardado, reutilízalo.

#### Iniciar una prueba

```bash
flashdata init --name "My CLI"
flashdata auth status
```


- [Créditos de prueba y vinculación a una cuenta](https://flashdata.dev/es/docs/guides/agent-onboarding/reference.md)

<a id="run"></a>

## 3. Haz tu primera búsqueda

Este comando envía una solicitud de Google Search de hasta cinco resultados y muestra la respuesta en la terminal.

### Búsqueda

```bash
flashdata search "battery recycling research" --num 5
```


<a id="result"></a>

### Comprueba el resultado

Comprueba ok: true y data.status: done. Consulta los títulos y las URLs en data.results[].organic, y el cargo en data.usage.credits. Ejemplo abreviado:

#### Salida de la terminal

```json
{
  "schemaVersion": 1,
  "ok": true,
  "cached": false,
  "data": {
    "status": "done",
    "results": [
      {
        "organic": [
          {
            "title": "Battery recycling research",
            "link": "https://example.org/recycling",
            "snippet": "An example search excerpt."
          }
        ]
      }
    ],
    "usage": {
      "credits": 0.02
    }
  }
}
```


<a id="commands"></a>

## Más tareas con la CLI

Elige una tarea y comprueba que tu clave permita acceder a la fuente correspondiente. Las consultas consumen créditos de la cuenta o prueba asociada; las descargas requieren acceso del titular.

### Google Search

Busca páginas indicando el número de resultados, el idioma y el país.

#### Google Search

```bash
flashdata search "battery recycling research" --num 5 --hl en --gl us --json
```


### YouTube Data

Busca vídeos y usa uno de los IDs devueltos para consultar sus metadatos o su transcripción. Sustituye el ID de ejemplo por el del vídeo elegido. Cada comando envía una solicitud independiente.

#### Search

```bash
flashdata youtube search "battery recycling" --max-results 5 --json
```

#### Metadata

```bash
flashdata youtube metadata FUfGcZ092b0 --json
```

#### Transcript

```bash
flashdata youtube transcript FUfGcZ092b0 --language en --json
```


### YouTube Download

Usa una clave del titular con permiso youtube_download. Antes de ejecutar el comando, prepara un archivo privado storage.json en el directorio actual con la configuración de tu almacenamiento; el enlace de esta pestaña explica cómo hacerlo. Sustituye el ID por un vídeo que tengas autorización para procesar. El comando espera a que termine el trabajo en segundo plano y guarda el registro de entrega en delivery.json; el audio se entrega en tu almacenamiento.

#### Download audio

```bash
flashdata youtube download FUfGcZ092b0 --format mp3 --storage-config storage.json --wait --output delivery.json --json
```

- [Preparar storage.json](https://flashdata.dev/es/docs/guides/cli-automation/reference.md#storage)

### Cuenta

Consulta los precios, el saldo y las fuentes permitidas sin enviar consultas de datos.

#### Consultar la cuenta

```bash
flashdata account balance
flashdata account pricing --source google_search --request-count 1
flashdata sources list
```


- [Todos los comandos y opciones](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md)

<a id="preview"></a>

### Estima el coste antes de consultar

Estos comandos consultan tu saldo y calculan una estimación sin ejecutar la búsqueda. Comprueba data.estimateAvailable y, si hay una estimación disponible, compárala con tus créditos.

#### Vista previa

```bash
flashdata account balance
flashdata search "battery recycling research" --num 5 --dry-run --json
```


<a id="scripts"></a>

### Usa la CLI en scripts y agentes

Para una nueva búsqueda, elige un ID de ejecución y un nombre de archivo nuevos. La CLI no sobrescribe archivos existentes. Si una ejecución se interrumpe, revisa su registro antes de volver a enviar la solicitud.

| Opción | Propósito |
| --- | --- |
| --json | Devuelve un comprobante de ejecución en JSON. Con --output, data describe el archivo guardado. |
| --non-interactive | Desactiva las preguntas interactivas y la apertura del navegador. |
| --output FILE | Guarda la respuesta de la fuente en un archivo nuevo. |
| --run-id ID | Asigna un ID a una ejecución y reutiliza su resultado guardado. |
| --help | Muestra la sintaxis y las opciones de cualquier comando. |

#### Solicitar Markdown

```bash
flashdata search "battery recycling research" --accept text/plain --respond-with markdown --json=false
```

- [Perfiles, JSON y tareas recurrentes](https://flashdata.dev/es/docs/guides/cli-automation/reference.md)

<a id="recover"></a>

## Solución de problemas

| Problema | Qué hacer |
| --- | --- |
| No se reconoce la CLI | Comprueba que la descarga corresponda a tu sistema y arquitectura, y que su directorio esté en PATH. Usa command -v flashdata en Bash o Get-Command flashdata en PowerShell desde la terminal o el agente donde vas a ejecutarlo. |
| 401 / 403 | Ejecuta flashdata auth status. Comprueba las credenciales, las variables de entorno que puedan sustituirlas y los permisos de la fuente. |
| 402 / 429 | Para un 402, consulta los créditos en Billing o vincula la prueba agotada a una cuenta. Para un 429, respeta el tiempo indicado por Retry-After. |
| Archivo de salida existente / tiempo de espera agotado | Revisa el registro de la ejecución y el archivo guardado. Sigue la guía de recuperación antes de enviar una nueva solicitud de pago. |

- [Comprobaciones detalladas y recuperación](https://flashdata.dev/es/docs/guides/cli-automation/reference.md#recover)
- [Billing](https://flashdata.dev/app/billing)

<a id="next"></a>

## Siguientes pasos

- [Vincular la prueba a tu cuenta y conservar el acceso](https://flashdata.dev/es/docs/guides/agent-onboarding/reference.md#claim)
- [Tareas recurrentes](https://flashdata.dev/es/docs/guides/recurring-tasks/reference.md)
- [Instalar la skill del agente](https://flashdata.dev/es/docs/guides/agent-skill/reference.md)
- [Perfiles y almacenamiento de credenciales](https://flashdata.dev/es/docs/guides/cli-automation/reference.md#profiles)
