Pular para o conteúdo
PT
Obter chave API
Explorar documentação

Primeiros passos

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.

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:

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

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

Salve e verifique o acesso
flashdata auth login
flashdata auth status

3. Execute sua primeira pesquisa

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

Pesquisar
flashdata search "battery recycling research" --num 5

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

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

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

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çãoPropósito
--jsonRecibo de execução legível por máquina, com --output, os dados descrevem o arquivo salvo.
--non-interactiveDesativar alertas e navegador abrindo.
--output FILEGuarde a resposta da fonte para um novo arquivo.
--run-id IDIdentifique uma execução e reutilize seu resultado salvo.
--helpMostre sintaxe e bandeiras para qualquer comando.
Pergunte por Markdown
flashdata search "battery recycling research" --accept text/plain --respond-with markdown --json=false

Solução de problemas

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

Vá mais longe