浏览文档
开始使用
为智能体添加 Google 搜索和 YouTube 工具。连接宿主后,即可请求首个结果。
本页内容
1. 连接并登录
Codex 或 OpenClaw 可选择对应选项,通过浏览器完成 OAuth。其他宿主若支持 Streamable HTTP 与自定义请求头,选择“远程 / API Key”;若可启动 MCP 进程,选择“本地 / stdio”。托管服务无需本地安装。
将下方配置合并到 ~/.codex/config.toml,再运行登录命令。在浏览器完成 FlashData 注册或登录及授权,然后开启新的 Codex 会话。
[mcp_servers.flashdata]
url = "https://data.flashdata.dev/mcp"
[mcp_servers.flashdata.oauth]
client_id = "flashdata-codex"
callback_url = "http://127.0.0.1/callback"codex mcp login flashdata --scopes mcp:research在智能体使用的 OpenClaw 配置中运行以下命令。在浏览器完成注册或登录及授权,再开启新会话。doctor 检查已保存连接。
openclaw mcp set flashdata '{"url":"https://data.flashdata.dev/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"mcp:research","clientMetadataUrl":"https://api.flashdata.dev/oauth/clients/openclaw.json"}}'
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probe创建或复用具有 Google 搜索权限的密钥。在宿主 MCP 设置中按下方字段添加服务,将密钥填入受保护的请求头字段并重连,无需 OAuth 命令。
Name: flashdata
Transport: Streamable HTTP
URL: https://data.flashdata.dev/mcp
Header: X-API-Key: YOUR_API_KEY需要 Node.js 22.18+ 及具有 Google 搜索权限的 API Key。将此配置合并到支持 mcpServers JSON 的宿主,在本地受保护配置中替换 YOUR_API_KEY,再重启宿主。Windows 宿主若要求可执行文件名,使用 npx.cmd。
此固定版本 npm 包运行本地 MCP 服务。独立 FlashData CLI 是另一可执行程序。
{
"mcpServers": {
"flashdata": {
"command": "npx",
"args": [
"--yes",
"--package=@flashdata-dev/[email protected]",
"flashdata-mcp"
],
"env": {
"FLASHDATA_API_KEY": "YOUR_API_KEY"
}
}
}
}2. 检查连接
在新的智能体会话发送此检查。预期 get_pricing 与 get_balance 均成功,返回 google_search 的可用价格及可用 Credits 余额。余额为零表示搜索需要充值,不表示认证失败。
使用已有的 flashdata MCP 连接。
以 {"source":"google_search","request_count":1} 调用 get_pricing。
以 {} 调用 get_balance。
分别报告两次调用是否成功、该来源是否有可用价格,以及可用 Credits 余额。
余额为零不表示认证失败。
不要执行搜索或下载、创建试用或更改凭据。3. 请求首个任务
将以下提示粘贴给已连接的智能体。余额与价格检查免费,搜索消耗账户 Credits。
使用 FlashData 检查我的余额及一次 Google 搜索价格。若 Credits 足够,调用一次 google_search,query 为 "battery recycling research",num 为 5,mode 为 "realtime"。返回标题、来源 URL、简短摘要及实际 Credits 用量。完成后停止。检查结果
智能体应返回来源链接、摘要及实际 Credits 用量。底层搜索结果包含 status: done 和 results[].organic。空结果有效,智能体应如实说明。下方为示例。
已完成一次 Google 搜索。
1. 电池回收研究 — https://example.org/recycling
一段搜索摘要示例。
消耗 Credits:0.02可用工具
API Key 调用使用该密钥获授的权限。通过服务端工具发现和输入结构获取当前完整目录。
| 任务 | 工具 | 访问方式 |
|---|---|---|
| 搜索 Google | google_search | mcp:research / API key |
| 查找 YouTube 视频 | youtube_search | mcp:research / API key |
| 读取视频元数据 | youtube_metadata | mcp:research / API key |
| 获取现有字幕 | youtube_transcript | mcp:research / API key |
| 下载视频或音频 | youtube_download | 所有者 API Key + 目标存储 |
| 检查账户与价格 | get_balance, get_pricing, get_limits, get_usage | 免费账户读取 |
关于 OAuth、权限与试用
故障排查
| 问题 | 处理方式 |
|---|---|
| 没有 FlashData 工具 | 完成授权、重连并开启新会话。检查 URL 与 Streamable HTTP 传输。 |
| invalid_client / callback error | Codex 或 OpenClaw 请使用对应的确切客户端配置,以及可访问本地回调的浏览器。其他宿主可使用上方其支持的 API Key 或 stdio 配置。 |
| 401 | 重新连接已过期或撤销的 OAuth 访问,或检查提供给宿主的 API Key。重复免费检查。 |
| 403 | 检查请求来源及密钥权限。YouTube 下载需要具有 youtube_download 权限的所有者 API Key 与目标存储;mcp:research 不包含此来源。 |
| 402 | 检查 Billing 及当前价格。重新连接有效凭据不会增加 Credits。 |
| 429 | 遵守 Retry-After。保留已有任务或结果 ID,再决定是否重试任务。 |
| 超时或响应不完整 | 保留请求 ID 并检查历史。大型结果用 get_result 续读,不要重复搜索。 |