# ytdownload

**@mashakujou/ytdownload**  
Módulo de Node.js para descargar contenido de YouTube en formatos como MP3, MP4, M4A o WEBM.  
Ideal para scripts personalizados, integraciones con bots o utilidades backend.

---

## ?? Instalación

Desde npm:

```bash
npm install @mashakujou/ytdownload
```

---

## ⚙️ Requisitos

- Node.js v16 o superior  
- Archivo `cookies.txt` en formato Netscape  
- Conexión válida a YouTube sin bloqueo regional o CAPTCHA

---

## ⚠️ Advertencia sobre cookies

Para evitar errores como 403 o bloqueos por verificación de bots, **debes reemplazar** el archivo `cookies.txt` por tus propias cookies exportadas del navegador.  
Puedes usar extensiones como: [Get cookies.txt](https://chrome.google.com/webstore/detail/get-cookiestxt/).

Ubica el archivo `cookies.txt` en la raíz del proyecto.

Después de agregarlo, se recomienda ejecutar:

```bash
node correct.js
```

Esto limpia espacios innecesarios y evita errores.

---

## ✅ Uso

```js
import { downloadYouTube } from '@mashakujou/ytdownload'

const url = 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
const formato = 'mp3' // También puedes usar: 'mp4', 'm4a', 'webm'

downloadYouTube(url, formato)
  .then((archivo) => console.log(`Descargado: ${archivo}`))
  .catch((err) => console.error('Error:', err))
```

---

##  Estructura

Este paquete incluye:

- `index.js`: función principal de descarga
- `cookies.txt`: archivo requerido (debes reemplazarlo por el tuyo)
- `correct.js`: limpia y corrige el archivo `cookies.txt`

---

##  Licencia

MIT © mashakujou