# FlashData CLI

Pesquise Google, recupere dados YouTube e entregue mídia do seu terminal ou agente de IA. Um executável, nenhum Node.js ou Python necessário.

Referência canônica: https://flashdata.dev/pt/docs/guides/flashdata-cli
2026-11-04 por FlashData

- [Baixar CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1) — v1.2.1 · Linux / macOS / Windows
- [Referência do comando](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md) — Todos os comandos, bandeiras e códigos de saída

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

## 1. Instalar

Escolha sua plataforma. Essas construções nativas não precisam de Node.js ou Python. Execute os comandos em uma pasta escrita, downloads autônomos são verificados.

### macOS

Com Homebrew instalado:

#### Homebrew

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

- [Instale sem Homebrew](https://flashdata.dev/pt/docs/guides/flashdata-cli/reference.md#manual-install)

### Linux x64

Bash -Correr uname -m primeiro. Use esta estrutura para x86_64; ARM64 e as opções de gerenciamento de pacotes estão abaixo.

#### 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
}
```


- [Outras plataformas e gerentes de pacotes](https://flashdata.dev/pt/docs/guides/flashdata-cli/reference.md#manual-install)

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

### Outras opções de instalação

Comandos autônomos definir PATH para este terminal. Adicione o diretório extraído ao seu usuário PATH para sessões posteriores, ou use o caminho absoluto do executável.

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


- [APT/RPM configurando](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/installation.md)
- [Solte os downloads](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)

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

## 2. Configure o acesso

Escolha um caminho. Esses comandos usam o perfil padrão, continuam usando o mesmo perfil para suas buscas e reclamações.

### Eu tenho uma chave API

Crie ou reutilize uma chave com permissão Google Search. Colar no aviso de login escondido.

#### Salve e verifique o acesso

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

- [Crie uma chave API](https://flashdata.dev/app/api-keys)

### Prepare meu agente

Corra do seu projeto e escolha Codex, código Claude ou cursor. A configuração instala habilidades 16 e reutiliza acesso ou solicita um teste elegível. Ele não é pago. Um agente automatizado pode usar o código --agent --non-interactive (substituir o códice com o hospedeiro suportado).

#### Armação guiada

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

- [OpenClaw e outros anfitriões de habilidade](https://flashdata.dev/pt/docs/guides/agent-skill/reference.md#other-hosts)

### Tente no terminal

Comece um teste elegível sem instalar habilidades de agente. Google Search e YouTube Metadata são solicitados por padrão. Reutilize o acesso válido salvo se já o tiver.

#### Comecem um teste

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


- [Subsídio de teste e vinculação](https://flashdata.dev/pt/docs/guides/agent-onboarding/reference.md)

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

## 3. Execute sua primeira pesquisa

Este comando envia uma busca Google por até cinco resultados e imprime a resposta.

### Pesquisar

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


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

### O que você deveria ver

Procure ok: true e data.status: done. Leia os títulos e as URLs em data.results[].organic e os créditos cobrados em data.usage.credits. Exemplo resumido:

#### Saída de 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>

## Mais tarefas CLI

Escolha uma tarefa abaixo. Consultas usam as permissões e créditos da chave conectada. Verifique as fontes permitidas da chave antes de mudar de tarefas, downloads requerem acesso do proprietário.

### Google Search

Encontre páginas com uma contagem de resultados escolhida, idioma e contexto do país.

#### Google Search

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


### YouTube Data

Procure vídeos de candidatos, e use um vídeo ID com metadados ou transcrição. Cada comando é uma consulta separada, substitua a amostra ID com seu vídeo escolhido.

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

Use uma chave do proprietário com permissão youtube_download. Prepare um storage.json privado com suas configurações de armazenamento usando o link de configuração de armazenamento nesta aba. Substitua o vídeo ID por um que você está autorizado a processar. Este comando espera pelo trabalho de fundo e salva um registro de entrega, não o arquivo de mídia.

#### Download audio

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

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

### Conta

Verifique preços, equilíbrio e fontes permitidas sem submeter perguntas.

#### Conta lê

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


- [Comando completo e referência da bandeira](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md)

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

### Visualize o custo antes de uma consulta

Esses comandos lêem seu equilíbrio e estimam sem fazer uma busca. Verifique data.estimateAvailable e compare a estimativa com os créditos disponíveis.

#### Antevisão

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


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

### Use em roteiros e agentes

Para outra busca pretendida, escolha uma nova execução ID e nome de arquivo de saída. Os arquivos existentes não são substituídos. Depois de uma corrida interrompida, inspecione o registro existente antes de apresentar novamente.

| Opção | Propósito |
| --- | --- |
| --json | Recibo de execução legível por máquina, com --output, os dados descrevem o arquivo salvo. |
| --non-interactive | Desativar alertas e navegador abrindo. |
| --output FILE | Guarde a resposta da fonte para um novo arquivo. |
| --run-id ID | Identifique uma execução e reutilize seu resultado salvo. |
| --help | Mostre sintaxe e bandeiras para qualquer comando. |

#### Pergunte por Markdown

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

- [Perfis, JSON e corridas recorrentes](https://flashdata.dev/pt/docs/guides/cli-automation/reference.md)

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

## Solução de problemas

| Problema | Tente isso |
| --- | --- |
| Comando não encontrado | Verifique o download do OS/CPU e PATH dentro do terminal ou agente onde você o executa. |
| 401 / 403 | Corra auth status. Verifique credenciais, sobreposições de ambiente e permissões de origem. |
| 402 / 429 | Verifique Billing ou reivindique um teste esgotado. Para limites de taxa, siga Retry-After. |
| Saída existe / tempo limite | Inspecione o arquivo original. Use o guia de recuperação antes de enviar um novo trabalho pago. |

- [verificações detalhados e recuperação](https://flashdata.dev/pt/docs/guides/cli-automation/reference.md#recover)
- [Billing](https://flashdata.dev/app/billing)

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

## Vá mais longe

- [Reclame seu teste e mantenha o acesso](https://flashdata.dev/pt/docs/guides/agent-onboarding/reference.md#claim)
- [Tarefas recorrentes](https://flashdata.dev/pt/docs/guides/recurring-tasks/reference.md)
- [Instale a habilidade do agente](https://flashdata.dev/pt/docs/guides/agent-skill/reference.md)
- [Perfis e armazenamento de credenciais](https://flashdata.dev/pt/docs/guides/cli-automation/reference.md#profiles)
