# FlashData CLI

Arama Google, YouTube verileri alın ve terminalinizden veya AI ajanınızdan medya gönderin. Bir executable; Node.js veya Python gerekli değil.

Canonical referans: https://flashdata.dev/tr/docs/guides/flashdata-cli
İnceleme: 2026-11-04 Tarafından FlashData

- [Download Download Download CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1) — v1.2.1 · Linux / macOS / Windows
- [Komuta referansı](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md) — Tüm komutlar, bayraklar ve çıkış kodları

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

## 1. Yükleme yükleme

Platformunuzu seçin. Bu yerli inşaların Node.js veya Python'ye ihtiyacı yoktur. Uygun bir klasördeki komutları çalıştırın; standalone indirmeleri kontrol edilir.

### macOS

Homebrew kuruldu:

#### Homebrew

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

- [Yükleme olmadan yükleme Homebrew](https://flashdata.dev/tr/docs/guides/flashdata-cli/reference.md#manual-install)

### Linux x64

Bash · Run uname -m first. x86_64 için bu yapıyı kullanın; ARM64 ve paket sorumlu seçenekler aşağıdadır.

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


- [Diğer platformlar ve paket yöneticileri](https://flashdata.dev/tr/docs/guides/flashdata-cli/reference.md#manual-install)

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

### Diğer yükleme seçenekleri

Standalone komutları bu terminal için PATH'u belirledi. Tamamlanan dizinini kullanıcınıza ekleyin PATH Daha sonra seanslar için veya executable'ın mutlak yolunu kullanın.

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


- [APT / RPM kurulum](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/installation.md)
- [Salı indirmeleri](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)

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

## 2. Yukarı erişim

Bir yol seçin. Bu komutlar varsayılan profili kullanır; aramalarınız ve iddialarınız için aynı profili kullanmaya devam edin.

### API anahtarım var

Google Search izni ile anahtar oluşturun veya yeniden kullanın. Onu gizli girişe hızlı yapıştırın.

#### Save and check access

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

- [Bir API anahtarı oluşturun](https://flashdata.dev/app/api-keys)

### Ajansımı kurdum

Projenizden hareket edin ve Codex, Claude Kod veya Cursor'u seçin. Kurulum 16 yetenekleri ve yeniden kullanım veya uygun bir deneme talep eder. ücretli bir sorgu çalışmıyor. Otomatik bir ajan --agent codex --non-interactive (gerçek desteklenen host ile kodx) kullanabilir.

#### Rehberlik

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

- [OpenClaw ve diğer yetenek ev sahipliği](https://flashdata.dev/tr/docs/guides/agent-skill/reference.md#other-hosts)

### Terminalden Deneyin

Ajan becerilerini yüklemeden uygun bir deneme başlatın. Google Search ve YouTube Metadata varsayılan olarak talep edilir. Reuse valid save access instead if you already have it.

#### Bir deneme başlatın

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


- [Deneme izni ve iddia](https://flashdata.dev/tr/docs/guides/agent-onboarding/reference.md)

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

## 3. İlk aramanızı çalıştırın

Bu komut, bir Google aramasını beş sonuça kadar gönderir ve cevabı yazdırır.

### Ara

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


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

### Ne görmeliydin

ok: true ve data.status: done'ye bakın. data.results[].organic'da başlık ve URLs ve data.usage.credits'da sorumlu. Örnek (abbreviated):

#### Terminal çıktı

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

## Daha fazla CLI görevleri

Aşağıdaki bir görevi seçin. Queries, bağlı anahtarın kaynak izinlerini ve kredilerini kullanır. Anahtarın izin verilen kaynakları geçiş görevlerine göz atın; indirmeler sahibi erişim gerektirir.

### Google Search

Seçilen bir sonuç sayımı, dil ve ülke bağlamı ile sayfaları bulun.

#### Google Search

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


### YouTube Data

Aday videolar için arama, sonra bir video ID'u metadata veya transkriptle geri döndürür. Her komut ayrı bir sorgudur; örneğin ID'yu seçtiğiniz video ile değiştirin.

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

youtube_download izni ile bir sahibi anahtar kullanın. Bu sekmedeki depolama bağlantısını kullanarak hedef depolama ayarlarınızla özel bir storage.json hazırlayın. Video ID'u birinizle değiştirin, işlem için yetkilisiniz. Bu komut arka plan işi için bekler ve teslimat kaydı kurtarır, medya dosyası değil.

#### Download audio

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

- [Hazırlanmaya hazırlanın storage.json](https://flashdata.dev/tr/docs/guides/cli-automation/reference.md#storage)

### Hesap Hesabı

Kontrol fiyatlandırması, denge ve sorgu göndermeden kaynakları izin verin.

#### Hesap okur

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


- [Tam komut ve bayrak referansı](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md)

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

### Bir sorgudan önce maliyet

Bu komutlar, bir arama yapmadan dengenizi ve tahmininizi okur. data.estimateAvailable'u kontrol edin ve mevcut kredilerle ilgili tahminleri karşılaştırın.

#### Ölçeği

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


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

### scriptlerde ve ajanlarda kullanın

Başka bir amaç için arama, yeni bir run ID ve çıkış dosyası adını seçin. Mevcut dosyalar yazılmamıştır. Bir kesintiden sonra, tekrar göndermeden önce mevcut rekoru inceleyin.

| Seçenek seçeneği | Amaç |
| --- | --- |
| --json | Makine hazırlanabilir uygulama makbuzu; --output ile veriler kurtarılan dosyayı açıklar. |
| --non-interactive | Engelliler ve tarayıcılar açıldı. |
| --output FILE | Kaynak yanıtını yeni bir dosyaya kaydedin. |
| --run-id ID | Bir amaçlanan koşmak ve kurtarılmış sonucu yeniden kullanmak. |
| --help | Herhangi bir komut için sözcü ve bayrakları göster. |

#### Sormak için Markdown

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

- [Profiller, JSON ve tekrarlananlar](https://flashdata.dev/tr/docs/guides/cli-automation/reference.md)

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

## Sorun Giderme

| Problem Sorun Problem Problem Problem | Bunu dene |
| --- | --- |
| Komut bulunamadı | OS/CPU indir ve PATH'u terminalin içinde veya onu çalıştırdığınız acentenin içinde kontrol edin. |
| 401 / 403 | auth status'u çalıştırın. Güvenilirlik, çevre overrides ve kaynak izinleri kontrol edin. |
| 402 / 429 | Billing'u kontrol edin veya tükenmiş bir deneme iddia edin. Oran sınırları için, Retry-After'yu takip edin. |
| Çıktı var / zamanout | Orijinal koşmayı ve dosyayı ihmal edin. Yeni ücretli iş sunmadan önce kurtarma kılavuzunu kullanın. |

- [Detaylı kontroller ve kurtarma](https://flashdata.dev/tr/docs/guides/cli-automation/reference.md#recover)
- [Billing](https://flashdata.dev/app/billing)

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

## Daha da ileri git

- [Denemenizi talep edin ve erişime devam edin](https://flashdata.dev/tr/docs/guides/agent-onboarding/reference.md#claim)
- [Yinelenen görevler](https://flashdata.dev/tr/docs/guides/recurring-tasks/reference.md)
- [Ajan yeteneği yükleme](https://flashdata.dev/tr/docs/guides/agent-skill/reference.md)
- [Profiller ve credential depolama](https://flashdata.dev/tr/docs/guides/cli-automation/reference.md#profiles)
