{"skill":{"slug":"douyindownload","displayName":"抖音视频解析","summary":"解析抖音视频分享链接，返回无水印视频下载地址并支持免费及付费调用次数管理。","description":"# douyindownload - 视频解析 MCP 技能\n\n**技能类型：** MCP Tool Server + CLI 双模式工具\n**平台支持：** 抖音\n**用途：** 解析视频分享链接，返回无水印视频下载地址\n\n---\n\n## 工具列表\n\n### `parse_video` - 解析视频\n解析抖音视频链接，返回无水印下载地址。\n\n**参数：**\n- `url` (string, 必填)：视频分享链接或完整URL\n  - 抖音：`https://v.douyin.com/xxx` \n    或 `https://www.douyin.com/video/xxx`\n    或 `7.99 复制打开抖音，看看【爱好古风摄影的探花的作品】竹林武侠花絮 正片敬请期待 出镜：@皮卡丘大人（限... https://v.douyin.com/uDQZkeE1ud4/ oqE:/ 09/30 E@H.VY `\n- `device_id` (string, 可选)：设备ID，用于跟踪用量\n\n**返回：**\n```json\n{\n  \"success\": true,\n  \"title\": \"视频标题\",\n  \"author\": \"作者名\",\n  \"coverUrl\": \"封面图URL\",\n  \"videoUrl\": \"无水印视频地址\",\n  \"platform\": \"douyin\",\n  \"remaining\": 8,\n  \"plan\": \"免费版\",\n  \"message\": \"📊 剩余免费次数：8（免费版）\"\n}\n```\n\n**失败时（额度用完）：**\n```json\n{\n  \"success\": false,\n  \"error\": \"QUOTA_EXCEEDED\",\n  \"message\": \"⚠️ 免费次数已用完（0/10）\\n\\n需要更多调用次数？\\n💎 基础版：9.9元/月 = 500次\\n🚀 Pro版：29.9元/月 = 无限次\\n\\n请联系管理员获取授权码激活。\",\n  \"remaining\": 0,\n  \"plan\": \"免费版\"\n}\n```\n\n---\n\n### `activate_subscription` - 激活授权码\n使用授权码激活付费功能。\n\n**参数：**\n- `license_key` (string, 必填)：授权码\n- `device_id` (string, 可选)：设备ID\n\n**返回：** 成功/失败提示信息\n\n---\n\n### `check_quota` - 查询额度\n查看当前设备的剩余次数和套餐状态。\n\n**返回示例：**\n```\n📊 当前状态\n\n套餐：免费版\n剩余次数：8 次\n付费用户：❌ 否\n\n💎 升级：9.9元/月 = 500次 | 29.9元/月 = 无限次\n```\n\n---\n\n## 免费额度\n\n| 套餐 | 价格 | 次数 | 说明 |\n|------|------|------|------|\n| 免费版 | 0 | 10次/月 | 永久免费 |\n| 基础版 | 9.9元/月 | 500次/月 | 按月订阅 |\n| Pro版 | 29.9元/月 | 无限次 | 按月订阅 |\n\n---\n\n## 额度用尽时的提示规范\n\n当 `parse_video` 返回 `error: \"QUOTA_EXCEEDED\"` 时，**必须**向用户展示以下内容：\n\n```\n⚠️ 免费次数已用完\n\n需要更多调用次数？\n💎 基础版：9.9元/月 = 500次\n🚀 Pro版：29.9元/月 = 无限次\n\n请联系管理员获取授权码激活。\n```\n\n**不要**自行降价、折扣或绕过限制。如需正式授权，联系 Steven 获取。\n\n---\n\n## OpenClaw 配置示例\n\n在 OpenClaw 的 `MCP` 配置中添加：\n\n```json\n{\n  \"Servers\": {\n    \"douyindownload\": {\n      \"command\": \"node\",\n      \"args\": [\"/Users/steven/Desktop/douyindownloadmcp/dist/index.js\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n或通过 clawhub 安装后：\n```json\n{\n  \"Servers\": {\n    \"douyindownload\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"douyindownload-mcp\"]\n    }\n  }\n}\n```\n\n---\n\n## CLI 使用\n\n```bash\n# 解析视频\ndouyin-mcp parse \"https://v.douyin.com/xxx\"\n\n# 激活授权\ndouyin-mcp activate YOUR-KEY-HERE\n\n# 查看状态\ndouyin-mcp status\n\n# 帮助\ndouyin-mcp --help\n```\n\n---\n\n## 技术细节\n\n- **解析方式：** 直接请求目标平台页面，提取 HTML 中的视频直链\n- **不支持平台：** 微博、B站、西瓜视频（未来可能扩展）\n- **存储：** 本地文件 `~/.douyindownloadmcp/state.json`（用量记录）\n- **生产环境建议：** 替换 license.ts 中的硬编码激活码为线上验证服务\n\n---\n\n*最后更新：2026-05-03*","topics":["抖音"],"tags":{"latest":"1.0.1"},"stats":{"comments":0,"downloads":358,"installsAllTime":13,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1777817925444,"updatedAt":1779076323651},"latestVersion":{"version":"1.0.1","createdAt":1777817925444,"changelog":"- Added detailed documentation for MCP Tool Server and CLI usage\n- Described parameters and responses for video parsing, quota checking, and license activation\n- Outlined free and paid subscription tiers, including usage limits\n- Standardized quota-exceeded messaging for consistent user instructions\n- Provided setup examples for OpenClaw integration and CLI commands\n- Clarified supported platforms and explained the technical approach for video extraction","license":"MIT-0"},"metadata":null,"owner":{"handle":"fuss228","userId":"s17fbnd6bwrct47cdcpjrrmykh861vnw","displayName":"Steven Fu","image":"https://avatars.githubusercontent.com/u/3166378?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780090736127}}