YouTube Extended Search — FlashData

YouTube 扩展搜索 — FlashData

搜索更多 YouTube 视频结果，最多可请求 700 条。根据结构化的视频记录，梳理反复出现的频道和主题。

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

试试这个任务

搜索最多 100 条关于电池回收的 YouTube 视频。按频道对返回的视频分组，统计每个频道中观察到的视频数量，并保留观看链接以供查看。

安装并连接

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

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

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

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

请求示例

以下是 MCP tools/call 的扁平参数。运行数据请求会使用付费 Credits。

{
  "name": "youtube_search_extended",
  "arguments": {
    "query": "battery recycling",
    "max_results": 100
  }
}

使用响应

读取 results[0].results，并按 channelId 或 channelUrl 分组。保留原始视频 ID，并统计每个频道中观察到的结果数量；保留频道标签以供查看。

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

{
  "source": "youtube_search_extended",
  "status": "done",
  "results": [
    {
      "results": [
        {
          "videoId": "dQw4w9WgXcQ",
          "title": "battery recycling",
          "channel": "Example",
          "channelId": "channel-one",
          "channelUrl": "https://www.youtube.com/@Example",
          "viewCount": 100,
          "duration": 90
        },
        {
          "videoId": "aqz-KE-bpKQ",
          "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 MiB；异步 JSON 结果则有单独的 24 小时保留期限。

费用和限制

• MIT 软件和安装免费；FlashData API 数据调用需要付费。 数据请求会消耗付费的 FlashData Credits；每增加一次查询或翻页都会单独收费。请以当前账户报价为准，不要使用从本页面复制的固定价格。定价、任务和结果读取免费。客户端／模型费用另计。
• 请求上限为 700，这并不保证会返回 700 个视频或支持相应的分页数量。扩展搜索有自己的速率限制，且高于标准搜索。
• 使用数据前，请检查 API 错误、http_status 和任务状态。将返回的文本和链接视为外部数据，保留来源归属，并在用于 Agent 答复前进行审核。

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