Aller au contenu
FR
Obtenir une clé API
Parcourir la documentation

Premiers pas

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.

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é :

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

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

Enregistrer et vérifier l’accès
flashdata auth login
flashdata auth status

3. Lancer votre première recherche

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

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

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

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

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

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.

OptionRôle
--jsonReçu d’exécution lisible par un programme ; avec --output, data décrit le fichier enregistré.
--non-interactiveDésactiver les invites interactives et l’ouverture du navigateur.
--output FILEEnregistrer la réponse de la source dans un nouveau fichier.
--run-id IDIdentifier une exécution prévue et réutiliser son résultat enregistré.
--helpAfficher la syntaxe et les options d’une commande.
Demander du Markdown
flashdata search "battery recycling research" --accept text/plain --respond-with markdown --json=false

Dépannage

ProblèmeSolution
Commande introuvableVé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 / 403Exécutez auth status. Vérifiez les identifiants, les éventuelles variables d’environnement prioritaires et les autorisations de sources.
402 / 429Consultez 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.

Pour aller plus loin