# FlashData CLI

Cerca Google, recupera i dati YouTube e rilascia i supporti dal tuo terminale o agente AI. Un eseguibile; non è richiesto Node.js o Python.

Riferimento canonico: https://flashdata.dev/it/docs/guides/flashdata-cli
Recensito: 2026-11-04 da FlashData

- [Scarica CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1) — v1.2.1 · Linux / macOS / Windows
- [Riferimento del comando](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md) — Tutti i comandi, le bandiere e i codici di uscita

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

## 1. Installazione

Scegli la tua piattaforma. Queste costruzioni native non hanno bisogno di Node.js o Python. Eseguire i comandi in una cartella scrivibile; i download standalone sono verificati.

### macOS

Con Homebrew installato:

#### Homebrew

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

- [Installare senza Homebrew](https://flashdata.dev/it/docs/guides/flashdata-cli/reference.md#manual-install)

### Linux x64

Bash · Eseguire uname -m prima. Utilizzare questa costruzione per x86_64; ARM64 e pacchetti-manager opzioni sono qui sotto.

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


- [Altre piattaforme e gestori di pacchetti](https://flashdata.dev/it/docs/guides/flashdata-cli/reference.md#manual-install)

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

### Altre opzioni di installazione

I comandi standalone impostano PATH per questo terminale. Aggiungere la directory estratta al PATH dell'utente per le sessioni successive, o utilizzare il percorso assoluto dell'eseguibile.

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


- [Configurazione APT / RPM](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/installation.md)
- [Download di rilascio](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)

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

## 2. Impostare l'accesso

Scegli un percorso. Questi comandi utilizzano il profilo predefinito; continuare a utilizzare lo stesso profilo per le tue ricerche e rivendicazioni.

### Ho una chiave API

Creare o riutilizzare una chiave con il permesso di ricerca Google. Incollalo nel prompt di login nascosto.

#### Salvare e controllare l'accesso

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

- [Creare una chiave API](https://flashdata.dev/app/api-keys)

### Preparare il mio agente

Esegui dal tuo progetto e scegli Codex, Claude Code o Cursor. Setup installa le competenze 16 e riutilizza l'accesso o richiede una prova idoneo. Non e' una domanda pagata. Un agente automatizzato può utilizzare il codex --agent --non-interactive (sostituire il codex con l'host supportato reale).

#### Configurazione guidata

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

- [OpenClaw e altri host di abilità](https://flashdata.dev/it/docs/guides/agent-skill/reference.md#other-hosts)

### Prova dal terminal

Avviare una prova idoneo senza installare competenze di agente. Google Cerca e YouTube Metadata sono richiesti per impostazione predefinita. Riutilizzare l'accesso salvato valido invece se l'hai già.

#### Avviare una prova

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


- [Indennità di prova e reclamo](https://flashdata.dev/it/docs/guides/agent-onboarding/reference.md)

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

## 3. Eseguire la prima ricerca

Questo comando invia una ricerca Google per un massimo di cinque risultati e stampa la risposta.

### Cerca

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


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

### Che cosa dovresti vedere

Cerca ok: true e data.status: done. Leggi i titoli e URLs in data.results[].organic e la carica in data.usage.credits. Esempio (abbreviato):

#### Uscita del terminale

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

## Altre attività CLI

Scegli un'attività qui sotto. Le query utilizzano le autorizzazioni e i crediti di origine della chiave collegata. Controllare le fonti consentite della chiave prima di eseguire le operazioni di commutazione; i download richiedono l'accesso del proprietario.

### Google Search

Trova pagine con un conteggio dei risultati scelto, lingua e contesto di campagna.

#### Google Search

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


### YouTube Data

Cercare video candidati, quindi utilizzare un video ID restituito con metadati o trascrizione. Ogni comando è una query separata; sostituire il campione ID con il video scelto.

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

Utilizzare una chiave del proprietario con il permesso youtube_download. Preparare un storage.json privato con le impostazioni di archiviazione di destinazione utilizzando il link di configurazione di archiviazione in questa scheda. Sostituisci il video ID con uno che sei autorizzato a elaborare. Questo comando aspetta il lavoro di sfondo e salva un record di consegna, non il file multimediale.

#### Download audio

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

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

### Conto

Controllare i prezzi, l'equilibrio e le fonti consentite senza presentare domande.

#### Legge sul conto

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


- [Comando completo e riferimento della bandiera](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md)

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

### Anteprima il costo prima di una query

Questi comandi leggono il vostro equilibrio e stimano senza eseguire una ricerca. Controllare data.estimateAvailable e confrontare la stima con i crediti disponibili.

#### Anteprima

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


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

### Utilizzare in script e agenti

Per un'altra ricerca prevista, scegliere un nuovo run ID e il nome del file di output. I file esistenti non sono sovrascritti. Dopo una corsa interrotta, ispezionare il record esistente prima di presentare di nuovo.

| Opzione | Oggetto |
| --- | --- |
| --json | Ricevuta di esecuzione leggibile in macchina; con --output, i dati descrive il file salvato. |
| --non-interactive | Disattiva i prompt e l'apertura del browser. |
| --output FILE | Salvare la risposta di origine a un nuovo file. |
| --run-id ID | Identificare uno destinato eseguire e riutilizzare il suo risultato salvato. |
| --help | Mostra sintassi e bandiere per qualsiasi comando. |

#### Richiedi Markdown

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

- [Profili, JSON e piste ricorrenti](https://flashdata.dev/it/docs/guides/cli-automation/reference.md)

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

## Risoluzione dei problemi

| Problematiche | Prova questo |
| --- | --- |
| Comando non trovato | Controllare il download OS/CPU e PATH all'interno del terminale o agente in cui si esegue. |
| 401 / 403 | Eseguire auth status. Controllare le credenziali, gli override dell'ambiente e le autorizzazioni di origine. |
| 402 / 429 | Controllare Billing o richiedere una prova esausto. Per i limiti di tasso, seguire Retry-After. |
| L'uscita esiste / timeout | Ispezionare il file originale eseguito e salvato. Utilizzare la guida di recupero prima di presentare nuovi lavori a pagamento. |

- [Controllo dettagliato e recupero](https://flashdata.dev/it/docs/guides/cli-automation/reference.md#recover)
- [Billing](https://flashdata.dev/app/billing)

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

## Go ulteriore

- [Rivendica il tuo prova e mantieni l'accesso](https://flashdata.dev/it/docs/guides/agent-onboarding/reference.md#claim)
- [Attività ricorrenti](https://flashdata.dev/it/docs/guides/recurring-tasks/reference.md)
- [Installare l'abilità agente](https://flashdata.dev/it/docs/guides/agent-skill/reference.md)
- [Profili e memorizzazione delle credenziali](https://flashdata.dev/it/docs/guides/cli-automation/reference.md#profiles)
