Parcourir la documentation
Premiers pas
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.
Sur cette page
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.
Si Homebrew est installé :
brew install flashdatadev/tap/flashdata
flashdata --versionBash · Exécutez d’abord uname -m. Cette version convient à x86_64 ; les options ARM64 et les gestionnaires de paquets figurent ci-dessous.
# 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
}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.
# 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. 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.
Créez ou réutilisez une clé autorisant Google Search. Collez-la dans la saisie masquée de la commande de connexion.
flashdata auth login
flashdata auth statusExé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é.
flashdata setup
flashdata auth statusDé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.
flashdata init --name "My CLI"
flashdata auth status3. Lancer votre première recherche
Cette commande effectue une recherche Google, demande jusqu’à cinq résultats et affiche la réponse.
flashdata search "battery recycling research" --num 5Ré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é :
{
"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
}
}
}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.
Recherchez des pages en choisissant le nombre de résultats, la langue et le pays.
flashdata search "battery recycling research" --num 5 --hl en --gl us --jsonRecherchez 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.
flashdata youtube search "battery recycling" --max-results 5 --jsonflashdata youtube metadata FUfGcZ092b0 --jsonflashdata youtube transcript FUfGcZ092b0 --language en --jsonUtilisez 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.
flashdata youtube download FUfGcZ092b0 --format mp3 --storage-config storage.json --wait --output delivery.json --jsonConsultez les tarifs, le solde et les sources autorisées sans lancer de requête de données.
flashdata account balance
flashdata account pricing --source google_search --request-count 1
flashdata sources listEstimer 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.
flashdata account balance
flashdata search "battery recycling research" --num 5 --dry-run --jsonUtiliser 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. |
flashdata search "battery recycling research" --accept text/plain --respond-with markdown --json=falseDé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. |