Обзор документации
Начало работы
Поиск Google, извлечение данных YouTube и доставка мультимедиа с вашего терминала или агента AI. Один исполняемый файл; Node.js или Python не требуется.
На этой странице
1. устанавливать
Выберите свою платформу. Эти нативные сборки не нуждаются в Node.js или Python. Запустите команды в написанной папке; автономные загрузки проверены контрольной суммой.
С Homebrew установлен:
brew install flashdatadev/tap/flashdata
flashdata --versionBash · Беги безымянно -м первым. Используйте эту сборку для x86_64; Варианты ARM64 и пакетного менеджера приведены ниже.
# 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
}Другие варианты установки
Отдельные команды устанавливают PATH для этого терминала. Добавьте извлеченный каталог к вашему пользователю PATH для последующих сессий или используйте абсолютный путь исполняемого файла.
# 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. Настройка доступа
Выберите один путь. Эти команды используют профиль по умолчанию; продолжайте использовать один и тот же профиль для поиска и утверждения.
Создавать или повторно использовать ключ с разрешения Google Search. Вставьте его в скрытую строку входа.
flashdata auth login
flashdata auth statusВыберите Codex, Claude Code или Cursor. Настройка устанавливает навыки 16 и повторно использует доступ или запрашивает одно подходящее испытание. Он не выполняет платный запрос. Автоматизированный агент может использовать кодекс --agent --non-interactive (заменить кодекс фактическим поддерживаемым хостом).
flashdata setup
flashdata auth statusНачните одно приемлемое испытание без установки навыков агента. Google Search и YouTube Metadata запрашиваются по умолчанию. Повторное использование действительного сохраненного доступа, если он у вас уже есть.
flashdata init --name "My CLI"
flashdata auth status3. Запустите свой первый поиск
Эта команда отправляет один Google поиск до пяти результатов и печатает ответ.
flashdata search "battery recycling research" --num 5Что вы должны увидеть
Ищите ok: true и data.status: done. Прочитайте названия и URLs в data.results[].organic и заряд в data.usage.credits. Пример (сокращенно):
{
"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
}
}
}Больше задач CLI
Выберите задачу ниже. Запросы используют исходные разрешения и кредиты подключенного ключа. Проверьте разрешенные источники ключа перед переключением задач; для загрузки требуется доступ владельца.
Найдите страницы с выбранным количеством результатов, языком и контекстом страны.
flashdata search "battery recycling research" --num 5 --hl en --gl us --jsonПоиск видео-кандидатов, а затем использование одного возвращенного видео ID с метаданными или транскриптом. Каждая команда представляет собой отдельный запрос; замените образец ID выбранным вами видео.
flashdata youtube search "battery recycling" --max-results 5 --jsonflashdata youtube metadata FUfGcZ092b0 --jsonflashdata youtube transcript FUfGcZ092b0 --language en --jsonИспользуйте ключ владельца с разрешения youtube_download. Подготовьте частный storage.json с настройками хранения назначения, используя ссылку настройки хранилища в этой вкладке. Замените видео ID на то, которое вы имеете право обрабатывать. Эта команда ждет фоновой работы и сохраняет запись доставки, а не медиафайл.
flashdata youtube download FUfGcZ092b0 --format mp3 --storage-config storage.json --wait --output delivery.json --jsonПроверяйте цены, баланс и разрешенные источники без отправки запросов.
flashdata account balance
flashdata account pricing --source google_search --request-count 1
flashdata sources listПросмотреть стоимость перед запросом
Эти команды читают ваш баланс и оценивают, не выполняя поиск. Проверьте data.estimateAvailable и сравните оценку с доступными кредитами.
flashdata account balance
flashdata search "battery recycling research" --num 5 --dry-run --jsonИспользование в скриптах и агентах
Для другого предполагаемого поиска выберите новый запуск ID и выведите имя файла. Существующие файлы не перезаписываются. После прерванного пробега проверьте существующую запись, прежде чем отправлять ее снова.
| Вариант | Цель |
|---|---|
| --json | Машиночитаемая квитанция исполнения; с --output данные описывают сохраненный файл. |
| --non-interactive | Отключить подсказки и открытие браузера. |
| --output FILE | Сохраните исходный ответ на новый файл. |
| --run-id ID | Определите один предполагаемый запуск и повторно используйте его сохраненный результат. |
| --help | Показать синтаксис и флаги для любой команды. |
flashdata search "battery recycling research" --accept text/plain --respond-with markdown --json=falseустранение неполадок
| Проблема | Попробуйте |
|---|---|
| Командование не найдено | Проверьте загрузку OS/CPU и PATH в терминале или агенте, где вы его запускаете. |
| 401 / 403 | Запустите auth status. Проверьте учетные данные, экологические ограничения и разрешения на источники. |
| 402 / 429 | Проверьте Billing или исчерпайте все испытания. Для ограничений по ставкам следуйте Retry-After. |
| Выход есть / тайм-аут | Проверить исходный запуск и сохраненный файл. Используйте руководство по восстановлению перед отправкой новой оплачиваемой работы. |