Przejdź do treści
PL
Uzyskaj klucz API
Przeglądaj dokumentację

Pierwsze kroki

FlashData CLI

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

Na tej stronie

1. Instalacja

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

Z zainstalowanym Homebrew:

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

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
# 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. Ustaw dostęp

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

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

Zapisz i sprawdź dostęp
flashdata auth login
flashdata auth status

3. Uruchom swoje pierwsze wyszukiwanie

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

Szukaj
flashdata search "battery recycling research" --num 5

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
{
  "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
    }
  }
}

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.

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

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

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
flashdata account balance
flashdata search "battery recycling research" --num 5 --dry-run --json

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.

OpcjaCel
--jsonParagon wykonania do odczytu maszynowego; za pomocą --output dane opisują zapisany plik.
--non-interactiveWyłącz podpowiedzi i otwieranie przeglądarki.
--output FILEZapisz odpowiedź źródłową do nowego pliku.
--run-id IDOkreślić zamierzony wynik i ponownie wykorzystać zapisany wynik.
--helpPokaż składnię i flagi dla dowolnych poleceń.
Pytaj o Markdown
flashdata search "battery recycling research" --accept text/plain --respond-with markdown --json=false

Rozwiązywanie problemów

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

Idź dalej