Explorar documentação
Primeiros passos
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.
Nesta página
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.
Com Homebrew instalado:
brew install flashdatadev/tap/flashdata
flashdata --versionBash -Correr uname -m primeiro. Use esta estrutura para x86_64; ARM64 e as opções de gerenciamento de pacotes estão abaixo.
# 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
}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.
# 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. Configure o acesso
Escolha um caminho. Esses comandos usam o perfil padrão, continuam usando o mesmo perfil para suas buscas e reclamações.
Crie ou reutilize uma chave com permissão Google Search. Colar no aviso de login escondido.
flashdata auth login
flashdata auth statusCorra 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).
flashdata setup
flashdata auth statusComece 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.
flashdata init --name "My CLI"
flashdata auth status3. Execute sua primeira pesquisa
Este comando envia uma busca Google por até cinco resultados e imprime a resposta.
flashdata search "battery recycling research" --num 5O 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:
{
"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
}
}
}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.
Encontre páginas com uma contagem de resultados escolhida, idioma e contexto do país.
flashdata search "battery recycling research" --num 5 --hl en --gl us --jsonProcure 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.
flashdata youtube search "battery recycling" --max-results 5 --jsonflashdata youtube metadata FUfGcZ092b0 --jsonflashdata youtube transcript FUfGcZ092b0 --language en --jsonUse 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.
flashdata youtube download FUfGcZ092b0 --format mp3 --storage-config storage.json --wait --output delivery.json --jsonVerifique preços, equilíbrio e fontes permitidas sem submeter perguntas.
flashdata account balance
flashdata account pricing --source google_search --request-count 1
flashdata sources listVisualize 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.
flashdata account balance
flashdata search "battery recycling research" --num 5 --dry-run --jsonUse 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. |
flashdata search "battery recycling research" --accept text/plain --respond-with markdown --json=falseSoluçã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. |