Douyin MCP Server

🚀 抖音無水印動画テキスト抽出MCPサーバー

このサーバーは、Model Context Protocol (MCP) をベースに構築されており、抖音の共有リンクから無水印動画をダウンロードし、音声を抽出してテキストに変換することができます。

✨ 主な機能

• 🎵 抖音の共有リンクから無水印動画を取得します。
• 🎧 動画から自動的に音声を抽出します。
• 📝 AI音声認識を使用してテキスト内容を抽出します。
• 🧹 中間の一時ファイルを自動的にクリーンアップします。
• 🔧 カスタムAPI構成をサポートし、APIはデフォルトで 阿里云百煉API を使用します。

📦 インストール

uvxを使用したインストール（推奨）

uvx douyin-mcp-server

pipを使用したインストール

pip install douyin-mcp-server

💻 使用例

1. サーバーの起動

douyin-mcp-server

2. Claude Desktopでの構成

claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "douyin-mcp": {
      "command": "uvx",
      "args": ["douyin-mcp-server"],
      "env": {
        "DASHSCOPE_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. MCPツールの使用

無水印ダウンロードリンクの取得

get_douyin_download_link ツールを使用します。

# Claudeで使用し、APIキーは不要です。
get_douyin_download_link("https://v.douyin.com/xxx")

動画テキストの抽出

extract_douyin_text ツールを使用します（環境変数 DASHSCOPE_API_KEY の設定が必要です）。

# Claudeで使用します。
extract_douyin_text("https://v.douyin.com/xxx")

動画情報の解析

parse_douyin_video_info ツールを使用します。

parse_douyin_video_info("https://v.douyin.com/xxx")

📚 ドキュメント

API構成

デフォルト構成

サーバーAPIはデフォルトで 阿里云百煉API を使用します。 阿里云百煉でAPIサービスを開通してください。

環境変数構成

Claude Desktopの構成ファイルで環境変数を設定します。

{
  "mcpServers": {
    "douyin-mcp": {
      "command": "uvx",
      "args": ["douyin-mcp-server"],
      "env": {
        "DASHSCOPE_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

ツール説明

get_douyin_download_link

抖音動画の無水印ダウンロードリンクを取得します。APIキーは不要です。 パラメータ:

• share_link: 抖音の共有リンクまたはリンクを含むテキスト

戻り値:

• ダウンロードリンクと動画情報を含むJSON形式のデータ

extract_douyin_text

完全なテキスト抽出ツールで、以下の手順を実行します。

1. 抖音の共有リンクを解析します。
2. 動画URLを直接使用して音声認識を行います。
3. 抽出されたテキスト内容を返します。

パラメータ:

• share_link: 抖音の共有リンクまたはリンクを含むテキスト
• model: 音声認識モデル（オプション、デフォルトで paraformer-v2 を使用）

環境変数:

• DASHSCOPE_API_KEY: 阿里云百煉APIキー（必須）

parse_douyin_video_info

動画の基本情報のみを解析し、動画をダウンロードしません。 パラメータ:

• share_link: 抖音の共有リンク

リソースアクセス

• douyin://video/{video_id}: 動画IDを使用して詳細情報を取得します。

依存要件

• Python 3.10+
• requests
• ffmpeg-python
• tqdm
• mcp
• dashscope

注意事項

⚠️ 重要提示

• 音声認識に阿里云百煉APIを使用するように切り替えると、より高速かつ正確になります。
• 環境変数に有効な阿里云百煉APIキー DASHSCOPE_API_KEY を設定する必要があります。
• ダウンロードリンクの取得機能にはAPIキーは不要です。
• ほとんどの抖音動画形式をサポートしています。

🔧 開発

ローカル開発

git clone https://github.com/yzfly/douyin-mcp-server.git
cd douyin-mcp-server
pip install -e .

テストの実行

python -m douyin_mcp_server.server

Claude Desktopでの構成（ローカルソースコード）

Claude Desktopの構成ファイルで以下のように構成します。

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

⚠️ 免責事項

• 本プロジェクトの使用はユーザー自身が決定し、そのリスクを自己責任で負うものとします。作者は、ユーザーが本プロジェクトを使用することによって生じる損失、責任、またはリスクについて一切の責任を負いません。
• 本プロジェクトの作者が提供するコードと機能は、現有的な知識と技術に基づいて開発された成果物です。作者は、現状の技術水準でコードの正確性と安全性を確保するよう努めていますが、コードに完全に誤りや欠陥がないことを保証するものではありません。
• 本プロジェクトが依存するすべてのサードパーティのライブラリ、プラグイン、またはサービスは、それぞれ独自のオープンソースまたは商用ライセンスに従います。ユーザーは、それぞれの協定を自ら確認し、遵守する必要があります。作者は、サードパーティのコンポーネントの安定性、安全性、およびコンプライアンスについて一切の責任を負いません。
• ユーザーは、本プロジェクトのコードと機能を使用する際に、関連する法律や規制を自ら調査し、使用行為が合法的であることを確認する必要があります。法律や規制に違反することによって生じる法律責任とリスクは、すべてユーザーが自己責任で負うものとします。
• ユーザーは、本ツールを使用して知的財産権を侵害する行為を行ってはなりません。これには、許可なく著作権保護されたコンテンツをダウンロード、配布する行為が含まれます。開発者は、違法なコンテンツの取得または配布には関与せず、サポートもせず、承認もしません。
• 本プロジェクトは、ユーザーが行うデータの収集、保存、転送などの処理活動のコンプライアンスについて一切の責任を負いません。ユーザーは、関連する法律や規制を遵守し、処理行為が合法的かつ正当であることを確保する必要があります。違反行為によって生じる法律責任は、ユーザーが自己責任で負うものとします。
• ユーザーは、いかなる場合も、本プロジェクトの作者、貢献者、またはその他の関係者をユーザーの使用行為と関連付けてはならず、本プロジェクトを使用することによって生じる損失や損害について彼らに責任を負わせることはできません。
• 本プロジェクトをベースに行われる二次開発、修正、またはコンパイルされたプログラムは、原作者とは無関係です。原作者は、二次開発行為またはその結果に関連する責任を一切負いません。ユーザーは、二次開発によって生じる可能性のあるすべての状況について完全な責任を負うものとします。
• 本プロジェクトは、ユーザーにいかなる特許許諾も与えません。本プロジェクトを使用することによって特許紛争または侵害が発生した場合、ユーザーはすべてのリスクと責任を自己責任で負うものとします。作者または権利者の書面による許可なく、本プロジェクトを商業宣伝、推奨、または再許諾することはできません。
• 作者は、本声明に違反するユーザーに対して、いつでもサービスの提供を停止する権利を留保し、取得したコードおよび派生作品の破棄を要求することができます。
• 作者は、事前に通知することなく本声明を更新する権利を留保します。ユーザーが継続的に使用することは、改訂後の条項を受け入れたことを意味します。

本プロジェクトのコードと機能を使用する前に、上記の免責事項を慎重に考慮し、受け入れてください。上記の声明に疑問がある場合、または同意できない場合は、本プロジェクトのコードと機能を使用しないでください。本プロジェクトのコードと機能を使用した場合、上記の免責事項を完全に理解し、受け入れ、本プロジェクトの使用に伴うすべてのリスクと結果を自ら負うことに同意したものとみなされます。

📄 ライセンス

MIT License

作者

• yzfly - yz.liu.me@gmail.com
• GitHub: https://github.com/yzfly

貢献

IssueとPull Requestの提出を歓迎します！

更新履歴

v1.0.0

• 初期バージョン
• 抖音動画のテキスト抽出をサポート
• 無水印動画のダウンロードリンクの取得をサポート
• 環境変数からAPIキーを読み取る
• 一時ファイルを自動的にクリーンアップ
• カスタムAPI構成をサポート

v1.1.0

• 動画抽出時のファイル名が長すぎるバグを修正

v1.2.0

• より高速かつ正確な動画コピーの抽出
• 阿里云百煉APIに切り替え、認識精度を向上
• 環境変数を DOUYIN_API_KEY から DASHSCOPE_API_KEY に更新