# CLI FlashData

Recherchez sur Google, récupérez des données YouTube et transférez des médias depuis votre terminal ou votre agent IA. Un seul exécutable, sans Node.js ni Python.

Référence canonique : https://flashdata.dev/fr/docs/guides/flashdata-cli
Vérifié le 2026-11-04 par FlashData

- [Télécharger la CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1) — v1.2.1 · Linux / macOS / Windows
- [Référence des commandes](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md) — Toutes les commandes, options et codes de sortie

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

## 1. Installer

Choisissez votre plateforme. Ces exécutables natifs ne nécessitent ni Node.js ni Python. Exécutez les commandes dans un dossier accessible en écriture. L’intégrité des téléchargements autonomes est vérifiée par somme de contrôle.

### macOS

Si Homebrew est installé :

#### Homebrew

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

- [Installer sans Homebrew](https://flashdata.dev/fr/docs/guides/flashdata-cli/reference.md#manual-install)

### Linux x64

Bash · Exécutez d’abord uname -m. Cette version convient à x86_64 ; les options ARM64 et les gestionnaires de paquets figurent ci-dessous.

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


- [Autres plateformes et gestionnaires de paquets](https://flashdata.dev/fr/docs/guides/flashdata-cli/reference.md#manual-install)

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

### Autres méthodes d’installation

Les commandes d’installation autonome définissent PATH pour ce terminal. Ajoutez le dossier extrait à votre PATH utilisateur pour les prochaines sessions, ou utilisez le chemin absolu de l’exécutable.

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


- [Installation avec APT ou RPM](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/installation.md)
- [Télécharger une version](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)

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

## 2. Configurer l’accès

Choisissez une méthode. Ces commandes utilisent le profil par défaut. Conservez le même profil pour vos recherches et le rattachement de l’essai.

### J’ai une clé API

Créez ou réutilisez une clé autorisant Google Search. Collez-la dans la saisie masquée de la commande de connexion.

#### Enregistrer et vérifier l’accès

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

- [Créer une clé API](https://flashdata.dev/app/api-keys)

### Configurer mon agent

Exécutez la commande depuis votre projet et choisissez Codex, Claude Code ou Cursor. La configuration installe 16 skills et réutilise l’accès enregistré ou demande un essai si vous y êtes éligible. Elle n’exécute aucune requête payante. Un agent automatisé peut utiliser --agent codex --non-interactive ; remplacez codex par l’hôte compatible utilisé.

#### Configuration guidée

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

- [OpenClaw et autres hôtes de skills](https://flashdata.dev/fr/docs/guides/agent-skill/reference.md#other-hosts)

### Essayer depuis le terminal

Démarrez un seul essai, sous réserve d’éligibilité, sans installer de skills. Google Search et YouTube Metadata sont demandés par défaut. Si vous disposez déjà d’un accès enregistré valide, réutilisez-le.

#### Démarrer un essai

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


- [Quota d’essai et rattachement au compte](https://flashdata.dev/fr/docs/guides/agent-onboarding/reference.md)

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

## 3. Lancer votre première recherche

Cette commande effectue une recherche Google, demande jusqu’à cinq résultats et affiche la réponse.

### Rechercher

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


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

### Résultat attendu

Vérifiez ok: true et data.status: done. Les titres et URL se trouvent dans data.results[].organic, et le coût dans data.usage.credits. Exemple abrégé :

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

## Autres tâches avec la CLI

Choisissez une tâche ci-dessous. Les requêtes utilisent les autorisations de sources et les crédits associés à la clé connectée. Vérifiez les sources autorisées avant de changer de tâche. Les téléchargements nécessitent un accès propriétaire.

### Google Search

Recherchez des pages en choisissant le nombre de résultats, la langue et le pays.

#### Google Search

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


### YouTube Data

Recherchez des vidéos, puis utilisez l’un des identifiants obtenus avec metadata ou transcript. Chaque commande constitue une requête distincte. Remplacez l’identifiant d’exemple par celui de la vidéo choisie.

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

Utilisez une clé propriétaire avec l’autorisation youtube_download. Préparez un fichier storage.json privé contenant les paramètres du stockage de destination, en suivant le lien de configuration dans cet onglet. Remplacez l’identifiant vidéo par celui d’un contenu que vous êtes autorisé à traiter. Cette commande attend la fin du traitement en arrière-plan et enregistre un compte rendu du transfert, pas le fichier multimédia.

#### Download audio

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

- [Préparer storage.json](https://flashdata.dev/fr/docs/guides/cli-automation/reference.md#storage)

### Compte

Consultez les tarifs, le solde et les sources autorisées sans lancer de requête de données.

#### Consulter le compte

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


- [Référence complète des commandes et options](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md)

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

### Estimer le coût avant une requête

Ces commandes consultent votre solde et l’estimation sans lancer de recherche. Vérifiez data.estimateAvailable et comparez l’estimation aux crédits disponibles.

#### Estimer

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


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

### Utiliser la CLI dans des scripts et des agents

Pour une nouvelle recherche, choisissez un nouvel identifiant d’exécution et un nouveau nom de fichier de sortie. Les fichiers existants ne sont pas écrasés. Après une interruption, examinez l’enregistrement existant avant de soumettre à nouveau la requête.

| Option | Rôle |
| --- | --- |
| --json | Reçu d’exécution lisible par un programme ; avec --output, data décrit le fichier enregistré. |
| --non-interactive | Désactiver les invites interactives et l’ouverture du navigateur. |
| --output FILE | Enregistrer la réponse de la source dans un nouveau fichier. |
| --run-id ID | Identifier une exécution prévue et réutiliser son résultat enregistré. |
| --help | Afficher la syntaxe et les options d’une commande. |

#### Demander du Markdown

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

- [Profils, JSON et tâches récurrentes](https://flashdata.dev/fr/docs/guides/cli-automation/reference.md)

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

## Dépannage

| Problème | Solution |
| --- | --- |
| Commande introuvable | Vérifiez que le téléchargement correspond à votre système et à votre processeur, ainsi que le PATH du terminal ou de l’agent qui exécute la commande. |
| 401 / 403 | Exécutez auth status. Vérifiez les identifiants, les éventuelles variables d’environnement prioritaires et les autorisations de sources. |
| 402 / 429 | Consultez la facturation ou rattachez l’essai épuisé à votre compte. En cas de limite de débit, respectez Retry-After. |
| Fichier de sortie existant ou délai dépassé | Examinez l’exécution d’origine et le fichier enregistré. Consultez le guide de récupération avant de lancer un nouveau traitement payant. |

- [Diagnostic et récupération](https://flashdata.dev/fr/docs/guides/cli-automation/reference.md#recover)
- [Billing](https://flashdata.dev/app/billing)

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

## Pour aller plus loin

- [Rattacher votre essai et conserver l’accès](https://flashdata.dev/fr/docs/guides/agent-onboarding/reference.md#claim)
- [Tâches récurrentes](https://flashdata.dev/fr/docs/guides/recurring-tasks/reference.md)
- [Installer le skill d’agent](https://flashdata.dev/fr/docs/guides/agent-skill/reference.md)
- [Profils et stockage des identifiants](https://flashdata.dev/fr/docs/guides/cli-automation/reference.md#profiles)
