# FlashData CLI

Пошук Google, отримання даних YouTube та надання засобів масової інформації з вашого терміналу або агента AI. Один виконуваний; немає Node.js або Python обов'язкові.

Канонічне посилання: https://flashdata.dev/uk/docs/guides/flashdata-cli
Переглянуто: 2026-11-04 від FlashData

- [Завантажити CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1) — v1.2.1 · Linux / macOS / Windows
- [Контакти](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md) — Всі команди, прапори та вихідні коди

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

## 1. Встановити

Виберіть платформу. Ці рідні будівлі не потрібні Node.js або Python. Виконайте команди в збитковій папці; автономні завантаження перевіряють.

### macOS

З Homebrew встановлена:

#### Homebrew

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

- [Встановлення без Homebrew](https://flashdata.dev/uk/docs/guides/flashdata-cli/reference.md#manual-install)

### Linux x64

Bash · Запуск полум'я -m first. Використовуйте цю конструкцію для x86_64; Параметри ARM64 та пакетно-менеджера нижче.

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


- [Інші платформи та менеджери пакетів](https://flashdata.dev/uk/docs/guides/flashdata-cli/reference.md#manual-install)

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

### Варіанти монтажу

Команди Standalone встановлюють PATH для цього терміналу. Додайте вилучений каталог до вашого користувача PATH для пізніших сеансів, або скористайтеся абсолютною доріжкою.

#### 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](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/installation.md)
- [Випускні завантаження](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)

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

## 2. Налаштування доступу

Виберіть один шлях. Ці команди використовують профілі за замовчуванням; зберігати за допомогою одного профілю для пошуку та запиту.

### У мене є API ключ

Створіть або замініть ключ з дозволом Google Search. Вставте його в приховану логіку.

#### Заощаджуйте та перевірте доступ

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

- [Створіть ключ API](https://flashdata.dev/app/api-keys)

### Налаштуйте агента

Запуск з вашого проекту та оберіть Codex, Claude Code або Cursor. Налаштування налаштовує навички 16 та повторно використовує доступ або запити на один дозвілний тест. Не працює оплачена біржа. Автоматичний агент може використовувати --agent кодx --non-interactive (замінити кодкс з фактичним підтриманим хостом).

#### Налаштування керованих даних

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

- [OpenClaw та інші майстер-класи](https://flashdata.dev/uk/docs/guides/agent-skill/reference.md#other-hosts)

### Спробуйте з терміналу

Почати один дозвіл без навичок установлення агента. Google Search і YouTube Metadata запитуються за замовчуванням. Використовуйте дійсний збережений доступ, замість того, як ви вже маєте його.

#### Почати процес

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


- [Пробний баланс і прив’язування](https://flashdata.dev/uk/docs/guides/agent-onboarding/reference.md)

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

## 3. Запуск першого пошуку

Ця команда надсилає один Пошук Google до п'яти результатів і друкує відповідь.

### Пошук

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


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

### Що потрібно побачити

Шукаємо ok: true і data.status: done. Читання назв і URLs в data.results[].organic і заряду data.usage.credits. Приклад (скорочення):

#### Вихід терміналу

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

## Більше завдань CLI

Виберіть задачу нижче. Запитання щодо використання джерел ключів та кредитів. Перевірити джерело ключа перед перемиканням завдань; завантаження вимагає доступу власника.

### Google Search

Знайдіть сторінки з вибраним обліковим записом, мовою та контекстом країни.

#### Google Search

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


### YouTube Data

Пошук відео кандидата, після чого використовувати один повернутий відео ID з метаданими або транограмою. Кожна команда - окрема запиту; замініть зразок ID з вибраним відео.

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

Використовуйте ключ власника з дозволу youtube_download. Приготуйте приватний storage.json з налаштуваннями для зберігання вашого призначення за допомогою посилання на налаштування сховища в цій вкладці. Замініть відео ID з одним уповноваженим процесом. Ця команда чекає на роботу фону і зберігає запис доставки, а не медіа-файл.

#### Download audio

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

- [Приготувати storage.json](https://flashdata.dev/uk/docs/guides/cli-automation/reference.md#storage)

### Бухгалтерія

Перевірити ціни, баланс і дозволені джерела без подання запитань.

#### Ознайомитися з обліковими записами

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


- [Повна команда та посилання на прапорець](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md)

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

### Перегляд вартості до запиту

Ці команди прочитають баланс і кошторисують без виконання пошуку. Перевірити data.estimateAvailable і порівняти оцінку з доступними кредитами.

#### Рецензія

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


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

### Використання в скриптах і агентах

Для іншого призначеного пошуку виберіть новий запустіть ID і назву вихідного файлу. Не перезаписуються файли. Після перерву, перевірте існуючий запис до подання знову.

| Зареєструватися | Мета |
| --- | --- |
| --json | При отриманні машинно-прочитаного виконання з --output, дані описує збережений файл. |
| --non-interactive | Вимкніть підказки та відкриття браузера. |
| --output FILE | Заощаджуйте відповідь джерела на новий файл. |
| --run-id ID | Визначте одну призначену роботу і повторно використовуйте її збережений результат. |
| --help | Показати синтаксису та прапори для будь-якої команди. |

#### Запитайте на Markdown

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

- [Профілі, JSON і рецидивні роботи](https://flashdata.dev/uk/docs/guides/cli-automation/reference.md)

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

## Виправлення несправностей

| Проблема | Написати нам |
| --- | --- |
| Не знайдено | Перевірити завантаження OS/CPU і PATH всередині терміналу або агента, де ви запустіть його. |
| 401 / 403 | Запуск auth status. Перевірити облікові дані, перевизначення навколишнього середовища та дозволи на джерело. |
| 402 / 429 | Перевірити Billing або вимагати вичерпне випробування. Для лімітів курсу слідуйте за Retry-After. |
| Вихід існує / час | Ознайомтеся з оригінальним запуском і збереженим файлом. Використовуйте посібник для відновлення перед поданням нової платної роботи. |

- [Детальні перевірки та відновлення](https://flashdata.dev/uk/docs/guides/cli-automation/reference.md#recover)
- [Billing](https://flashdata.dev/app/billing)

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

## Далі

- [Створіть свій тест і зберігайте доступ](https://flashdata.dev/uk/docs/guides/agent-onboarding/reference.md#claim)
- [Регулярні завдання](https://flashdata.dev/uk/docs/guides/recurring-tasks/reference.md)
- [Встановити навички агента](https://flashdata.dev/uk/docs/guides/agent-skill/reference.md)
- [Профілі та облікове сховище](https://flashdata.dev/uk/docs/guides/cli-automation/reference.md#profiles)
