Транскрибация ссылок Douyin и подготовка текста для озвучки

Автоматически извлекает медиаданные по ссылкам Douyin, формирует транскрипцию на вашем компьютере, а затем превращает её в готовый текст для озвучки.

Этот проект продолжает развитие yzfly/douyin-mcp-server; сохраняется лицензия Apache-2.0 исходного проекта.

✨ Возможности

• 🎬 Видео без водяного знака — получение ссылки на скачивание качественного видео без водяного знака

• 🛟 Автоматическое переключение — при сбое HTTP-разбора используется общий Playwright для получения подписанного аудио

• 🎙️ Локальное распознавание речи — faster-whisper-medium / CPU int8, без затрат на облачные ASR API

• ✍️ Обработка текста для озвучки — DeepSeek убирает повторы, восстанавливает пунктуацию и структуру, сохраняя исходный смысл

• 🌐 WebUI — современный интерфейс в браузере, без работы с командной строкой

• 🔌 Интеграция MCP — поддержка для AI-приложений, таких как Claude Desktop

Related MCP server: Douyin Video Analysis MCP

Структура проекта

assets/                 预览图和发布用 skill 包
douyin_mcp_server/      Python 核心包
scripts/                命令行入口
skills/douyin-video/    可复用的工作流说明
tests/                  单元测试
web/                    FastAPI WebUI

📦 Способы использования

🌐 WebUI (рекомендуется)

Самый простой способ — открыть браузер и работать.

Быстрый старт

# 1. 克隆你自己的仓库
git clone <your-repository-url>
cd douyin-mcp-server

# 2. 安装依赖
uv sync --extra web

# 3. 启动服务
uv run python web/app.py

Откройте браузер и перейдите по адресу http://localhost:8080.

Настройка API-ключа DeepSeek

Есть два способа задать API-ключ:

Способ 1: настройка в браузере

1. Откройте страницу WebUI.

2. Нажмите на кнопку «API не настроен» в верхней части страницы.

3. Во всплывающем окне введите API-ключ и сохраните его.

4. API-ключ хранится локально в браузере и отправляется только локальному сервису вместе с запросом на извлечение.

Способ 2: переменные окружения

export DOUYIN_DEEPSEEK_API_KEY="<your-deepseek-api-key>"
uv run python web/app.py

Для локального ASR ключ не требуется; ключ DeepSeek используется только на последнем шаге — подготовке текста для озвучки.

Описание функций

Шаги использования

1. Вставьте ссылку — вставьте ссылку из публикации в поле ввода.

2. Нажмите кнопку — выберите «Получить информацию» или «Извлечь текст».

3. Посмотрите результат — справа отображаются информация о видео и извлечённый текст.

4. Экспорт — скопируйте текст или скачайте файл Markdown.

🚀 MCP Server

Используйте в приложениях, поддерживающих MCP: Claude Desktop, Cherry Studio и других.

Настройка

Отредактируйте конфигурационный файл MCP и добавьте:

{
  "mcpServers": {
    "douyin-mcp": {
      "command": "uvx",
      "args": ["douyin-mcp-server"],
      "env": {
        "DOUYIN_DEEPSEEK_API_KEY": "<your-deepseek-api-key>"
      }
    }
  }
}

DOUYIN_DEEPSEEK_API_KEY размещается только в окружении запуска; не записывайте его в репозиторий, выходные файлы или отчёт о запуске.

Доступные инструменты

Пример диалога

用户：帮我提取这个视频的文案 https://v.douyin.com/xxxxx/

Claude：我来帮你提取视频文案...
[调用 extract_douyin_text 工具]
提取完成，文案内容如下：
...

🛠️ Инструмент командной строки

Подходит для разработчиков и сценариев пакетной обработки.

Установка

git clone https://github.com/yzfly/douyin-mcp-server.git
cd douyin-mcp-server
uv sync

Описание команд

# 查看帮助
uv run python scripts/douyin_downloader.py --help

