# FlashData CLI

Google 검색, YouTube 데이터를 검색하고 터미널 또는 AI 에이전트에서 미디어를 제공합니다. 1개의 실행 가능한; 요구되는 Node.js 또는 Python 없음.

Canonical 참고: https://flashdata.dev/ko/docs/guides/flashdata-cli
검토: 2026-11-04 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. 설치하기

당신의 플랫폼을 선택하십시오. 이 네이티브 빌드는 Node.js 또는 Python가 필요하지 않습니다. writable 폴더에서 명령을 실행; 독립 다운로드는 checksum-verified.

### macOS

설치되는 Homebrew로:

#### Homebrew

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

- [Homebrew없이 설치](https://flashdata.dev/ko/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/ko/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 코드 또는 커서를 선택하십시오. Setup은 16 기술을 설치하고 액세스 또는 요청을 재사용 할 수 있습니다. 결제된 쿼리가 없습니다. 자동화된 대리인은 --agent codex --non-interactive를 사용할 수 있습니다 (실제적인 지원된 주인을 가진 대체 코드).

#### Guided 설정

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

- [OpenClaw 및 기타 기술 호스트](https://flashdata.dev/ko/docs/guides/agent-skill/reference.md#other-hosts)

### 터미널에서 시도

에이전트 기술을 설치하지 않고 한 번의 자격이 된 평가판을 시작합니다. Google Search 및 YouTube Metadata는 기본적으로 요청됩니다. 이미 그것을 가지고있는 경우 대신 유효한 저장된 접근을 재사용하십시오.

#### 시험 시작

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


- [시험 관할 및 청구](https://flashdata.dev/ko/docs/guides/agent-onboarding/reference.md)

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

## 3. 첫 번째 검색을 실행

이 명령은 최대 5개의 결과에 대한 Google 검색을 보내고 응답을 인쇄합니다.

### 검색

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


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

### 당신이 볼 수 있습니다

ok: true 및 data.status: done를 찾습니다. data.results[].organic의 제목과 URLs를 읽고 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 작업

아래 작업을 선택하십시오. Queries는 연결된 키의 소스 권한 및 크레딧을 사용합니다. 작업 전환하기 전에 키의 허용 된 소스를 확인합니다. 다운로드는 소유자 액세스가 필요합니다.

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

- [storage.json 준비](https://flashdata.dev/ko/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 및 출력 파일 이름을 선택하십시오. existing 파일은 overwritten하지 않습니다. 중단된 실행 후에, 다시 제출하기 전에 기존 기록을 검사합니다.

| 의 특징 | 제품정보 |
| --- | --- |
| --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/ko/docs/guides/cli-automation/reference.md)

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

## 관련 상품

| 의 의 | 이 글을 |
| --- | --- |
| 명령을 찾을 수 없습니다 | OS/CPU 다운로드 및 PATH를 터미널 또는 에이전트 내부에서 확인하십시오. |
| 401 / 403 | auth status를 실행하십시오. 자격 증명, 환경 적분 및 소스 권한 확인. |
| 402 / 429 | Billing를 확인하거나 소진 된 체험을 주장합니다. 비율 한계를 위해, Retry-After를 따르십시오. |
| 산출은/timeout 존재합니다 | 원본 실행 및 저장된 파일을 검사합니다. 새로운 유료 작업을 제출하기 전에 복구 가이드를 사용하십시오. |

- [상세한 검사 및 복구](https://flashdata.dev/ko/docs/guides/cli-automation/reference.md#recover)
- [Billing](https://flashdata.dev/app/billing)

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

## 더 보기

- [당신의 평가를 받고 접근을 유지하십시오](https://flashdata.dev/ko/docs/guides/agent-onboarding/reference.md#claim)
- [정기 작업](https://flashdata.dev/ko/docs/guides/recurring-tasks/reference.md)
- [에이전트 기술 설치](https://flashdata.dev/ko/docs/guides/agent-skill/reference.md)
- [프로필 및 자격 저장](https://flashdata.dev/ko/docs/guides/cli-automation/reference.md#profiles)
