# FlashData CLI

البحث Googleاسترجع YouTube البيانات و توصيل وسائل الإعلام من محطتك أو عميلة مكافحة المخدرات One executable; no Node.js or Python required.

مرجع كانوني: https://flashdata.dev/ar/docs/guides/flashdata-cli
Reviewed: 2026-11-04 by FlashData

- [حمولة CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1) — v1.2.1 · Linux / macOS / Windows
- [إشارة القيادة](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md) — جميع الأوامر والأعلام ورموز الخروج

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

## 1. Install

اختر منصتك هذه البنايات الأصلية لا تحتاج إلى Node.js أو Python. أديروا الأوامر في ملف مُحكم، وأجهزة التحميل الاحتياطية تم التحقق منها.

### macOS

مع تركيب Homebrew:

#### Homebrew

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

- [Install without Homebrew](https://flashdata.dev/ar/docs/guides/flashdata-cli/reference.md#manual-install)

### Linux x64

Bash · Run uname -m first. (أ) استخدام هذه البناية لـ (زكس كيزوك (x86_64؛ وترد أدناه خيارات ARM64 وخيارات التعبئة.

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


- [منابر أخرى ومديرو مجموعات](https://flashdata.dev/ar/docs/guides/flashdata-cli/reference.md#manual-install)

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

### خيارات التركيب الأخرى

مجموعة أوامر الجاهزة PATH لهذه المحطة أضف الدليل المستخرج إلى مستعملك PATH لجلسات لاحقة، أو استخدام المسار المطلق للتنفيذ.

#### 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 setup](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/installation.md)
- [عمليات تنزيل الإصدار](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)

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

## 2. افسحوا المجال

اختر طريقا واحدا. هذه الأوامر تستخدم الملف الافتراضي، وتستمر في استخدام نفس الملف من أجل بحثك وتدعي.

### لدي API المفتاح

إنشاء أو إعادة استخدام مفتاح بإذن من Google Search. استلقيه في الشعار الخفي

#### إنقاذ وفحص الدخول

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

- [Create an API key](https://flashdata.dev/app/api-keys)

### جهز عميلي

اهرب من مشروعك واختار Codex, Claude كود أو كورس (ب) إنشاء تركيبات لمهارات 16 وإعادة استخدام إمكانية الوصول أو طلب تجربة واحدة مؤهلة. لا يُجري أيّ استفسار مُدفوع. عميل آلي يمكن أن يستخدم --agent الرمز --non-interactive (يوضع الرمز مع المضيف الحقيقي المدعوم).

#### مجموعة المبادئ التوجيهية

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

- [OpenClaw and other skills hosts](https://flashdata.dev/ar/docs/guides/agent-skill/reference.md#other-hosts)

### حاول من المحطة

ابدأ تجربة واحدة مؤهلة بدون تركيب مهارات العملاء ويُطلب من شركة Google Search و YouTube Metadata حسب التخلف. إعادة الاستخدام الصحيح تم توفير الوصول بدلا من ذلك إذا كان لديك بالفعل.

#### ابدأ التجربة

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


- [بدل التجربة والمطالبة](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md)

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

## 3. أجري بحثك الأول

وترسل هذه القيادة بحثاً واحداً من طراز Google عن ما يصل إلى خمسة نتائج وتطبع الرد.

### بحث

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


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

### ما يجب أن تراه

ابحث عن ok: true وdata.status: done. اقرأ العناوين والروابط في data.results[].organic والرسم في data.usage.credits. مثال مختصر:

#### الناتج النهائي

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

## المزيد من مهام CLI

اختر المهمة أدناه. يستخدم الكواليس الأذن و الإئتمانات من مصادر المفتاح وتحقق من المصادر الرئيسية المسموح بها قبل تحويل المهام؛ وتحتاج الحمولات إلى وصول المالك.

### Google Search

البحث عن صفحات تتضمن عدداً مختاراً من النتائج، واللغة، والسياق القطري.

#### Google Search

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


### YouTube Data

البحث عن فيديو للمرشحين، ثم استخدام فيديو واحد أعيد ID مع البيانات الفوقية أو النصوص. كل أمر هو استفسار منفصل؛ استبدال العينة ID مع شريط الفيديو المختار.

#### 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 إذن. جهزوا جهازاً خاصاً من طراز storage.json مع مخازن مقصدكم باستخدام وصلة التخزين في هذا الحساب استبدال الفيديو ID مع واحد أنت مخول لتجهيز. هذه القيادة تنتظر وظيفة الخلفية وتحتفظ بسجل تسليم وليس ملف الإعلام

#### Download audio

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

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

### الحساب

التحقق من التسعير والتوازن والمصادر المسموح بها دون تقديم الاستفسارات.

#### يُقرأ الحساب

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


- [الإشارة الكاملة للقيادة والعلم](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md)

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

### استعراض التكلفة قبل الاستفسار

هذه الأوامر قرأت ميزانك و تقديرك بدون أن تجري بحثاً تحقق من الرقم data.estimateAvailable ومقارنة التقدير بالأرصدة الدائنة المتاحة.

#### Preview

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


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

### استخدام النصوص والوكلاء

ولبحث مقصود آخر، اختاري وظيفة جديدة من طراز ID واسم ملف النواتج. الملفات الموجودة ليست مكتظة بعد انقطاع تشغيل، فحص السجل الحالي قبل تقديم مرة أخرى.

| الخيار | الغرض |
| --- | --- |
| --json | إيصالات إعدام قابلة للقراءة؛ مع --outputالبيانات تصف الملف المنقذ |
| --non-interactive | طلقات مُعطلة وفتح مُصففة. |
| --output FILE | وفر رد المصدر على ملف جديد |
| --run-id ID | تحديد هدف واحد هو تشغيل وإعادة استخدام النتيجة المحفوظة. |
| --help | اظهروا "سينتاكس" وأعلام لأي أمر. |

#### إسألْ عن Markdown

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

- [Profiles, JSON and recurring runs](https://flashdata.dev/ar/docs/guides/cli-automation/reference.md)

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

## اضطرابات

| المشكلة | جرب هذا |
| --- | --- |
| القيادة لم تجد | تحقق من OS/CPU التحميل PATH داخل المحطة أو الوكيل حيث تديرها. |
| 401 / 403 | تشغيل auth status. التحقق من وثائق التفويض، وتجاوزات البيئة، وتصاريح المصادر. |
| 402 / 429 | تحقق Billing أو يُطالب بتجربة مُرهقة. بالنسبة للحد من الأسعار، تتبع Retry-After. |
| الناتج موجود/الوقت المتوقع | تحقق من الركض الأصلي وأنقذ الملف. استخدام دليل الاسترداد قبل تقديم عمل جديد مدفوع الأجر. |

- [الشيكات التفصيلية والانتعاش](https://flashdata.dev/ar/docs/guides/cli-automation/reference.md#recover)
- [Billing](https://flashdata.dev/app/billing)

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

## إذهب أبعد

- [اطالب بمحاكمتك واستمر في الوصول](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md#claim)
- [المهام المتكررة](https://flashdata.dev/ar/docs/guides/recurring-tasks/reference.md)
- [اثبتي مهارة العميل](https://flashdata.dev/ar/docs/guides/agent-skill/reference.md)
- [الملامح وخزن الوثائق](https://flashdata.dev/ar/docs/guides/cli-automation/reference.md#profiles)
