Explorar documentación
Primeros pasos
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.
En esta página
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.
Con Homebrew instalado:
brew install flashdatadev/tap/flashdata
flashdata --versionEn 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.
# 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# 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 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.
# 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# 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# 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 --version2. 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.
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.
flashdata auth login
flashdata auth statusEjecuta 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.
flashdata setup
flashdata auth statusInicia 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.
flashdata init --name "My CLI"
flashdata auth status3. 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.
flashdata search "battery recycling research" --num 5Comprueba 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:
{
"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
}
}
}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.
Busca páginas indicando el número de resultados, el idioma y el país.
flashdata search "battery recycling research" --num 5 --hl en --gl us --jsonBusca 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.
flashdata youtube search "battery recycling" --max-results 5 --jsonflashdata youtube metadata FUfGcZ092b0 --jsonflashdata youtube transcript FUfGcZ092b0 --language en --jsonUsa 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.
flashdata youtube download FUfGcZ092b0 --format mp3 --storage-config storage.json --wait --output delivery.json --jsonConsulta los precios, el saldo y las fuentes permitidas sin enviar consultas de datos.
flashdata account balance
flashdata account pricing --source google_search --request-count 1
flashdata sources listEstima 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.
flashdata account balance
flashdata search "battery recycling research" --num 5 --dry-run --jsonUsa 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. |
flashdata search "battery recycling research" --accept text/plain --respond-with markdown --json=falseSolució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. |