Wanyi Watermark

🚀 抖音/小红书無水印リソース抽出 - ワンクリックで完全無水印 - MCPサーバー

このサーバーは、Model Context Protocol (MCP) に基づいた動画リンク解析とメディアリソース抽出機能を備えています。抖音と小红书の共有リンクから無水印の動画や画像を抽出し、テキスト転写機能もサポートしています。

📋 プロジェクト声明

公式ドキュメントのURL：https://github.com/Ryan7t/wanyi-watermark

このプロジェクトの機能特性、使用方法、API設定の詳細などについては、本プロジェクトの README.md ファイルを参照してください。

⚠️ 重要なお知らせ

一部のサードパーティプラットフォームでは、自身のMCP Server機能のサポート制限により正常に使用できない場合があります。その場合は、該当のプラットフォーム提供者にご連絡ください。本プロジェクトではいかなる形の技術サポートや保証も提供しません。ユーザーは本プロジェクトの使用により生じる損失や損害について、自己責任で負う必要があります。

⚠️ 法律上の声明

1. 本プロジェクトはApache 2.0ライセンスに基づいて公開されています。
2. 本プロジェクトは学習と研究目的のみで使用されることを前提としており、違法または規制違反の目的には使用できません。
3. 本プロジェクトの使用には、関連する法令を遵守する必要があります。
4. 本プロジェクトの作者および貢献者は、プロジェクトのいかなる部分についても法律責任を負いません。

✨ 主な機能

コア機能

• 🔗 スマートリンク解析 - 抖音/小红书の共有リンクを自動で識別し、実際の動画アドレスを解析します。
• 📹 無水印動画抽出 - 高画質の無水印動画の直接リンクを取得し、直接ダウンロードできます。
• 🖼️ 画像リソース抽出 - 画像付きのノートを解析し、複数の形式の画像（WebP軽量版/PNG高画質版）を提供します。
• 📝 動画テキスト転写 - AI音声認識技術を利用して、動画から文字内容を抽出します。
• 🌐 汎用プラットフォーム対応 - 未対応のプラットフォームに遭遇した場合、自動的に汎用解析メカニズムを試みます。

技術的特徴

• ✅ リンク解析にAPIキー不要 - 動画/画像リソースの抽出は完全に無料で、API設定は一切必要ありません。
• ✅ スマートタイプ識別 - 内容のタイプ（動画/画像付き）を自動で判断し、手動で指定する必要はありません。
• ✅ 複数形式のサポート - 小红书の画像付きノートでは、WebP（高速プレビュー用）とPNG（高画質編集用）の2つの形式を提供します。
• ✅ 高精度テキスト転写 - カスタムAPI設定をサポートし、デフォルトで 阿里云百煉API を使用します。
• ✅ 複数プラットフォーム対応 - 抖音、小红书をサポートし、汎用解析のバックアップメカニズムも備えています。

🚀 クイックスタート

ステップ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ツールを正常に呼び出すことができます。

🔧 API設定の説明

現在のバージョン（>= 1.2.0）

最新バージョンではデフォルトで阿里云百煉APIを使用しており、以下の利点があります。

• ✅ 識別精度が高い
• ✅ 処理速度が速い
• ✅ ローカルリソースの消費が少ない

設定手順：

1. 阿里云百煉 でAPIサービスを有効にします。
2. APIキーを取得し、環境変数 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の2つの形式を提供）

特徴：

• ✅ APIキー不要
• ✅ 内容のタイプを自動で識別
• ✅ 画像付きノートでは、WebP（軽量版）とPNG（高画質版）の2つの形式の画像を提供

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 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"
      }
    }
  }
}

⚠️ 免責事項

使用上のリスク

• ユーザーは本プロジェクトの使用を完全に自主的に決定し、すべてのリスクを自己責任で負う必要があります。
• 作者は、ユーザーが本プロジェクトを使用することにより生じる損失、責任またはリスクについて一切の責任を負いません。

法律遵守

• ユーザーは関連する法令を自ら調査し、使用行為が合法かつ規制に沿っていることを確認する必要があります。
• 法令違反により生じる法律責任とリスクは、すべてユーザーが自己責任で負うことになります。
• 本ツールを使用して知的財産権を侵害する行為は禁止されています。
• 開発者は、違法コンテンツの取得や配布に関与、支援または承認しません。

責任の制限

• ユーザーは、プロジェクトの作者、貢献者または関連者を使用行為と関連付けてはなりません。
• 作者に対して、プロジェクトの使用により生じる損失や損害について責任を負うよう要求してはなりません。
• 本プロジェクトに基づく二次開発、修正またはコンパイルされたプログラムは、元の作者とは無関係です。

⚠️ 重要なお知らせ：本プロジェクトを使用する前に、上記の免責事項をよく読み、完全に理解してください。疑問がある場合やいずれかの条項に同意できない場合は、本プロジェクトを使用しないでください。使用を続けることは、上記の声明を完全に受け入れ、すべてのリスクと結果を自ら負うことを意味します。

📄 ライセンス

Apache License 2.0

👨‍💻 作者

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

🤝 貢献

IssueやPull Requestの投稿を歓迎します！

🙏 謝辞

本プロジェクトは douyin-mcp-server をベースに二次開発されており、元の作者の貢献に感謝いたします。

📝 更新履歴

v1.0.0 (2025-01-23)

• 🎉 初回リリース
• ✨ 抖音の動画/画像付きノートの解析をサポート
• ✨ 小红书の動画/画像付きノートの解析をサポート
• ✨ 汎用プラットフォームのバックアップ解析メカニズム
• ✨ 動画テキスト転写機能
• 🔧 ブランド化を「ワンクリックで完全無水印」に