ドキュメントを探す
はじめに
Googleを検索し、YouTubeデータを取り出し、端末やAIエージェントからメディアを配信します。 1つの実行可能;Node.jsかPythonは要求しません。
このページの内容
1. インストール
プラットフォームを選択します。 これらのネイティブビルドでは、Node.js や Python は必要ありません。 書き込み可能なフォルダ内のコマンドを実行します。スタンドアローンのダウンロードはチェックサム検証されます。
取付けられているHomebrewを使って:
brew install flashdatadev/tap/flashdata
flashdata --versionBash · uname -m を最初に動かして下さい。 x86_64 のビルドを使用する。 ARM64とパッケージマネージャのオプションは以下の通りです。
# 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# 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
}その他のインストールオプション
スタンドアローンコマンドは、この端末でPATHを設定しました。 抽出したディレクトリをユーザの PATH に後でセッションに追加するか、実行可能の絶対パスを使用します。
# 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# 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# 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 --version2. アクセス設定
1つのパスを選択します。 これらのコマンドは、デフォルトプロファイルを使用します。検索とクレームの同じプロファイルを使用してください。
Google Search 権限でキーを作成または再利用します。 隠しログインプロンプトに貼り付けます。
flashdata auth login
flashdata auth statusプロジェクトから実行し、Codex、Claudeコードまたはカーソルを選択します。 セットアップは、16のスキルをインストールし、アクセスまたは1つの資格試験を要求します。 有料のクエリを実行しません。 自動化されたエージェントは、--agentのコーデックス--non-interactive(実際のサポートされているホストとコーデックスを置き換える)を使用できます。
flashdata setup
flashdata auth statusエージェントのスキルを使わずに1つの資格試験を始めましょう。 Google SearchとYouTube Metadataはデフォルトで要求されます。 既にインストールされている場合は、有効な保存されたアクセスを再利用します。
flashdata init --name "My CLI"
flashdata auth status3. 最初の検索を実行する
このコマンドは、Google検索を5件まで送信し、応答をプリントアウトします。
flashdata search "battery recycling research" --num 5あなたが見るべきこと
ok: trueとdata.status: doneを探します。 タイトルを読む URLs でん data.results[].organic および料金 data.usage.credits. 例(省略):
{
"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
}
}
}CLIタスクの詳細
下のタスクを選択します。 クエリは、接続されたキーのソース権限とクレジットを使用します。 タスクを切り替える前に、キーの許可されたソースを確認してください。 ダウンロードには、所有者のアクセスが必要です。
選択した結果のカウント、言語、国文でページを検索します。
flashdata search "battery recycling research" --num 5 --hl en --gl us --json候補のビデオを検索し、メタデータまたはトランスクリプトで返されたビデオIDを1つ使用してください。 各コマンドは別々のクエリです。選択したビデオでサンプル ID を置き換えます。
flashdata youtube search "battery recycling" --max-results 5 --jsonflashdata youtube metadata FUfGcZ092b0 --jsonflashdata youtube transcript FUfGcZ092b0 --language en --jsonyoutube_download 権限で所有者キーを使用します。 プライベートの準備 storage.json このタブのストレージ設定リンクを使用して、目的地のストレージ設定で。 処理する許可される1つとビデオIDを取り替えて下さい。 このコマンドは、背景ジョブを待ち、メディアファイルではなく、配信レコードを保存します。
flashdata youtube download FUfGcZ092b0 --format mp3 --storage-config storage.json --wait --output delivery.json --json質問を提出せずに価格設定、残高、許可されたソースをチェックしてください。
flashdata account balance
flashdata account pricing --source google_search --request-count 1
flashdata sources listクエリの前にコストをプレビューする
これらのコマンドは、検索を実行せずに残高と見積もりを読みます。 data.estimateAvailableをチェックし、利用可能なクレジットで見積もりを比較します。
flashdata account balance
flashdata search "battery recycling research" --num 5 --dry-run --jsonスクリプトやエージェントでの使用
別の目的の検索では、新しい実行IDと出力ファイル名を選択します。 既存のファイルは上書きされません。 中断された実行の後で、再度提出する前に、既存のレコードを点検して下さい。
| オプション | 目的: |
|---|---|
| --json | マシン読み取り可能な実行レシート。 --output では、保存されたファイルについて説明します。 |
| --non-interactive | 障害のあるプロンプトとブラウザの開口部。 |
| --output FILE | ソースの応答を新しいファイルに保存します。 |
| --run-id ID | 意図した実行を識別し、保存した結果を再使用します。 |
| --help | 任意のコマンドの構文とフラグを表示します。 |
flashdata search "battery recycling research" --accept text/plain --respond-with markdown --json=falseトラブルシューティング
| 問題の問題 | ぜひお試しください。 |
|---|---|
| コマンドが見つかりません | OS/CPUのダウンロードとPATHを端末や端末のエージェントにチェックします。 |
| 401 / 403 | auth statusを実行します。 認証情報、環境のオーバーライド、およびソースの権限を確認してください。 |
| 402 / 429 | Billing をチェックするか、テストを中止するかどうかを確認します。 レート制限については、Retry-Afterに従ってください。 |
| 出力が存在します/タイムアウト | 元の実行と保存されたファイルを調べます。 新しい有料作品の提出前に、回復ガイドを使用してください。 |