抖音無水印ビデオダウンロードおよびスクリプト抽出

抖音の共有リンクから無水印ビデオのダウンロードリンクを取得し、ビデオをダウンロードし、音声認識を使用してビデオ内のスクリプトを抽出し、自動的にファイルに保存します。

機能概要

• ダウンロードリンク取得: 抖音の共有リンクから無水印ビデオの直接ダウンロードアドレスを解析 (API キー不要)
• ビデオダウンロード: 無水印ビデオをローカルの指定ディレクトリにダウンロード
• スクリプト抽出: 音声認識を通じてビデオからテキストコンテンツを抽出 (Silicon Flow API キーが必要)
• 自動保存: 各ビデオのスクリプトを独立したフォルダに自動保存 (ビデオ ID をフォルダ名として使用)

環境要件

依存関係のインストール

pip install requests ffmpeg-python

システム要件

• FFmpeg はシステムにインストールされていなければならない (音声ビデオ処理用)
• macOS: brew install ffmpeg
• Ubuntu: apt install ffmpeg

API キー設定 (スクリプト抽出のみ必要)

スクリプト抽出機能は Silicon Flow API を使用し、環境変数を設定する必要があります:

export API_KEY="your-siliconflow-api-key"

API キー取得: https://cloud.siliconflow.cn/

使用方法

方法1: スクリプトを使用 (推奨)

# ビデオ情報とダウンロードリンクを取得 (API キー不要)
python douyin_downloader.py --link "抖音共有リンク" --action info

# ビデオを指定ディレクトリにダウンロード
python douyin_downloader.py --link "抖音共有リンク" --action download --output ./videos

# ビデオスクリプトを抽出してファイルに保存 (API_KEY 環境変数が必要)
python douyin_downloader.py --link "抖音共有リンク" --action extract --output ./output

# スクリプトを抽出して同時にビデオを保存
python douyin_downloader.py --link "抖音共有リンク" --action extract --output ./output --save-video

# サイレントモード (出力を減らす)
python douyin_downloader.py --link "抖音共有リンク" --action extract --output ./output --quiet

出力ディレクトリ構造

スクリプト抽出後、各ビデオは独立したフォルダに保存されます:

output/
├── 7600361826030865707/      # ビデオ ID をフォルダ名として使用
│   └── transcript.md         # Markdown 形式のスクリプトファイル
├── 7581044356631612699/
│   ├── transcript.md
│   └── 7581044356631612699.mp4  # --save-video 使用時に保存
└── ...

Markdown スクリプト形式

# ビデオタイトル

| 属性 | 値 |
|------|-----|
| ビデオID | `7600361826030865707` |
| 抽出時間 | 2026-01-30 14:19:00 |
| ダウンロードリンク | [ダウンロード](url) |

---

## スクリプトコンテンツ

(音声認識されたテキストコンテンツ)

方法2: Python コード内での呼び出し

from douyin_downloader import get_video_info, download_video, extract_text

# ビデオ情報を取得
info = get_video_info("抖音共有リンク")
print(f"ビデオID: {info['video_id']}")
print(f"タイトル: {info['title']}")
print(f"ダウンロードリンク: {info['url']}")

# ビデオをダウンロード
video_path = download_video("抖音共有リンク", output_dir="./videos")

# スクリプトを抽出してファイルに保存
result = extract_text("抖音共有リンク", output_dir="./output")
print(f"スクリプトは以下に保存されました: {result['output_path']}")
print(result['text'])

ワークフロー

ビデオ情報の取得

1. 抖音の共有リンクを解析し、実際のビデオ URL を抽出
2. モバイルエンドポイントリクエストをシミュレートしてページデータを取得
3. ページ JSON データから無水印ビデオアドレスを抽出
4. ビデオ ID、タイトル、ダウンロードリンクを返す

ビデオスクリプトの抽出

1. 共有リンクを解析してビデオ情報を取得
2. ビデオを一時ディレクトリにダウンロード
3. FFmpeg を使用してビデオから音声を抽出 (MP3 形式)
4. Silicon Flow SenseVoice API を呼び出して音声認識を実行
5. 一時ファイルをクリーンアップし、認識されたテキストを返す

よくある質問

リンクを解析できない

• リンクが有効な抖音の共有リンクであることを確認してください
• リンク形式は通常 https://v.douyin.com/xxxxx/ または完全な抖音ビデオ URL です

スクリプト抽出に失敗

• API_KEY 環境変数が設定されているか確認してください
• API キーが有効で、十分なクォータがあることを確認してください
• FFmpeg が正しくインストールされていることを確認してください

ダウンロード速度が遅い

• これはネットワーク条件とビデオサイズに依存します
• スクリプトはダウンロード進行状況を表示します

注意事項

• 本ツールは学習および研究目的のみです
• 使用する際は関連する法律および規制を遵守してください
• 著作権侵害または違法な目的での使用は禁止されています