面向 AI Agent 的 EasyDown

视频下载 MCP Server

通过一个经过鉴权的工具,把 Claude Code、Cursor、MCP Inspector 或其他 Streamable HTTP 客户端接入 EasyDown 支持的 11 个公开媒体平台。

Streamable HTTP 生产端点已上线https://api.easydown.org/mcp

连接 MCP Server

REST API 和 MCP 使用同一个 EasyDown 私有 API Token。请把 Token 保存在客户端配置中,不要暴露到公开浏览器代码。

{
  "mcpServers": {
    "easydown": {
      "url": "https://api.easydown.org/mcp",
      "headers": {
        "Authorization": "Bearer ed_live_xxx"
      }
    }
  }
}

请把 ed_live_xxx 替换为 EasyDown 后台创建的 API Token。

各平台下载 MCP 页面

每个平台页面分别说明公开链接格式、媒体返回行为、真实请求示例和已知限制。

一个工具,一套返回结构

服务只暴露 parse_media_url。它根据 URL 自动识别平台,并完整保留现有 EasyDown 解析器返回的媒体候选。

输入

parse_media_url({
  "url": "https://www.youtube.com/watch?v=..."
})

结构化输出

{
  "status": 200,
  "data": { "images": [], "videos": [], "audios": [] },
  "billing": { "creditsCharged": 3, "creditsRemaining": 97 }
}

Credits 扣费规则

大多数平台成功交付媒体,或已产生处理成本但内容明确受限时,扣 1 credit。YouTube 扣 3 credits,Threads 和快手扣 2 credits,小红书 / RedNote 扣 10 credits。不支持的 URL、鉴权错误、临时故障和未确认处理成本的空结果不扣费。

公开单条媒体内容

MCP Server 面向受支持的公开单条帖子。主页、搜索页、内容流、合集、私密内容、已删除内容和未支持直播页不在范围内。

MCP Server 常见问题

EasyDown MCP Server 返回什么?

parse_media_url 返回现有 EasyDown 媒体结构,包括平台、标题、缩略图、时长、图片、视频、音频、消息和计费数据,MCP 层不会截断候选数组。

视频下载 MCP Server 如何鉴权?

在 EasyDown 后台创建 ed_live API Token,并在每次 Streamable HTTP 请求中发送 Authorization: Bearer ed_live_xxx。

连接和列出 MCP 工具会扣费吗?

不会。初始化和 tools/list 不扣 credits。大多数平台成功交付媒体,或已产生处理成本但内容明确受限时,扣 1 credit。YouTube 扣 3 credits,Threads 和快手扣 2 credits,小红书 / RedNote 扣 10 credits。不支持的 URL、鉴权错误、临时故障和未确认处理成本的空结果不扣费。

EasyDown 会存储下载文件吗?

不会。MCP Server 返回源站媒体 URL 和元数据,这些 URL 可能过期,也可能受到请求头、Cookie 或地区限制。