跳转到正文
中文
获取 API 密钥
浏览文档

开始使用

FlashData CLI 入门

从终端或 AI 智能体搜索 Google、获取 YouTube 数据及交付媒体。一个可执行文件,无需 Node.js 或 Python。

本页内容

1. 安装

选择平台。原生程序不需要 Node.js 或 Python。在可写目录运行命令;独立下载会校验哈希。

已安装 Homebrew 时:

Homebrew
brew install flashdatadev/tap/flashdata
flashdata --version

其他安装方式

独立安装命令仅设置当前终端 PATH。后续会话请将解压目录加入用户 PATH,或使用可执行文件绝对路径。

Linux 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_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

2. 配置访问

选择一种方式。以下命令使用默认配置;搜索与认领时继续使用同一配置。

创建或复用具有 Google 搜索权限的密钥,在 login 隐藏输入提示中粘贴。

保存并检查访问
flashdata auth login
flashdata auth status

3. 执行首次搜索

此命令发送一次 Google 搜索,最多请求五条结果,并输出响应。

搜索
flashdata search "battery recycling research" --num 5

预期结果

检查 ok: true 及 data.status: done。通过 data.results[].organic 读取标题与 URL,通过 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 任务

选择下方任务。查询使用所连接密钥的来源权限及 Credits。切换任务前检查密钥允许的来源;下载需要所有者访问。

按结果数量、语言及国家场景查找网页。

Google Search
flashdata search "battery recycling research" --num 5 --hl en --gl us --json

查询前预览成本

以下命令读取余额与估价,不执行搜索。检查 data.estimateAvailable,并比较估价与可用 Credits。

预览
flashdata account balance
flashdata search "battery recycling research" --num 5 --dry-run --json

用于脚本与智能体

执行另一次预期搜索时,选择新的运行 ID 及输出文件名。已有文件不会被覆盖。运行中断后,先检查已有记录,再决定是否重发。

选项用途
--json机器可读执行回执;使用 --output 时,data 描述保存文件。
--non-interactive禁用提示及浏览器打开。
--output FILE将来源响应保存到新文件。
--run-id ID标识一次预期运行并复用其已保存结果。
--help显示任意命令的语法与参数。
请求 Markdown
flashdata search "battery recycling research" --accept text/plain --respond-with markdown --json=false

故障排查

问题处理方式
找不到命令检查下载的系统/CPU 版本,以及实际运行终端或智能体中的 PATH。
401 / 403运行 auth status,检查凭据、环境覆盖及来源权限。
402 / 429检查 Billing 或认领额度耗尽的试用。速率限制请遵守 Retry-After。
输出已存在 / 超时检查原运行及保存文件。提交新的付费任务前,请按恢复指南处理。

继续探索