# FlashData CLI

Szukaj Google, pobieraj dane YouTube i dostarczaj media z terminala lub agenta AI. Jeden wykonywalny; nie wymaga Node.js ani Python.

Odniesienie kanoniczne: https://flashdata.dev/pl/docs/guides/flashdata-cli
Przegląd: 2026-11-04 przez FlashData

- [Pobierz CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1) — v1.2.1 · Linux / macOS / Windows
- [Odniesienie do poleceń](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md) — Wszystkie polecenia, flagi i kody wyjścia

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

## 1. Instalacja

Wybierz platformę. Te rodzime budowle nie potrzebują Node.js lub Python. Uruchom polecenia w folderze do zapisu; samotne pobieranie jest sprawdzane.

### macOS

Z zainstalowanym Homebrew:

#### Homebrew

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

- [Instalacja bez Homebrew](https://flashdata.dev/pl/docs/guides/flashdata-cli/reference.md#manual-install)

### Linux x64

Bash · Uruchom uname -m pierwszy. Użyj tej konstrukcji dla x86_64; Opcje ARM64 i Package- manager są poniżej.

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


- [Inne platformy i podmioty zarządzające pakietami](https://flashdata.dev/pl/docs/guides/flashdata-cli/reference.md#manual-install)

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

### Inne opcje instalacji

Polecenia standalone ustawione dla tego terminala PATH. Dodaj wyekstrahowany katalog do użytkownika PATH do późniejszych sesji lub użyj ścieżki bezwzględnej wykonywalnego.

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


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

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

## 2. Ustaw dostęp

Wybierz jedną ścieżkę. Polecenia te używają domyślnego profilu; używaj tego samego profilu do wyszukiwania i twierdzenia.

### Mam klucz API

Utwórz lub ponownie użyj klucza za pozwoleniem Google Search. Wklej go do ukrytego hasła.

#### Zapisz i sprawdź dostęp

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

- [Utwórz klucz API](https://flashdata.dev/app/api-keys)

### Ustaw mojego agenta

Uruchom z projektu i wybierz Codex, Claude Code lub Cursor. Instaluje umiejętności 16 i ponownie wykorzystuje dostęp lub żąda jednego kwalifikowanego procesu. Nie ma płatnego zapytania. Automatyczny agent może używać kodu --agent --non-interactive (zastąpić kod obsługiwanym hostem).

#### Ustawienie z przewodnikiem

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

- [OpenClaw i inne hosty umiejętności](https://flashdata.dev/pl/docs/guides/agent-skill/reference.md#other-hosts)

### Spróbuj z terminala

Rozpocząć jeden kwalifikujący się proces bez instalowania umiejętności agenta. Domyślnie wymagane są Google Search i YouTube Metadata. Jeśli masz już zapisany dostęp, ponownie użyj poprawnego zapisanego dostępu.

#### Rozpoczęcie procesu

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


- [Dodatek na rozprawę i roszczenie](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md)

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

## 3. Uruchom swoje pierwsze wyszukiwanie

Polecenie to wysyła jeden Google wyszukiwanie do pięciu wyników i drukuje odpowiedź.

### Szukaj

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


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

### Co powinieneś zobaczyć

Szukaj ok: true i data.status: done. Czytaj tytuły i URLs w data.results[].organic i opłaty w data.usage.credits. Przykład (skrócony):

#### Wyjście terminala

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

## Więcej zadań CLI

Wybierz zadanie poniżej. Zapytania używają podłączonych uprawnień źródłowych i kredytów. Sprawdzić dozwolone źródła klucza przed zmianą zadań; pobieranie wymaga dostępu właściciela.

### Google Search

Znajdź strony z wybraną liczbą wyników, kontekstem językowym i country.

#### Google Search

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


### YouTube Data

Szukaj filmów kandydackich, a następnie użyj jednego zwróconego wideo ID z metadanych lub transkrypcji. Każde polecenie jest osobnym zapytaniem; zastąp próbkę ID wybranym filmem.

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

Użyj klucza właściciela za pozwoleniem youtube_download. Przygotuj prywatne storage.json z ustawieniami docelowymi pamięci masowej za pomocą łącza konfiguracji pamięci masowej w tej zakładce. Zastąp wideo ID jednym, do którego jesteś upoważniony. Polecenie to czeka na zadanie w tle i zapisuje zapis dostawy, a nie plik multimedialny.

#### Download audio

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

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

### Konto

Sprawdzić ceny, równowagę i dozwolone źródła bez składania zapytań.

#### Konto odczytuje

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


- [Pełne odniesienie do poleceń i znaczników](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md)

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

### Podgląd kosztów przed zapytaniem

Polecenia te odczytywane są z bilansu i szacowane bez uruchamiania wyszukiwania. Sprawdź data.estimateAvailable i porównaj szacunki z dostępnymi kredytami.

#### Podgląd

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


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

### Stosowanie w skryptach i agentach

Dla innego zamierzonego wyszukiwania, wybierz nowy run ID i nazwę pliku wyjściowego. Istniejące pliki nie są nadpisane. Po przerwaniu biegu należy sprawdzić istniejący rekord przed ponownym złożeniem.

| Opcja | Cel |
| --- | --- |
| --json | Paragon wykonania do odczytu maszynowego; za pomocą --output dane opisują zapisany plik. |
| --non-interactive | Wyłącz podpowiedzi i otwieranie przeglądarki. |
| --output FILE | Zapisz odpowiedź źródłową do nowego pliku. |
| --run-id ID | Określić zamierzony wynik i ponownie wykorzystać zapisany wynik. |
| --help | Pokaż składnię i flagi dla dowolnych poleceń. |

#### Pytaj o Markdown

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

- [Profile, JSON i powtarzające się operacje](https://flashdata.dev/pl/docs/guides/cli-automation/reference.md)

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

## Rozwiązywanie problemów

| Problem | Spróbuj tego |
| --- | --- |
| Polecenie nie znaleziono | Sprawdź pobranie OS/CPU i PATH wewnątrz terminala lub agenta, w którym go uruchomisz. |
| 401 / 403 | Uruchom auth status. Sprawdzić referencje, nadwyżek środowiska i uprawnienia źródłowe. |
| 402 / 429 | Sprawdzić Billing lub zażądać wyczerpanego procesu. W odniesieniu do wartości granicznych, należy postępować zgodnie z Retry-After. |
| Wyjście istnieje / timeout | Sprawdź oryginał i zapisany plik. Przed przedłożeniem nowej płatnej pracy należy skorzystać z przewodnika dotyczącego odzyskiwania. |

- [Szczegółowe kontrole i odzysk](https://flashdata.dev/pl/docs/guides/cli-automation/reference.md#recover)
- [Billing](https://flashdata.dev/app/billing)

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

## Idź dalej

- [Uściśnij swój proces i utrzymuj dostęp](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md#claim)
- [Zadania cykliczne](https://flashdata.dev/pl/docs/guides/recurring-tasks/reference.md)
- [Zainstaluj umiejętności agenta](https://flashdata.dev/pl/docs/guides/agent-skill/reference.md)
- [Profile i dane uwierzytelniające](https://flashdata.dev/pl/docs/guides/cli-automation/reference.md#profiles)
