yt-wrapper

Módulo TypeScript para integrar com a API usada pelo frontend do media.ytmp3.gg.

O que está pronto

• Cliente HTTP tipado
• Endpoints base integrados:
  • POST /extract
  • POST /convert
  • GET /check-task
• Fluxo completo com polling: convertByUrl(...)
• Tipagens para metadados, formatos e status da tarefa

Instalação

npm install @kaikybrofc/yt-wrapper

Build

npm run build

Exemplo rápido MP3

import { YtMediaClient } from "@kaikybrofc/yt-wrapper";

const client = new YtMediaClient();

const result = await client.convertToMp3("https://www.youtube.com/watch?v=dQw4w9WgXcQ", {
  preferredQuality: "128kbps"
});

console.log(result.task.downloadUrl);

Exemplo rápido MP4

import { YtMediaClient } from "@kaikybrofc/yt-wrapper";

const client = new YtMediaClient();

const result = await client.convertToMp4("https://www.youtube.com/watch?v=dQw4w9WgXcQ", {
  preferredQuality: "720p"
});

console.log(result.task.downloadUrl);

Observações

• Este wrapper foi iniciado com base no comportamento atual do frontend e pode mudar se a API mudar.
• Em alguns cenários o backend pode retornar captcha/jwt adicional.
• Use somente em contexto permitido pelos Termos de Uso e direitos autorais.