金大哥 - wanyi-watermark MCP 详情

article

README

🚀 抖音/小红书无水印资源提取 - 百分百一键去水印 - MCP 服务器

本项目是基于 Model Context Protocol (MCP) 的视频链接解析与媒体资源提取服务器，能够从抖音和小红书分享链接中提取无水印视频和图片，还支持视频文本转写功能，为用户提供便捷的资源获取体验。

🚀 快速开始

步骤 1：获取 API 密钥

前往阿里云百炼 API 获取您的 DASHSCOPE_API_KEY：获取阿里云百炼API

步骤 2：配置环境变量

在 Claude Desktop、Cherry Studio 等支持 MCP Server 的应用配置文件中添加以下配置：

{
  "mcpServers": {
    "wanyi-watermark": {
      "command": "uvx",
      "args": ["wanyi-watermark"],
      "env": {
        "DASHSCOPE_API_KEY": "sk-xxxx"
      }
    }
  }
}

步骤 3：开始使用

配置完成后，您就可以在支持的应用中正常调用 MCP 工具了。

✨ 主要特性

核心能力

🔗 智能链接解析：自动识别抖音/小红书分享链接，解析真实视频地址。
📹 无水印视频提取：获取高清无水印视频直链，支持直接下载。
🖼️ 图片资源提取：支持图文笔记解析，提供多格式图片（WebP轻量/PNG高清）。
📝 视频文本转写：基于AI语音识别，从视频中提取文字内容。
🌐 通用平台兜底：遇到未适配平台时，自动尝试通用解析机制。

技术特点

✅ 链接解析无需密钥：视频/图片资源提取完全免费，无需任何 API 配置。
✅ 智能类型识别：自动判断内容类型（视频/图文），无需手动指定。
✅ 多格式支持：小红书图文提供 WebP（快速预览）和 PNG（高清编辑）双格式。
✅ 高精度文本转写：支持自定义 API 配置，默认使用阿里云百炼 API。
✅ 多平台兼容：支持抖音、小红书，并提供通用解析兜底机制。

📦 安装指南

克隆仓库

git clone https://github.com/Ryan7t/wanyi-watermark.git
cd wanyi-watermark

安装依赖（开发模式）

pip install -e .

运行测试

# 启动服务器
python -m douyin_mcp_server

# 测试抖音链接解析
python -m douyin_mcp_server.douyin_processor "<抖音分享链接>"

# 测试小红书链接解析
python -m douyin_mcp_server.xiaohongshu_processor "<小红书分享链接>"

Claude Desktop 本地开发配置

{
  "mcpServers": {
    "wanyi-watermark": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/wanyi-watermark",
        "python",
        "-m",
        "douyin_mcp_server"
      ],
      "env": {
        "DASHSCOPE_API_KEY": "your-api-key-here"
      }
    }
  }
}

💻 使用示例

基础用法

以下是使用 parse_douyin_link 解析抖音链接的示例：

# 假设已经导入了相关工具
from your_module import parse_douyin_link

share_link = "https://v.douyin.com/xxxxxx/"
result = parse_douyin_link(share_link)
print(result)

高级用法

使用 extract_douyin_text 从抖音视频中提取语音文本内容：

# 假设已经导入了相关工具
from your_module import extract_douyin_text

share_link = "https://v.douyin.com/xxxxxx/"
text = extract_douyin_text(share_link)
print(text)

📚 详细文档

项目声明

官方文档地址：https://github.com/Ryan7t/wanyi-watermark 请以本项目的 README.md 文件为准，了解项目的功能特性、使用方法、API 配置说明等详细信息。
重要提醒：第三方平台如因自身 MCP Server 功能支持度限制而无法正常使用，请联系相应平台方。本项目不提供任何形式的技术支持或保证，用户需自行承担使用本项目可能产生的任何损失或损害。
法律声明：
1. 本项目基于 Apache 2.0 协议发布。
2. 本项目仅供学习和研究使用，不得用于任何违法或违规目的。
3. 本项目的使用必须遵守相关法律法规。
4. 本项目的作者和贡献者不对项目的任何部分承担法律责任。

API 配置说明

当前版本（>= 1.2.0）

最新版本默认使用阿里云百炼 API，具有以下优势：

✅ 识别效果更好
✅ 处理速度更快
✅ 本地资源消耗更小

配置步骤：

