Überspringen zum Inhalt
DE
API-Schlüssel
Dokumentation durchsuchen

Erste Schritte

FlashData CLI

Suchen Sie Google, holen Sie YouTube-Daten ab und liefern Sie Medien von Ihrem Terminal oder AI-Agenten. Eine ausführbare Datei; keine Node.js oder Python erforderlich.

Auf dieser Seite

1. Installieren

Wählen Sie Ihre Plattform. Diese nativen Builds benötigen keine Node.js oder Python. Führen Sie die Befehle in einem beschreibbaren Ordner aus; Standalone-Downloads sind Checksum-verifiziert.

Mit Homebrew installiert:

Homebrew
brew install flashdatadev/tap/flashdata
flashdata --version

Andere Installationsoptionen

Standalone-Befehle setzen PATH für dieses Terminal. Fügen Sie das extrahierte Verzeichnis Ihrem Benutzer PATH für spätere Sitzungen hinzu oder verwenden Sie den absoluten Pfad der ausführbaren Datei.

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

Wähle einen Weg. Diese befehle verwenden das standardprofil; verwenden sie das gleiche profil für ihre suchanfragen und beanspruchungen.

Erstellen oder Wiederverwenden eines Schlüssels mit der Google Search-Berechtigung. Fügen Sie es in die versteckte Login-Eingabeaufforderung ein.

Sichern und Überprüfen des Zugriffs
flashdata auth login
flashdata auth status

3. Führen Sie Ihre erste Suche aus

Dieser Befehl sendet eine Google-Suche nach bis zu fünf Ergebnissen und druckt die Antwort aus.

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

Was Sie sehen sollten

Suchen Sie nach ok: true und data.status: done. Lesen Sie Titel und URLs in data.results[].organic und die Ladung in data.usage.credits. Beispiel (abgekürzt):

Klemmenausgang
{
  "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
    }
  }
}

Weitere CLI Aufgaben

Wählen Sie unten eine Aufgabe aus. Abfragen verwenden die Quellberechtigungen und Credits des verbundenen Schlüssels. Überprüfen Sie die zulässigen Quellen des Schlüssels, bevor Sie Aufgaben wechseln; Downloads erfordern den Zugriff des Besitzers.

Suchen Sie Seiten mit einer gewählten Ergebniszahl, Sprache und Länderkontext.

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

Vorschau der Kosten vor einer Abfrage

Diese Befehle lesen Sie Ihr Guthaben und schätzen, ohne eine Suche auszuführen. Überprüfen Sie data.estimateAvailable und vergleichen Sie die Schätzung mit verfügbaren Credits.

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

Verwendung in Skripten und Agenten

Wählen Sie für eine andere vorgesehene Suche einen neuen ID-Lauf und geben Sie den Dateinamen aus. Bestehende Dateien werden nicht überschrieben. Nach einem unterbrochenen Durchlauf prüfen Sie den vorhandenen Datensatz, bevor Sie ihn erneut einreichen.

OptionZweck
--jsonMaschinenlesbarer Ausführungsbeleg; mit --output beschreiben Daten die gespeicherte Datei.
--non-interactiveDeaktivieren Sie Eingabeaufforderungen und Browseröffnung.
--output FILESpeichern Sie die Antwort auf eine neue Datei.
--run-id IDIdentifizieren Sie einen beabsichtigten Lauf und verwenden Sie das gespeicherte Ergebnis wieder.
--helpZeigen Sie Syntax und Flags für jeden Befehl.
Fragen Sie nach Markdown
flashdata search "battery recycling research" --accept text/plain --respond-with markdown --json=false

Fehlerbehebung

ProblemProbieren Sie dies aus
Befehl nicht gefundenÜberprüfen Sie den OS/CPU-Download und den PATH im Terminal oder Agent, in dem Sie ihn ausführen.
401 / 403Führen Sie auth status. Prüfen Sie Anmeldeinformationen, Umgebungsüberschreibungen und Quellberechtigungen.
402 / 429Überprüfen Sie Billing oder fordern Sie eine erschöpfte Studie an. Für Tariflimits folgen Sie Retry-After.
Output existiert / TimeoutÜberprüfen Sie die ursprüngliche ausgeführte und gespeicherte Datei. Verwenden Sie den Recovery Guide, bevor Sie neue bezahlte Arbeit einreichen.

Weiter gehen