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

Kanonische Referenz: https://flashdata.dev/de/docs/guides/flashdata-cli
Test: 2026-11-04 von FlashData

- [Download CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1) — v1.2.1 · Linux / macOS / Windows
- [Befehlsnummer](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md) — Alle Befehle, Flags und Ausstiegscodes

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

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

### macOS

Mit Homebrew installiert:

#### Homebrew

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

- [Installieren Sie ohne Homebrew](https://flashdata.dev/de/docs/guides/flashdata-cli/reference.md#manual-install)

### Linux x64

Bash · Führen Sie uname -m zuerst aus. Verwenden Sie diesen Build für x86_64; ARM64 und Paket-Manager-Optionen sind unten.

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


- [Andere Plattformen und Paketmanager](https://flashdata.dev/de/docs/guides/flashdata-cli/reference.md#manual-install)

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

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

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


- [APT / RPM-Einrichtung](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/installation.md)
- [Downloads freigeben](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)

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

## 2. Zugang einrichten

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

### Ich habe einen API Schlüssel

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

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

- [Erstellen Sie einen API-Schlüssel](https://flashdata.dev/app/api-keys)

### Meinen Agenten einrichten

Fü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).

#### Geführte Einrichtung

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

- [OpenClaw und andere Skill-Hosts](https://flashdata.dev/de/docs/guides/agent-skill/reference.md#other-hosts)

### Probieren Sie vom Terminal aus

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

#### Beginnen Sie einen Versuch

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


- [Prüfungsentschädigung und Antragstellung](https://flashdata.dev/de/docs/guides/agent-onboarding/reference.md)

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

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

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


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

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

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

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

### Google Search

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

#### Google Search

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


### YouTube Data

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

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

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

#### Download audio

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

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

### Konto

Überprüfen Sie die Preise, den Saldo und die zulässigen Quellen, ohne Abfragen einzureichen.

#### Kontoauslese

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


- [Vollständiges Kommando und Flaggenreferenz](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md)

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

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

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


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

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

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

#### Fragen Sie nach Markdown

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

- [Profile, JSON und wiederkehrende Runs](https://flashdata.dev/de/docs/guides/cli-automation/reference.md)

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

## Fehlerbehebung

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

- [Detaillierte Kontrollen und Wiedereinziehung](https://flashdata.dev/de/docs/guides/cli-automation/reference.md#recover)
- [Billing](https://flashdata.dev/app/billing)

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

## Weiter gehen

- [Beantragen Sie Ihren Versuch und behalten Sie den Zugang](https://flashdata.dev/de/docs/guides/agent-onboarding/reference.md#claim)
- [Wiederkehrende Aufgaben](https://flashdata.dev/de/docs/guides/recurring-tasks/reference.md)
- [Installieren Sie die Agent Skill](https://flashdata.dev/de/docs/guides/agent-skill/reference.md)
- [Profile und Credential Storage](https://flashdata.dev/de/docs/guides/cli-automation/reference.md#profiles)
