# FlashData CLI

Cari Google, ambil data YouTube dan kirim media dari terminal atau agen AI anda. Satu dapat dieksekusi; tidak ada Node.js atau Python yang diperlukan.

Referensi boonical: https://flashdata.dev/ms/docs/guides/flashdata-cli
Diulas: 2026-11-04 oleh FlashData

- [Muaturun CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1) — v1.2.1 · Linux / macOS / Windows
- [Referensi perintah ufs](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md) — Semua perintah, bendera dan kode keluar

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

## 1. Instal

Pilihlah platformmu. Bangunan asli ini tidak membutuhkan Node.js atau Python. Menjalankan perintah di dalam folder yang dapat ditulis; unduhan sendiri adalah checksum-verifikasi.

### macOS

Dengan terpasangnya Homebrew:

#### Homebrew

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

- [Pasang tanpa Homebrew](https://flashdata.dev/ms/docs/guides/flashdata-cli/reference.md#manual-install)

### Linux x64

Bash · Jalankan tidak sama -m pertama. Gunakan ini untuk x86_64; pilihan ARM64 dan paket-manager berada di bawah.

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


- [Manajer paket dan platform dan paket lainnya berteknologi tinggi](https://flashdata.dev/ms/docs/guides/flashdata-cli/reference.md#manual-install)

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

### Opsi pemasangan lain-lain

Perintah Standalone set PATH untuk terminal ini. Tambah direktori terekstrak ke pengguna Anda PATHQ untuk sesi selanjutnya, atau gunakan jalur mutlak executable.

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


- [Pengaturan APT / RPM](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/installation.md)
- [Pengunduhan Rilis Meminum](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)

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

## 2. Mengatur akses

Pilih satu jalan. Perintah-perintah ini menggunakan profil default; tetap gunakan profil yang sama untuk pencarian dan klaim Anda.

### Aku punya kunci API

Aisthez Cipta atau gunakan kembali kunci dengan izin Google Search. Tempelkan ke dalam prompt login tersembunyi.

#### Simpan dan periksa akses

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

- [Xachive membuat kunci API](https://flashdata.dev/app/api-keys)

### Dia mengatur agenku

Lulus dari projek Anda dan pilih Codex, Claude Code atau kursor. Instal kemampuan 16 dan menggunakan kembali akses atau meminta satu pengadilan yang dapat memenuhi syarat. Ini berjalan tidak ada pertanyaan terbayar. Sebuah agen otomatisasi automatografi dapat menggunakan kodeks --agent --non-interactive (menggantikan kodeks dengan host yang didukung secara aktual).

#### Pengaturan Panduan dari Kebohongan

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

- [OpenClaw dan tuan rumah keterampilan lainnya](https://flashdata.dev/ms/docs/guides/agent-skill/reference.md#other-hosts)

### Coba dari terminal

Mulailah satu percobaan yang memenuhi syarat tanpa memasang keterampilan agen. Google Search dan YouTube Metadata diminta secara default. Kau bisa menggunakan kembali akses yang sah jika kau sudah memilikinya.

#### Mulailah sidang

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


- [Kesaksian dan klaim](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md)

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

## 3. Kau harus mencari

Perintah command ini mengirimkan satu Google pencarian hingga lima hasil dan mencetak respon.

### Cari

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


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

### Apa yang harus kau lihat

Cari ok: true dan data.status: done. Cabe untuk gelar Baca dan URLsQ dalam data.results[].organic dan muatan dalam data.usage.credits. Contoh (singkatan):

#### Terminal keluaran

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

## Lebih banyak tugas CLI

Pilihlah tugas di bawah ini. Queries menggunakan akses dan kredit sumber kunci yang terhubung. Cek narasumber yang diizinkan kunci sebelum beralih tugas; unduhan memerlukan akses pemilik.

### Google Search

© Cari halaman dengan jumlah hasil yang dipilih, bahasa dan konteks negara.

#### Google Search

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


### YouTube Data

Pencari untuk video kandidat, kemudian gunakan satu video yang dikembalikan ID dengan data meta atau transkrip. Setiap perintah adalah pertanyaan terpisah; ganti sampel ID dengan video yang Anda pilih.

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

Use an owner key dengan izin youtube_download. Penyedia Siapkan storage.json pribadi dengan pengaturan penyimpanan tujuan Anda menggunakan link setup penyimpanan di tab ini. Megantikan video ID dengan satu Anda berwenang untuk memproses. Perintah command ini menunggu pekerjaan latar belakang dan menyimpan catatan pengiriman, bukan berkas media.

#### Download audio

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

- [Siapkan storage.json](https://flashdata.dev/ms/docs/guides/cli-automation/reference.md#storage)

### Akun

Periksa harga, keseimbangan dan sumber yang diizinkan tanpa mengajukan pertanyaan.

#### Akun thake

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


- [Perintah penuh dan referensi bendera](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md)

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

### ** Pratilik biaya sebelum pertanyaan

Perintah-perintah ini membaca keseimbangan dan perkiraan Anda tanpa menjalankan pencarian. Nitagon Periksa data.estimateAvailable dan bandingkan perkiraan dengan kredit yang tersedia.

#### Pratonton

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


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

### Guna dalam skrip dan agen

Untuk pencarian lain yang ditujukan, pilih ID yang baru dan nama berkas output. Berkas yang ada tidak ditulis-ganti. Setelah menjalankan interupsi, memeriksa catatan yang ada sebelum mengajukan lagi.

| Pilihan font | Tujuan |
| --- | --- |
| --json | Penerimaan eksekusi dapat dibaca mesin-memoir; dengan --output, data menggambarkan berkas yang disimpan. |
| --non-interactive | Melumpuhkan prompt dan browser opening. |
| --output FILE | Simpan sumber respon ke file baru. |
| --run-id ID | Kenalpasti satu yang dimaksudkan dijalankan dan menggunakan kembali hasil yang disimpan. |
| --help | Tampilkan sintaks dan bendera untuk perintah apapun. |

#### Tanya untuk Markdown

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

- [Profil, JSON dan dijalankan berulang](https://flashdata.dev/ms/docs/guides/cli-automation/reference.md)

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

## Penerjemahan Masalah

| Problem | Cuba ini |
| --- | --- |
| Perintah Ufine tidak ditemukan | Periksa OS/CPU download dan PATH di dalam terminal atau agen di mana Anda menjalankannya. |
| 401 / 403 | auth status. Periksa kelayakan, pembatalan lingkungan dan hak sumber. |
| 402 / 429 | Periksa Billing atau klaim sidang habis. Untuk batas tingkat, ikuti Retry-After. |
| Keluaran tidak ada / habisnya | Periksa berkas asli yang dijalankan dan disimpan. Dia menggunakan panduan pemulihan sebelum menyerahkan pekerjaan baru yang dibayar. |

- [Pemeriksaan dan pemulihan yang detail](https://flashdata.dev/ms/docs/guides/cli-automation/reference.md#recover)
- [Billing](https://flashdata.dev/app/billing)

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

## Teruskan

- [Klaim klaim pengadilan Anda dan tetap akses](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md#claim)
- [Tugas berulang](https://flashdata.dev/ms/docs/guides/recurring-tasks/reference.md)
- [\"Instal keterampilan agen\"](https://flashdata.dev/ms/docs/guides/agent-skill/reference.md)
- [Profil Profil dan penyimpanan kredensial](https://flashdata.dev/ms/docs/guides/cli-automation/reference.md#profiles)
