# FlashData CLI

Поиск Google, извлечение данных YouTube и доставка мультимедиа с вашего терминала или агента AI. Один исполняемый файл; Node.js или Python не требуется.

Каноническая ссылка: https://flashdata.dev/ru/docs/guides/flashdata-cli
Разработчик: 2026-11-04 by 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/ru/docs/guides/flashdata-cli/reference.md#manual-install)

### Linux x64

Bash · Беги безымянно -м первым. Используйте эту сборку для 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/ru/docs/guides/flashdata-cli/reference.md#manual-install)

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

### Другие варианты установки

Отдельные команды устанавливают 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 --non-interactive (заменить кодекс фактическим поддерживаемым хостом).

#### Руководящая установка

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

- [OpenClaw и другие хосты навыков](https://flashdata.dev/ru/docs/guides/agent-skill/reference.md#other-hosts)

### Попробуйте с терминала

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

#### Начать пробный доступ

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


- [Пробный баланс и привязка](https://flashdata.dev/ru/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/ru/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/ru/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/ru/docs/guides/cli-automation/reference.md#recover)
- [Billing](https://flashdata.dev/app/billing)

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

## Иди дальше

- [Заявите о своем испытании и сохраните доступ](https://flashdata.dev/ru/docs/guides/agent-onboarding/reference.md#claim)
- [Регулярные задачи](https://flashdata.dev/ru/docs/guides/recurring-tasks/reference.md)
- [Установите мастерство агента](https://flashdata.dev/ru/docs/guides/agent-skill/reference.md)
- [Профили и хранение учетных данных](https://flashdata.dev/ru/docs/guides/cli-automation/reference.md#profiles)