前往阿里云百炼开通 API 服务。
获取 API Key 并配置到环境变量 DASHSCOPE_API_KEY 中。

⚠️ 重要提示

DASHSCOPE_API_KEY 仅用于视频文本转写功能，链接解析和资源提取无需 API 密钥。

获取 API 密钥（可选）

如果需要使用视频文本转写功能，请前往阿里云百炼获取 API 密钥。

工具说明

主要工具

parse_douyin_link：解析抖音分享链接，自动识别视频/图文类型并返回无水印资源。
- 参数：
  - share_link (string)：抖音分享链接或包含链接的文本。
- 返回：
  - 视频类型：JSON 格式的无水印视频下载链接和视频信息。
  - 图文类型：JSON 格式的图片列表和笔记信息。
- 特点：
  - ✅ 无需 API 密钥。
  - ✅ 自动识别内容类型。
  - ✅ 失败时自动尝试通用解析。
parse_xhs_link：解析小红书分享链接，自动识别视频/图文类型并返回无水印资源。
- 参数：
  - share_link (string)：小红书分享链接或包含链接的文本。
- 返回：
  - 视频类型：JSON 格式的无水印视频下载链接和视频信息。
  - 图文类型：JSON 格式的图片列表（同时提供 WebP 和 PNG 两种格式）。
- 特点：
  - ✅ 无需 API 密钥。
  - ✅ 自动识别内容类型。
  - ✅ 图文笔记提供双格式图片（WebP轻量 + PNG高清）。
parse_generic_link：通用平台链接解析，适用于未明确支持的平台或作为备用方案。
- 参数：
  - share_link (string)：任意平台的分享链接或包含链接的文本。
- 返回：
  - 包含资源链接和信息的 JSON 字符串。

特殊功能

extract_douyin_text：从抖音视频中提取语音文本内容。
- 参数：
  - share_link (string)：抖音分享链接或包含链接的文本。
  - model (string, 可选)：语音识别模型，默认使用 paraformer-v2。
- 环境变量要求：
  - DASHSCOPE_API_KEY：阿里云百炼 API 密钥（必需）。

系统要求

运行环境：
- Python：3.10 或更高版本。
依赖库：
- mcp：Model Context Protocol 支持。
- requests：HTTP 请求处理。
- ffmpeg-python：音视频处理。
- tqdm：进度条显示。
- dashscope：阿里云百炼 API 客户端。

🔧 技术细节

本地开发

本项目支持本地开发，您可以按照以下步骤进行操作：

克隆仓库：通过 git clone 命令将项目克隆到本地。
安装依赖：使用 pip install -e . 安装开发模式的依赖。
运行测试：启动服务器并测试抖音和小红书链接解析功能。
本地开发配置：在 Claude Desktop 中进行相应的配置，以便进行本地开发。

📄 许可证

本项目基于 Apache License 2.0 发布。

👨‍💻 作者

wanyi
Email: 2368077712@qq.com
GitHub: @Ryan7t

🤝 贡献

欢迎提交 Issue 和 Pull Request，共同完善本项目！

🙏 致谢

本项目基于 douyin-mcp-server 进行二次开发，感谢原作者的贡献。

📝 更新日志

v1.0.0 (2025-01-23)

🎉 首次发布。
✨ 支持抖音视频/图文解析。
✨ 支持小红书视频/图文解析。
✨ 通用平台兜底解析机制。
✨ 视频文本转写功能。
🔧 品牌化为"百分百一键去水印"。

⚠️ 免责声明

使用风险：使用者对本项目的使用完全自主决定，并自行承担所有风险。作者对使用者因使用本项目而产生的任何损失、责任或风险概不负责。
法律合规：使用者必须自行研究相关法律法规，确保使用行为合法合规。任何违反法律法规导致的法律责任和风险，均由使用者自行承担。禁止使用本工具从事任何侵犯知识产权的行为。开发者不参与、不支持、不认可任何非法内容的获取或分发。
责任限制：使用者不得将项目作者、贡献者或相关方与使用行为联系起来。不得要求作者对使用项目产生的任何损失或损害负责。基于本项目的二次开发、修改或编译程序与原作者无关。

⚠️ 重要提示

在使用本项目前，请认真阅读并完全理解上述免责声明。如有疑问或不同意任何条款，请勿使用本项目。继续使用即视为完全接受上述声明并自愿承担所有风险和后果。

wanyi-watermark