Перейти к содержимому
RU
Ключ API
Обзор документации

Начало работы

FlashData CLI

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

На этой странице

1. устанавливать

Выберите свою платформу. Эти нативные сборки не нуждаются в Node.js или Python. Запустите команды в написанной папке; автономные загрузки проверены контрольной суммой.

С Homebrew установлен:

Homebrew
brew install flashdatadev/tap/flashdata
flashdata --version

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

Отдельные команды устанавливают PATH для этого терминала. Добавьте извлеченный каталог к вашему пользователю PATH для последующих сессий или используйте абсолютный путь исполняемого файла.

Linux 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_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

2. Настройка доступа

Выберите один путь. Эти команды используют профиль по умолчанию; продолжайте использовать один и тот же профиль для поиска и утверждения.

Создавать или повторно использовать ключ с разрешения Google Search. Вставьте его в скрытую строку входа.

Сохранить и проверить доступ
flashdata auth login
flashdata auth status

3. Запустите свой первый поиск

Эта команда отправляет один 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

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

Найдите страницы с выбранным количеством результатов, языком и контекстом страны.

Google Search
flashdata search "battery recycling research" --num 5 --hl en --gl us --json

Просмотреть стоимость перед запросом

Эти команды читают ваш баланс и оценивают, не выполняя поиск. Проверьте 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Показать синтаксис и флаги для любой команды.
Запросить Markdown
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.
Выход есть / тайм-аутПроверить исходный запуск и сохраненный файл. Используйте руководство по восстановлению перед отправкой новой оплачиваемой работы.

Иди дальше