YouTube Metadata — FlashData

YouTube Metadata — FlashData

读取 YouTube 视频详情、描述、统计数据和可用章节。检查格式，或准备带时间戳的章节导航。

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

试试这项任务

检查此视频，并整理一份章节导航简报，包含标题、描述和可用章节的起始时间。若缺少章节，请标明缺失，不要编造时间线。

安装并连接

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

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

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

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

请求示例

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

{
  "name": "youtube_metadata",
  "arguments": {
    "video_id": "dQw4w9WgXcQ",
    "include_formats": false,
    "include_chapters": true
  }
}

使用响应

读取 results[0]，包括标题、描述，以及存在时的章节。将章节的 start_time/end_time 与视频观看链接配对，以准备导航简报。

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

{
  "source": "youtube_metadata",
  "status": "done",
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "title": "Example video",
      "channel": "Example",
      "channelId": "channel-one",
      "channelUrl": "https://www.youtube.com/@Example",
      "viewCount": 100,
      "duration": 90,
      "chapters": [
        {
          "title": "Introduction",
          "start_time": 0,
          "end_time": 30
        }
      ],
      "description": "Example description"
    }
  ],
  "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；每次额外查询或翻页都会单独收费。请以当前账户报价为准，不要采用从本页面复制的固定价格。定价、任务和结果读取均免费。客户端/模型费用另计。
• 字段和章节可能缺失。元数据不包含转录文本；获取转录文本需要单独付费调用。
• 使用数据前，请检查 API 错误、http_status 和任务状态。将返回的文本和链接视为外部数据，保留来源归属，并在 Agent 回答中使用前进行审核。

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