# 获取视频信息（无需 API）
uv run python scripts/douyin_downloader.py -l "分享链接" -a info

# 下载无水印视频
uv run python scripts/douyin_downloader.py -l "分享链接" -a download -o ./videos

# 提取文案（本地 ASR；整理阶段需要 DOUYIN_DEEPSEEK_API_KEY）
export DOUYIN_DEEPSEEK_API_KEY="<your-deepseek-api-key>"
uv run python scripts/douyin_downloader.py -l "分享链接" -a extract -o ./output

Формат вывода

output/
└── 7600361826030865707/
    ├── audio.m4a          # 已校验的完整音频
    ├── transcript-raw.md  # 本地 ASR 原始逐字稿
    ├── copy.md            # DeepSeek 整理后的口播
    ├── metadata.json
    └── run-report.json    # 五阶段状态和验证证据

📋 Системные требования

🔧 Технические особенности

Фиксированный рабочий процесс

1. HTTP разбирает ссылку из публикации; при сбое автоматически переключается на Playwright.

2. В ветке HTTP скачивается видео; в браузерной ветке по Range скачивается подписанное аудио.

3. В ветке HTTP звук извлекается с помощью FFmpeg; в браузерной ветке ffprobe проверяет полноту аудио.

4. Локальный faster-whisper-medium / CPU int8 создаёт транскрипцию с таймкодами.

5. DeepSeek приводит текст к формату для озвучки и записывает результат в run-report.json.

📝 Журнал изменений

v1.5.0 (текущая версия рабочей станции)

• При сбое HTTP-разреса происходит автоматический переход на общий Playwright.

• Используется локальный faster-whisper-medium / CPU int8, ASR больше не зависит от облачного API.

• DeepSeek V4 Flash используется для подготовки текста для озвучки.

• Зафиксированы выходные данные: аудио, исходная транскрипция, подготовленный текст, метаданные и отчёт о запуске.

v1.4.1

• 🔧 Исправление MCP Server — API_KEY теперь корректно соответствует ключу сервиса 硅基流动, как и в документации; сохранена совместимость со старой конфигурацией DASHSCOPE_API_KEY.

• ♻️ Восстановлены инструменты — возвращены recognize_audio_file / recognize_audio_url и параметр context из extract_douyin_text.

• 🛡️ Усиление безопасности WebUI — интерфейс загрузки больше не проксирует произвольные URL; по умолчанию прослушивается только локальная машина.

• ⚡ Производительность WebUI — извлечение текста больше не блокирует другие запросы.

• 📦 Сокращение зависимостей — зависимости WebUI стали опциональными (pip install "doujin-mcp-server[web]").

v1.4.0

• 🌐 WebUI — добавлен визуальный интерфейс в браузере.

• 🔑 Настройка API-ключа в браузере — не требуются переменные окружения.

• 📑 Поддержка больших файлов — длинные аудио автоматически обрабатываются частями.

v1.3.0

• ✨ Поддержка Claude Code Skill.

• 📄 Вывод в формате Markdown.

v1.2.0

• 🔄 Обновление API.

v1.0.0

• 🎉 Первый выпуск.

⚠️ Отказ от ответственности

• Этот проект предназначен только для обучения и исследований.

• Пользователи обязаны соблюдать применимое законодательство.

• Запрещено использовать проект для нарушений прав интеллектуальной собственности.

• Автор не несёт ответственности за убытки, возникающие при использовании проекта.

📄 Лицензия

Apache License 2.0

🤝 Вклад

Перед отправкой Issue или Pull Request прочтите CONTRIBUTING.md. О проблемах безопасности сообщайте приватно в соответствии с SECURITY.md.

Перед публикацией в свой репозиторий GitHub укажите адрес вашего репозитория в project.urls файла pyproject.toml и при необходимости измените название проекта и информацию об авторе.

Исходный источник

Автор оригинального проекта: yzfly (GitHub).