# FlashData CLI

Cari data Google, ambil data YouTube dan kirim media dari terminal Anda atau agen AI Anda. Satu executable; tidak ada Node.js atau Python yang dibutuhkan.

Referensi kanonikal: https://flashdata.dev/id/docs/guides/flashdata-cli
Diulang: 2026-11-04 oleh FlashData

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

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

## 1. Pasang

Pilih platform Anda. Bangunan asli ini tidak perlu Node.js atau Python. Jalankan perintah dalam folder writeable; unduhan standonly adalah checksum- diverifikasi.

### macOS

Dengan Homebrew terpasang:

#### Homebrew

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

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

### Linux x64

Bash tidak bernama -m pertama. Gunakan bangunan ini untuk x86_64; Pilihan ARM64 dan package- manajer 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
}
```


- [Platform dan manajer paket lainnya](https://flashdata.dev/id/docs/guides/flashdata-cli/reference.md#manual-install)

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

### Opsi instalasi lain

Perintah standalone set PATH untuk terminal ini. Tambahkan direktori terekstrak ke pengguna Anda PATH untuk sesi nanti, atau gunakan path absolut 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)
- [Rilis pengunduhan](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)

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

## 2. Atur akses

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

### Aku punya kunci API

Buat atau gunakan kembali kunci dengan izin Google Search. Tempel ke prompt log masuk tersembunyi.

#### Simpan dan periksa akses

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

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

### Siapkan agenku

Jalankan dari proyek Anda dan pilih Codex, Claude Code atau Cursor. Setup memasang keterampilan 16 dan menggunakan kembali akses atau meminta seseorang untuk diadili. Ini tidak berjalan permintaan dibayar. Sebuah agen otomatis dapat menggunakan kodeks --agent --non-interactive (ganti kodex dengan host yang didukung aktual).

#### Pengaturan petunjuk

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

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

### Coba dari terminal

Mulailah satu pengadilan yang memenuhi syarat tanpa keahlian agen pemasangan. Google Search dan YouTube Metadata diminta secara baku. Gunakan lagi akses disimpan yang valid jika Anda sudah memilikinya.

#### Memulai persidangan

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


- [Ujian tunjangan dan klaim](https://flashdata.dev/id/docs/guides/agent-onboarding/reference.md)

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

## 3. Jalankan pencarian pertama Anda

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

### Cari

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


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

### Apa yang harus Anda lihat

Carilah ok: true dan data.status: done. Baca judul dan URLs dalam data.results[].organic dan muatan dalam data.usage.credits. Contoh (disingkat):

#### Keluaran terminal

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

Pilih tugas di bawah ini. Kueri menggunakan hak akses dan kredit kunci yang terhubung. Periksa sumber yang diizinkan kunci sebelum bertukar tugas; pengunduhan memerlukan akses pemilik.

### Google Search

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

#### Google Search

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


### YouTube Data

Cari video kandidat, lalu gunakan video ID dengan metadata atau transkrip. Setiap perintah adalah kueri terpisah; ganti contoh 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

Gunakan kunci pemilik dengan izin youtube_download. Siapkan storage.json pribadi dengan pengaturan penyimpanan tujuan Anda menggunakan link setup penyimpanan di tab ini. Ganti video ID dengan video yang Anda berwenang untuk memproses. Perintah 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/id/docs/guides/cli-automation/reference.md#storage)

### Akun

Periksa harga, keseimbangan dan sumber diizinkan tanpa mengirimkan pertanyaan.

#### Akun dibaca

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


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

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

### Pratilik biaya sebelum permintaan

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

#### Pratilik

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


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

### Gunakan dalam skrip dan agen

Untuk pencarian lain yang dimaksudkan, pilih run baru ID dan nama berkas keluaran. Berkas yang ada tidak ditimpa. Setelah diinterupsi, memeriksa catatan yang ada sebelum mengirimkan lagi.

| Opsi | Tujuan |
| --- | --- |
| --json | Mesin - dapat dibaca penerimaan eksekusi; dengan --output, data menggambarkan berkas disimpan. |
| --non-interactive | Matikan prompt dan buka peramban. |
| --output FILE | Simpan respon sumber ke berkas baru. |
| --run-id ID | Identifikasi satu yang dimaksudkan menjalankan dan menggunakan kembali hasil yang disimpan. |
| --help | Tampilkan sintaks dan tanda untuk perintah apapun. |

#### Mintalah Markdown

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

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

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

## Permasalahan menarik

| Masalah | Coba ini |
| --- | --- |
| Perintah tak ditemukan | Periksa download OS/CPU dan PATH di dalam terminal atau agen di mana Anda menjalankannya. |
| 401 / 403 | Jalankan auth status. Periksa kredensial, menimpa lingkungan dan izin sumber. |
| 402 / 429 | Periksa Billing atau klaim percobaan habis. Untuk batas kecepatan, ikuti Retry-After. |
| Keluaran ada / timeout | Inspeksi berkas asli yang dijalankan dan disimpan. Gunakan panduan pemulihan sebelum mengirimkan pekerjaan baru yang dibayar. |

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

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

## Pergi lebih jauh

- [Klaim percobaan Anda dan terus akses](https://flashdata.dev/id/docs/guides/agent-onboarding/reference.md#claim)
- [Tugas berkala](https://flashdata.dev/id/docs/guides/recurring-tasks/reference.md)
- [Instal keterampilan agen](https://flashdata.dev/id/docs/guides/agent-skill/reference.md)
- [Penyimpanan profil dan kredensial](https://flashdata.dev/id/docs/guides/cli-automation/reference.md#profiles)
