Dokumentation durchsuchen
Erste Schritte
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:
brew install flashdatadev/tap/flashdata
flashdata --versionBash · Führen Sie uname -m zuerst aus. Verwenden Sie diesen Build für x86_64; ARM64 und Paket-Manager-Optionen sind unten.
# 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
}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.
# 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. 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.
flashdata auth login
flashdata auth statusFühren Sie aus Ihrem Projekt aus und wählen Sie Codex, Claude Code oder Cursor. Setup installiert 16-Fähigkeiten und verwendet den Zugriff wieder oder fordert eine berechtigte Testversion an. Es läuft keine bezahlte Abfrage. Ein automatisierter Agent kann den --agent-Codex --non-interactive verwenden (Codex durch den tatsächlich unterstützten Host ersetzen).
flashdata setup
flashdata auth statusStarten Sie eine berechtigte Studie, ohne Agentenfähigkeiten zu installieren. Google Search und YouTube Metadata werden standardmäßig angefordert. Verwenden Sie stattdessen den gültigen gespeicherten Zugriff wieder, wenn Sie ihn bereits haben.
flashdata init --name "My CLI"
flashdata auth status3. Führen Sie Ihre erste Suche aus
Dieser Befehl sendet eine Google-Suche nach bis zu fünf Ergebnissen und druckt die Antwort aus.
flashdata search "battery recycling research" --num 5Was 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):
{
"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.
flashdata search "battery recycling research" --num 5 --hl en --gl us --jsonSuchen Sie nach Kandidatenvideos und verwenden Sie dann ein zurückgegebenes Video ID mit Metadaten oder Transkript. Jeder Befehl ist eine separate Abfrage; Ersetzen Sie das Beispiel ID mit dem ausgewählten Video.
flashdata youtube search "battery recycling" --max-results 5 --jsonflashdata youtube metadata FUfGcZ092b0 --jsonflashdata youtube transcript FUfGcZ092b0 --language en --jsonVerwenden Sie einen Besitzerschlüssel mit youtube_download Berechtigung. Bereiten Sie einen privaten storage.json mit Ihren Zielspeichereinstellungen vor, indem Sie den Speichereinrichtungslink in dieser Registerkarte verwenden. Ersetzen Sie das Video ID durch eines, das Sie verarbeiten dürfen. Dieser Befehl wartet auf den Hintergrundjob und speichert einen Lieferdatensatz, nicht die Mediendatei.
flashdata youtube download FUfGcZ092b0 --format mp3 --storage-config storage.json --wait --output delivery.json --jsonÜberprüfen Sie die Preise, den Saldo und die zulässigen Quellen, ohne Abfragen einzureichen.
flashdata account balance
flashdata account pricing --source google_search --request-count 1
flashdata sources listVorschau 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.
flashdata account balance
flashdata search "battery recycling research" --num 5 --dry-run --jsonVerwendung 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.
| Option | Zweck |
|---|---|
| --json | Maschinenlesbarer Ausführungsbeleg; mit --output beschreiben Daten die gespeicherte Datei. |
| --non-interactive | Deaktivieren Sie Eingabeaufforderungen und Browseröffnung. |
| --output FILE | Speichern Sie die Antwort auf eine neue Datei. |
| --run-id ID | Identifizieren Sie einen beabsichtigten Lauf und verwenden Sie das gespeicherte Ergebnis wieder. |
| --help | Zeigen Sie Syntax und Flags für jeden Befehl. |
flashdata search "battery recycling research" --accept text/plain --respond-with markdown --json=falseFehlerbehebung
| Problem | Probieren 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 / 403 | Fü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. |