# FlashData CLI

Tìm kiếm GoogleThu thập YouTube dữ liệu và giao truyền thông từ thiết bị cuối hay tác nhân AI. Một thực hiện được; không Node.js hay Python yêu cầu.

Tài liệu tham khảo chính điển: https://flashdata.dev/vi/docs/guides/flashdata-cli
Xem lại: 2026-11-04 by FlashData

- [Tải về CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1) — v1.2.1 · Linux / macOS / Windows
- [tham chiếu lệnh](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md) — Tất cả lệnh, cờ và mã thoát

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

## 1. Cài đặt

Chọn nền tảng đi. Những người bản xứ xây dựng không cần Node.js hay Python. Chạy các lệnh trong thư mục có thể ghi; việc tải xuống biểu tượng được kiểm tra tổng hợp.

### macOS

Với Homebrew đã cài đặt:

#### Homebrew

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

- [Cài đặt mà không cần Homebrew](https://flashdata.dev/vi/docs/guides/flashdata-cli/reference.md#manual-install)

### Linux x64

Bash* Run uname -m đầu tiên. Dùng công trình này cho x86_64; ARM64 và các tùy chọn quản lý gói còn dưới đây.

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


- [Các nền tảng khác và các bộ quản lý gói](https://flashdata.dev/vi/docs/guides/flashdata-cli/reference.md#manual-install)

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

### Tùy chọn cài đặt khác

Bộ lệnh đứng vững PATH cho nhà ga này. Thêm thư mục chiết xuất vào người dùng của bạn PATH cho các phiên chạy sau, hoặc sử dụng đường dẫn tuyệt đối của tập tin thực hiện được.

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


- [Thiết lập AT/ RPM](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/installation.md)
- [Tải về](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)

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

## 2. Thiết lập truy cập

Chọn một con đường. Những lệnh này sử dụng hồ sơ mặc định; tiếp tục sử dụng cùng hồ sơ để tìm kiếm và khẳng định.

### Tôi có một phím API

Tạo hay dùng lại một phím có Google Search Cho phép. Dán nó vào dấu nhắc đăng nhập bị ẩn.

#### Lưu và kiểm tra truy cập

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

- [Tạo ra một API Khóa](https://flashdata.dev/app/api-keys)

### Hãy lập người đại diện cho tôi

Chạy khỏi dự án của bạn và chọn Codex, Claude Mã hoặc con trỏ. Cài đặt 16 kĩ năng và sử dụng lại truy cập hoặc yêu cầu một thử nghiệm thích hợp. Nó chạy không truy vấn trả tiền. Một tác nhân tự động có thể dùng --agent Sổ tay --non-interactive (đang thay thế sổ tay với máy được hỗ trợ).

#### Thiết lập hướng dẫn

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

- [OpenClaw và các máy chủ kỹ năng khác](https://flashdata.dev/vi/docs/guides/agent-skill/reference.md#other-hosts)

### Thử từ thiết bị cuối

Bắt đầu một thử nghiệm thích hợp mà không cần phải cài đặt kỹ năng tác nhân. Google Search và YouTube Metadata bị yêu cầu theo mặc định. Dùng lại quyền truy cập đã lưu hợp lệ thay vào đó nếu bạn đã có nó.

#### Bắt đầu một thử nghiệm

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


- [Thẩm vấn và tuyên bố](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md)

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

## 3. Chạy tìm kiếm đầu tiên

Lệnh này gửi một Google Tìm kiếm đến năm kết quả và in ra phản hồi.

### Tìm kiếm

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


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

### Những gì bạn nên nhìn thấy

Tìm kiếm ok: true và data.status: done. Đọc tựa đề và URLs in data.results[].organic và chịu trách nhiệm data.usage.credits. Ví dụ (abbreviated):

#### Đầu cuối

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

## Thêm nhiệm vụ CLI

Chọn một tác vụ bên dưới. Hàng đợi sử dụng quyền truy cập và tín dụng của khóa đã kết nối. Hãy kiểm tra các nguồn cho phép để chuyển công việc; việc tải về cần thiết quyền sở hữu.

### Google Search

Tìm trang có số lượng kết quả đã chọn, ngôn ngữ và ngữ cảnh quốc gia.

#### Google Search

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


### YouTube Data

Tìm kiếm các video ứng cử viên, sau đó sử dụng một video đã trở về ID với siêu dữ liệu hoặc bản ghi chép. Mỗi lệnh là một truy vấn riêng biệt; thay thế mẫu ID với đoạn phim được chọn của anh.

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

Dùng phím & riêng youtube_download Cho phép. Chuẩn bị phòng kín storage.json với thiết lập lưu trữ đích bằng liên kết thiết lập lưu trữ trong thẻ này. Thay thế đoạn phim ID với một người mà anh có quyền xử lý. Lệnh này chờ công việc nền và lưu hồ sơ giao hàng, không phải tập tin truyền thông.

#### Download audio

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

- [Chuẩn bị storage.json](https://flashdata.dev/vi/docs/guides/cli-automation/reference.md#storage)

### Tài khoản

Kiểm tra giá trị, sự số dư và các nguồn cho phép mà không cần nộp đơn xin việc.

#### Tài khoản đọc

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


- [Tham chiếu đầy đủ lệnh và cờ](https://github.com/flashdatadev/flashdata-cli/blob/v1.2.1/docs/commands.md)

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

### Xem trước chi phí trước khi truy vấn

Những lệnh này đọc và ước tính số dư của bạn mà không cần chạy tìm kiếm. Kiểm tra data.estimateAvailable và so sánh các ước tính với các tín dụng sẵn có.

#### Xem thử

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


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

### Dùng trong văn lệnh và tác vụ

Để tìm kiếm định khác, hãy chọn một chạy mới ID và tên tập tin xuất. Các tập tin tồn tại không bị ghi đè. Sau khi chạy bị gián đoạn, hãy kiểm tra hồ sơ hiện có trước khi nộp lại.

| Tùy chọn | Mục đích |
| --- | --- |
| --json | Hóa đơn hành quyết bằng máy đọc được; với --output, dữ liệu mô tả tập tin đã lưu. |
| --non-interactive | Tắt mở các nhắc và trình duyệt. |
| --output FILE | Lưu câu trả lời nguồn cho một tập tin mới. |
| --run-id ID | Xác định một người được dự định chạy và sử dụng lại kết quả đã lưu. |
| --help | Hiện các cú pháp và cờ cho bất kỳ lệnh nào. |

#### Hỏi Markdown

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

- [Hồ sơ, JSON và lặp lại chạy](https://flashdata.dev/vi/docs/guides/cli-automation/reference.md)

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

## Khắc phục sự cố

| Vấn đề | Thử cái này đi |
| --- | --- |
| Không tìm thấy lệnh | Kiểm tra OS/CPU tải về và PATH bên trong nhà ga hoặc tác nhân nơi anh điều hành nó. |
| 401 / 403 | Chạy auth status. Kiểm tra thông tin, quyền hạn môi trường và quyền truy cập nguồn. |
| 402 / 429 | Kiểm tra Billing hoặc đòi một phiên tòa hết sức mệt. Theo các giới hạn của tỷ lệ Retry-After. |
| Kết xuất tồn tại / thời hạn | Kiểm tra tập tin gốc đã chạy và lưu. Hãy dùng sách hướng dẫn về phục hồi trước khi làm việc mới. |

- [Kiểm tra chi tiết và phục hồi](https://flashdata.dev/vi/docs/guides/cli-automation/reference.md#recover)
- [Billing](https://flashdata.dev/app/billing)

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

## Đi tiếp đi

- [Xác nhận phiên tòa của bạn và giữ truy cập](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md#claim)
- [Tác vụ định kỳ](https://flashdata.dev/vi/docs/guides/recurring-tasks/reference.md)
- [Cài đặt kỹ năng tác nhân](https://flashdata.dev/vi/docs/guides/agent-skill/reference.md)
- [Name](https://flashdata.dev/vi/docs/guides/cli-automation/reference.md#profiles)
