YouTube Search — FlashData

YouTube 搜索 — FlashData

按关键词搜索 YouTube 视频，并使用日期、时长、功能和排序筛选条件。返回视频 ID、频道和可用统计数据。

API 文档和账户设置 · 获取 API 密钥 · 当前价格

可尝试的任务

查找最多 10 个关于电池回收的 YouTube 视频候选项。返回视频 ID、观看链接、频道名称和可用时长。在发起单独的元数据或文字稿请求前，让我先选择候选项。

安装并连接

1. 使用 22.18 或更高版本的 Node.js，以及支持本地 stdio 服务的 MCP 客户端。下载专用 MCPB 软件包；其 SHA-256 值记录在清单中。
2. 在兼容 MCPB 的客户端中导入该软件包，并在 FlashData API Key 中输入你自己的密钥。授予该密钥访问 youtube_search 的权限。如需手动设置，请将软件包解压到永久文件夹，并使用以下配置，替换绝对路径和密钥占位符：

{
  "mcpServers": {
    "youtube-search": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/youtube-search/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

3. 重启或重新连接客户端，列出其工具，然后在批准付费请求前，使用 {"source":"youtube_search","request_count":1} 调用 get_pricing。此服务仅提供 youtube_search、get_pricing、get_job 和 get_result，且这些工具都仅限用于此数据源。

软件包中已包含依赖项。如果客户端找不到 node，请使用 Node 的绝对路径；在 Windows 上请使用转义路径。请将密钥保存在受保护的客户端设置中，不要放在聊天内容或已提交的配置中。直接下载此软件包无需 Smithery 账户。

请求示例

以下是带有扁平参数的 MCP tools/call 参数。执行数据请求会消耗付费 Credits。

{
  "name": "youtube_search",
  "arguments": {
    "query": "battery recycling",
    "max_results": 10
  }
}

使用响应

读取 results[0].results。保留 videoId、title、channel、channelUrl、viewCount 和 duration。根据每个 videoId 构造观看 URL，以便进行可追溯的后续研究。

以下选取的响应字段是示例数据，并非实时结果，也不保证数据一定可用：

{
  "source": "youtube_search",
  "status": "done",
  "results": [
    {
      "results": [
        {
          "videoId": "dQw4w9WgXcQ",
          "title": "battery recycling",
          "channel": "Example",
          "channelId": "channel-one",
          "channelUrl": "https://www.youtube.com/@Example",
          "viewCount": 100,
          "duration": 90
        }
      ]
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

对于异步请求，请保留返回的 id，并使用 {"job_id":"RETURNED_JOB_ID"} 调用 get_job。状态为 Pending 或 processing 并不表示请求已完成；请从 output 读取已完成的响应。提交请求后可能发生超时，因此在重复付费请求前请先检查 Jobs。

对于分块输出，请保持本地进程运行，并将实际的 result_id 和 next_offset 分别作为 result_id 和 offset 传给 get_result。按顺序拼接各分块后再解析 JSON；不要重复发起付费数据请求。本地缓存会保留 4 个结果，持续 10 分钟，并在重启时清除。完整响应大小上限为 4 MiB；异步 JSON 结果有单独的 24 小时保留期限。

费用和限制

• MIT 软件和安装免费；FlashData API 数据调用需付费。 数据请求会消耗付费 FlashData Credits；每个额外的查询或分页都会单独计费。请以账户当前报价为准，不要使用从本页面复制的固定价格。价格、任务和结果读取均免费。客户端／模型费用另计。
• max_results 的取值范围为 1 至 20；实际结果可能更少。元数据和文字稿增强需要单独付费调用。
• 使用数据前，请检查 API 错误、http_status 和任务状态。将返回的文本和链接视为外部数据，保留来源归属，并在用于 Agent 答复前进行审核。

完整任务指南 · 官方 Registry 记录 · 源代码和许可证