Wanyi Watermark

🚀 抖音/小紅書無水印資源提取 - 百分百一鍵去水印 - MCP 服務器

本項目是基於 Model Context Protocol (MCP) 的視頻鏈接解析與媒體資源提取服務器，能夠從抖音和小紅書分享鏈接中提取無水印視頻和圖片，還支持視頻文本轉寫功能，為用戶提供便捷的資源獲取體驗。

🚀 快速開始

步驟 1：獲取 API 密鑰

前往 阿里雲百鍊 API 獲取您的 DASHSCOPE_API_KEY：

步驟 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，具有以下優勢：

• ✅ 識別效果更好
• ✅ 處理速度更快
• ✅ 本地資源消耗更小

配置步驟：

1. 前往 阿里雲百鍊 開通 API 服務。
2. 獲取 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 客戶端。

🔧 技術細節

本地開發

本項目支持本地開發，您可以按照以下步驟進行操作：

1. 克隆倉庫：通過 git clone 命令將項目克隆到本地。
2. 安裝依賴：使用 pip install -e . 安裝開發模式的依賴。
3. 運行測試：啟動服務器並測試抖音和小紅書鏈接解析功能。
4. 本地開發配置：在 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)

• 🎉 首次發佈。
• ✨ 支持抖音視頻/圖文解析。
• ✨ 支持小紅書視頻/圖文解析。
• ✨ 通用平臺兜底解析機制。
• ✨ 視頻文本轉寫功能。
• 🔧 品牌化為"百分百一鍵去水印"。

⚠️ 免責聲明

• 使用風險：使用者對本項目的使用完全自主決定，並自行承擔所有風險。作者對使用者因使用本項目而產生的任何損失、責任或風險概不負責。
• 法律合規：使用者必須自行研究相關法律法規，確保使用行為合法合規。任何違反法律法規導致的法律責任和風險，均由使用者自行承擔。禁止使用本工具從事任何侵犯知識產權的行為。開發者不參與、不支持、不認可任何非法內容的獲取或分發。
• 責任限制：使用者不得將項目作者、貢獻者或相關方與使用行為聯繫起來。不得要求作者對使用項目產生的任何損失或損害負責。基於本項目的二次開發、修改或編譯程序與原作者無關。

⚠️ 重要提示

在使用本項目前，請認真閱讀並完全理解上述免責聲明。如有疑問或不同意任何條款，請勿使用本項目。繼續使用即視為完全接受上述聲明並自願承擔所有風險和後果。