Saltar al contenido
ES
Obtener clave API
Explorar documentación

Primeros pasos

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.

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:

Homebrew
brew install flashdatadev/tap/flashdata
flashdata --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.

Linux ARM64
# 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

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.

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
flashdata auth login
flashdata auth status

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
flashdata search "battery recycling research" --num 5

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
{
  "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.

Google Search
flashdata search "battery recycling research" --num 5 --hl en --gl us --json

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
flashdata account balance
flashdata search "battery recycling research" --num 5 --dry-run --json

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ónPropósito
--jsonDevuelve un comprobante de ejecución en JSON. Con --output, data describe el archivo guardado.
--non-interactiveDesactiva las preguntas interactivas y la apertura del navegador.
--output FILEGuarda la respuesta de la fuente en un archivo nuevo.
--run-id IDAsigna un ID a una ejecución y reutiliza su resultado guardado.
--helpMuestra la sintaxis y las opciones de cualquier comando.
Solicitar Markdown
flashdata search "battery recycling research" --accept text/plain --respond-with markdown --json=false

Solución de problemas

ProblemaQué hacer
No se reconoce la CLIComprueba 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 / 403Ejecuta flashdata auth status. Comprueba las credenciales, las variables de entorno que puedan sustituirlas y los permisos de la fuente.
402 / 429Para 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 agotadoRevisa 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.

Siguientes pasos