Douyin MCP Server

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

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

🚀 クイックスタート

このサーバーを使用することで、抖音の共有リンクから無水印動画を取得し、音声を抽出してテキストに変換することができます。以下に、基本的な使い方を説明します。

✨ 主な機能

• 🎵 抖音の共有リンクから無水印動画を取得します。
• 🎧 動画から自動的に音声を抽出します。
• 📝 AI音声認識を使用してテキスト内容を抽出します。
• 🧹 中間の一時ファイルを自動的に削除します。
• 🔧 APIのカスタム設定をサポートしており、デフォルトではSiliconFlow 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": {
        "DOUYIN_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ツールを使用します（環境変数DOUYIN_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の設定

デフォルト設定

サーバーはデフォルトでSiliconFlow APIを使用します。

• API URL: https://api.siliconflow.cn/v1/audio/transcriptions
• モデル: FunAudioLLM/SenseVoiceSmall

カスタム設定

APIの設定をカスタマイズすることができます。

extract_douyin_text(
    share_link="your-douyin-link",
    api_base_url="https://your-custom-api.com/transcriptions",
    model="your-custom-model"
)

環境変数の設定

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

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

ツールの説明

get_douyin_download_link

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

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

戻り値:

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

extract_douyin_text

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

1. 抖音の共有リンクを解析します。
2. 無水印動画をダウンロードします。
3. 音声を抽出します。
4. 音声をテキストに変換します。
5. 一時ファイルを削除します。

パラメータ:

• share_link: 抖音の共有リンクまたはリンクを含むテキスト
• api_base_url: APIのベースURL（オプション）
• model: 音声認識モデル（オプション）

環境変数:

• DOUYIN_API_KEY: 音声認識APIのキー（必須）

parse_douyin_video_info

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

• share_link: 抖音の共有リンク

リソースへのアクセス

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

依存関係

• Python 3.8以上
• ffmpeg（システムにffmpegをインストールする必要があります）
• requests
• ffmpeg-python
• tqdm
• mcp

ffmpegのインストール

macOS

brew install ffmpeg

Ubuntu/Debian

sudo apt update
sudo apt install ffmpeg

Windows

ffmpegをダウンロードしてインストールします。

開発

ローカル開発

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

テストの実行

python -m douyin_mcp_server.server

🔧 技術詳細

注意事項

• システムにffmpegがインストールされていることを確認してください。
• 環境変数に有効な音声認識APIキー DOUYIN_API_KEY を設定する必要があります。
• ダウンロードリンクの取得機能にはAPIキーは不要です。
• 中間ファイルは自動的に削除され、ディスク領域を占有しません。
• ほとんどの抖音動画形式をサポートしています。

⚠️ 免責事項

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

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

📄 ライセンス

MIT License

作者

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

貢献

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

更新履歴

v1.0.0

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

v1.1.0

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