Douyin Downloader V2.0: La Guía Completa para Descargar en Lote Contenido de TikTok Chino

¿Qué es Douyin Downloader?

Douyin Downloader V2.0 es una potente herramienta de Python de código abierto diseñada para descargar en lote contenido de Douyin (TikTok de China). Con 7.2k estrellas en GitHub y desarrollo activo, esta herramienta soporta descargas de videos, notas de imágenes, colecciones, música, favoritos y perfiles completos – todo sin marcas de agua.

Características Principales

✅ Soporte multi-formato: Videos, notas de imágenes, colecciones, música, favoritos ✅ Sin marcas de agua: Selecciona automáticamente fuentes de video limpias ✅ Descargas de perfil en lote: Publicaciones, likes, mixes, música de cualquier usuario ✅ Fallback del navegador: Maneja bloqueos de paginación con soporte manual para CAPTCHA ✅ Deduplicación SQLite: Nunca descarga duplicados en todos los modos ✅ Descargas concurrentes: Hilos configurables (predeterminado 5) ✅ Barras de progreso: Visualización rica del progreso con modo silencioso ✅ Lógica de reintentos: Retroceso exponencial (1s, 2s, 5s) ✅ Listo para Docker: Despliegue con un solo comando ✅ Transcripción de video: Integración opcional con OpenAI Whisper ✅ Descargas incrementales: Reanuda donde lo dejaste ✅ Filtrado por tiempo: Descarga por rango de fechas

Inicio Rápido (5 Minutos)

# 1. Clonar e instalar
pip install -r requirements.txt

# 2. Copiar config
cp config.example.yml config.yml

# 3. Capturar cookies automáticamente
python -m tools.cookie_fetcher --config config.yml

# 4. ¡Ejecutar!
python run.py -c config.yml

Ejemplo de Configuración Mínima

link:
  - https://www.douyin.com/user/MS4wLjABAAAAxxxx
path: ./Downloaded/
mode:
  - post
  - like
thread: 8
database: true
browser_fallback:
  enabled: true
  headless: false

Casos de Uso del Mundo Real

1. Archivo de Creadores

Descarga todas las publicaciones + likes de tus creadores favoritos:

mode: [post, like]
number:
  post: 0  # ilimitado
  like: 0

2. Colección de Música

Extrae pistas de audio originales:

link: https://www.douyin.com/music/7341234567890123456

3. Conjunto de Datos de Investigación

Crawl completo de perfil con transcripción:

mode: [post, like, mix]
transcript:
  enabled: true
  model: gpt-4o-mini-transcribe

Características Avanzadas

Deduplicación entre Modos

El mismo aweme_id no se descargará dos veces entre modos post/like/mix.

Fallback del Navegador

Cuando las APIs bloquean la paginación (común después de ~20 publicaciones), lanza automáticamente el navegador para desplazamiento manual + resolución de CAPTCHA.

Estructura de Salida

Downloaded/
└── AuthorName/
    ├── post/
    │   └── 2024-02-07_Title_aweme123/
    │       ├── video.mp4
    │       ├── cover.jpg
    │       ├── music.mp3
    │       ├── data.json
    │       └── transcript.txt
    ├── like/
    └── mix/

Despliegue con Docker

docker build -t douyin-downloader .
docker run -v $(pwd)/config.yml:/app/config.yml -v $(pwd)/Downloaded:/app/Downloaded douyin-downloader

Solución de Problemas

"¿Solo se descargaron 20 publicaciones?"

browser_fallback:
  enabled: true
  headless: false  # Verificación manual necesaria

"¿Cookies caducadas?"

python -m tools.cookie_fetcher --config config.yml

¿Por Qué Elegir Esta Herramienta?

• Lista para producción: CI/CD, pruebas exhaustivas
• Mantenida activamente: Commits recientes (Mar 2026)
• Completa en funciones: Maneja casos extremos que otras herramientas omiten
• Licencia MIT: Gratis para uso personal/comercial

⚠️ Descargo de Responsabilidad Legal

Solo para archivo personal, investigación y aprendizaje. Respeta los ToS de la plataforma, derechos de autor y privacidad.

GitHub: jiji262/douyin-downloader

⭐ Dale estrella si te fue útil!