面向 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": 1, "creditsRemaining": 99 }
}

仅成功扣 Credits

成功返回至少一条图片、视频或音频 URL 时扣 1 credit。不支持的 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,只有 parse_media_url 成功返回可下载媒体时才扣 1 credit。

EasyDown 会存储下载文件吗?

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