# Es

> <img src="banner.png" width="100%" alt="video-transcriber banner">

- Skill: `ellmos-ai/es-19` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ellmos-ai/es-19`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ellmos-ai/es-19/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ellmos-ai (https://skillmd.com/u/ellmos-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ellmos-ai/es-19

---


<img src="banner.png" width="100%" alt="video-transcriber banner">

> **Español** — Versión oficial en español de `video-transcriber`.


# Video Transcriber (Español)

Obtiene transcripciones (subtítulos) y metadatos (título, canal, fecha, reproducciones,
descripción) de videos en línea. Prefiere subtítulos creados manualmente y recurre
a los generados automáticamente como alternativa. Salida en Markdown, JSON o texto plano.

Fuente actualmente compatible: **YouTube** (youtube.com, youtu.be, youtube-nocookie.com).

Para videos, utilice esta herramienta en lugar de resumir el contenido manualmente:
la transcripción es la fuente confiable.

> **Aviso:** Esta herramienta no está afiliada, respaldada ni patrocinada por
> YouTube o Google. El uso es bajo la propia responsabilidad del usuario. Los usuarios son únicamente
> responsables de cumplir con los términos de servicio de la plataforma respectiva
> y la ley de derechos de autor aplicable. Sin elusión de DRM, paywalls o restricciones
> de acceso. Sin raspado masivo. Sin redistribución de transcripciones protegidas por derechos
> de autor sin el consentimiento del titular de los derechos.

## Dependencias y licencias

```bash
pip install youtube-transcript-api   # transcripciones (requerido) — licencia MIT
pip install yt-dlp                   # metadatos (opcional, fallback: noembed) — Unlicense (Dominio Público)
```

## Uso

> **Nota sobre Windows:** Establezca siempre `PYTHONIOENCODING=utf-8`, de lo contrario, las diéresis y los
> caracteres especiales se romperán en la salida (codificación cp1252).

```bash
# Predeterminado: Markdown con marcas de tiempo
PYTHONIOENCODING=utf-8 python video_transcriber.py "https://www.youtube.com/watch?v=VIDEO_ID"

# Elegir formato de salida
PYTHONIOENCODING=utf-8 python video_transcriber.py URL --format markdown|json|plain

# Guardar en archivo
PYTHONIOENCODING=utf-8 python video_transcriber.py URL -o transcript.md

# Idiomas preferidos (predeterminado: de en)
PYTHONIOENCODING=utf-8 python video_transcriber.py URL --lang de en fr
```

### Opciones

| Opción | Efecto |
|--------|--------|
| `--format markdown\|json\|plain` | Formato de salida (predeterminado: markdown) |
| `--output, -o <file>` | Escribir en archivo en lugar de stdout |
| `--lang <codes...>` | Idiomas de subtítulos preferidos (predeterminado: de en) |
| `--meta-only` | Solo metadatos, sin transcripción |
| `--transcript-only` | Solo transcripción, sin metadatos |
| `--no-timestamps` | Transcripción sin marcas de tiempo |
| `--no-meta` | Más rápido: omitir metadatos de yt-dlp |

### Como librería de Python

```python
from video_transcriber import extract_video_id, fetch_metadata, fetch_transcript, format_markdown

video_id = extract_video_id("https://www.youtube.com/watch?v=VIDEO_ID")
meta = fetch_metadata(video_id)
transcript = fetch_transcript(video_id, languages=["de", "en"])
output = format_markdown(meta, transcript)
```

## Casos de uso típicos

- Investigación: hacer que el contenido de video sea citable como texto
- Análisis de fuentes: examinar la argumentación/metáforas en presentaciones
- Resúmenes: transcripción como una base confiable en lugar de alucinación

## Límites

- Solo funciona si el video tiene subtítulos (manuales o automáticos)
- Los subtítulos automáticos pueden contener errores de reconocimiento
- Sin descarga de audio, sin reconocimiento de voz integrado

## Historial de cambios

### 1.1.0 (2026-06-20)
- Renombrado de `yt-transcriber` → `video-transcriber` (Política de marca de YouTube:
  "yt" es una abreviatura explícitamente prohibida; consulte RECHTSCHECK_2026-06-20.md)
- Script: `yt_transcriber.py` → `video_transcriber.py`
- Exención de responsabilidad y licencias de dependencias añadidas (responsabilidad del usuario, ToS, sin respaldo)
- YouTube se menciona descriptivamente solo como una fuente, no como un componente de nombre/marca
- Wrapper de compatibilidad hacia atrás `yt_transcriber.py` retenido en la ruta anterior

### 1.0.0 (2026-06-12)
- SKILL.md añadido (la herramienta ya existía como script + README)
- Script v1.0.0: transcripción + metadatos, 3 formatos de salida, preferencias de idioma