# FlashData CLIの特長

Googleを検索し、YouTubeデータを取り出し、端末やAIエージェントからメディアを配信します。 1つの実行可能;Node.jsかPythonは要求しません。

キャニシニカル参照: https://flashdata.dev/ja/docs/guides/flashdata-cli
レビュー: FlashData による 2026-11-04

- [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. インストール

プラットフォームを選択します。 これらのネイティブビルドでは、Node.js や Python は必要ありません。 書き込み可能なフォルダ内のコマンドを実行します。スタンドアローンのダウンロードはチェックサム検証されます。

### macOS

取付けられているHomebrewを使って:

#### Homebrew

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

- [Homebrewなしで取付けて下さい](https://flashdata.dev/ja/docs/guides/flashdata-cli/reference.md#manual-install)

### Linux x64

Bash · uname -m を最初に動かして下さい。 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/ja/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 設定](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. アクセス設定

1つのパスを選択します。 これらのコマンドは、デフォルトプロファイルを使用します。検索とクレームの同じプロファイルを使用してください。

### 私はAPIキーを持っています

Google Search 権限でキーを作成または再利用します。 隠しログインプロンプトに貼り付けます。

#### アクセスを保存し、確認

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

- [APIキーを作成する](https://flashdata.dev/app/api-keys)

### エージェントのセットアップ

プロジェクトから実行し、Codex、Claudeコードまたはカーソルを選択します。 セットアップは、16のスキルをインストールし、アクセスまたは1つの資格試験を要求します。 有料のクエリを実行しません。 自動化されたエージェントは、--agentのコーデックス--non-interactive(実際のサポートされているホストとコーデックスを置き換える)を使用できます。

#### ガイドセットアップ

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

- [OpenClaw と他のスキルホスト](https://flashdata.dev/ja/docs/guides/agent-skill/reference.md#other-hosts)

### ターミナルから試す

エージェントのスキルを使わずに1つの資格試験を始めましょう。 Google SearchとYouTube Metadataはデフォルトで要求されます。 既にインストールされている場合は、有効な保存されたアクセスを再利用します。

#### トライアルを開始する

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


- [試用手当と主張](https://flashdata.dev/ja/docs/guides/agent-onboarding/reference.md)

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

## 3. 最初の検索を実行する

このコマンドは、Google検索を5件まで送信し、応答をプリントアウトします。

### 検索

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


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

### あなたが見るべきこと

ok: trueとdata.status: doneを探します。 タイトルを読む URLs でん 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を1つ使用してください。 各コマンドは別々のクエリです。選択したビデオでサンプル 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 このタブのストレージ設定リンクを使用して、目的地のストレージ設定で。 処理する許可される1つとビデオIDを取り替えて下さい。 このコマンドは、背景ジョブを待ち、メディアファイルではなく、配信レコードを保存します。

#### Download audio

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

- [storage.jsonを準備する](https://flashdata.dev/ja/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をチェックし、利用可能なクレジットで見積もりを比較します。

#### プレビュー

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

- [プロフィール、JSONおよび再帰の操業](https://flashdata.dev/ja/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/ja/docs/guides/cli-automation/reference.md#recover)
- [Billing](https://flashdata.dev/app/billing)

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

## Go 更に

- [トライアルを主張し、アクセスを続けます](https://flashdata.dev/ja/docs/guides/agent-onboarding/reference.md#claim)
- [定期実行タスク](https://flashdata.dev/ja/docs/guides/recurring-tasks/reference.md)
- [エージェントのスキルをインストール](https://flashdata.dev/ja/docs/guides/agent-skill/reference.md)
- [プロファイルと認証ストレージ](https://flashdata.dev/ja/docs/guides/cli-automation/reference.md#profiles)
