Alauda SDK

SDK oficial em JavaScript/TypeScript para a Alauda API - API Moçambicana para download de mídia social.

🚀 Características

• ✅ Suporte completo a TypeScript
• ✅ Autocomplete e intellisense
• ✅ Tratamento de erros integrado
• ✅ Suporte a Node.js e navegadores
• ✅ Documentação inline
• ✅ Promise-based (async/await)

📦 Instalação

npm install alauda-sdk

🔑 Obter API Key

Crie sua conta gratuitamente em alauda-api.topaziocoin.online/dashboard e obtenha sua API Key.

📖 Uso Básico

const { AlaudaClient } = require('alauda-sdk');

const alauda = new AlaudaClient({
  apiKey: 'sua_api_key_aqui'
});

// Download de vídeo do TikTok
const video = await alauda.tiktok.download('https://www.tiktok.com/@user/video/123');
console.log(video.data.download.no_watermark);

📚 Exemplos

TikTok Download

const resultado = await alauda.tiktok.download('URL_DO_TIKTOK');

console.log('Título:', resultado.data.title);
console.log('Autor:', resultado.data.author.nickname);
console.log('Download HD:', resultado.data.download.no_watermark);
console.log('Créditos restantes:', resultado.credits_remaining);

Instagram Download

const resultado = await alauda.instagram.download('URL_DO_INSTAGRAM');

console.log('URL do arquivo:', resultado.data.download.no_watermark);
console.log('Créditos restantes:', resultado.credits_remaining);

YouTube Download

const resultado = await alauda.youtube.download('URL_DO_YOUTUBE');

console.log('Título:', resultado.data.title);
console.log('Download HD:', resultado.data.download.video_hd);
console.log('Áudio:', resultado.data.download.audio);

Spotify Download

const resultado = await alauda.spotify.download('URL_DO_SPOTIFY');

console.log('Música:', resultado.data.title);
console.log('Artista:', resultado.data.artist);
console.log('Download:', resultado.data.download);

Buscar Letra de Música

const resultado = await alauda.lyrics('Imagine Dragons', 'Believer');

console.log('Letra:', resultado.data.lyrics);
console.log('Metadata:', resultado.data.metadata);

Shazam (Identificar Música)

// A partir de um arquivo local
const resultado = await alauda.shazam('./audio.mp3');

// A partir de um Buffer
const fs = require('fs');
const buffer = fs.readFileSync('./audio.mp3');
const resultado = await alauda.shazam(buffer);

console.log('Música:', resultado.data.track.title);
console.log('Artista:', resultado.data.track.artist);

🛠️ API Reference

AlaudaClient

new AlaudaClient(config: AlaudaConfig)

Parâmetros:

• apiKey (string, obrigatório): Sua API key da Alauda
• baseURL (string, opcional): URL base da API (default: https://alauda-api.topazioverse.com.br)

Endpoints Disponíveis

TikTok

• tiktok.download(url: string) - Baixa vídeo do TikTok
• tiktok.infoOnly(url: string) - Obtém apenas informações (consome menos créditos)

Instagram

• instagram.download(url: string) - Baixa posts do Instagram
• instagram.infoOnly(url: string) - Obtém apenas informações

YouTube

• youtube.download(url: string) - Baixa vídeos do YouTube
• youtube.infoOnly(url: string) - Obtém apenas informações

Spotify

• spotify.download(url: string) - Baixa músicas do Spotify

Lyrics

• lyrics(artist: string, title: string) - Busca letra de música

Shazam

• shazam(source: string | File | Buffer) - Identifica música de arquivo de áudio

Facebook

• facebook(url: string) - Baixa vídeos do Facebook

🛡️ WhatsApp Anti-Mention

Proteção automática contra usuários que marcam o grupo no status.

Ativar Grupo

const ativacao = await alauda.whatsapp.activate(
  '[email protected]',
  'Nome do Grupo',
  '258123456789'
);

console.log(ativacao);
// {
//   success: true,
//   message: '✅ Grupo ativado com sucesso!',
//   credits_available: 1000,
//   cost_per_operation: 50
// }
Usar no Bot
const { makeWASocket } = require('@whiskeysockets/baileys');
const { AlaudaClient } = require('alauda-sdk');

const sock = makeWASocket({ /* ... */ });

const alauda = new AlaudaClient({
  apiKey: 'alauda_live_sua_key'
});

sock.ev.on('messages.upsert', async ({ messages }) => {
  for (const msg of messages) {
    const from = msg.key.remoteJid;
    
    // Detecta e remove automaticamente
    await alauda.whatsapp.antiMention(msg, from, sock);
  }
});
Funcionalidades
✅ Detecção automática de status mentions
✅ Proteção para admins do grupo
✅ Remoção automática de infratores
✅ Sistema de créditos integrado
✅ Logs detalhados
Custos
Ativação: Grátis
Cada remoção: 50 créditos

## 💰 Sistema de Créditos

Cada requisição consome créditos da sua conta:

| Endpoint | Créditos |
|----------|----------|
| TikTok Download | 100 |
| Instagram Download | 100 |
| YouTube Download | 200 |
| Spotify Download | 100 |
| Lyrics | 50 |
| Shazam | 150 |
| Facebook | 100 |

**10.000 requests = 100 MT (R$ 10)**

## 🔒 Tratamento de Erros

O SDK lança erros descritivos para facilitar o debug:

```javascript
try {
  const resultado = await alauda.tiktok.download('URL_INVALIDA');
} catch (error) {
  console.error('Erro:', error.message);
  // Possíveis erros:
  // - "API Key inválida ou ausente"
  // - "Créditos insuficientes"
  // - "Endpoint não encontrado"
  // - "Rate limit excedido"
}

📝 TypeScript

O SDK possui suporte completo a TypeScript com tipos incluídos:

import { AlaudaClient, VideoResponse } from 'alauda-sdk';

const alauda = new AlaudaClient({ apiKey: 'sua_key' });

const video: VideoResponse = await alauda.tiktok.download('URL');

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests.

📄 Licença

MIT © Habibo Salimo Julio

🔗 Links

• Website da API
• Documentação Completa
• GitHub
• NPM

💬 Suporte

• WhatsApp: +258 86 284 0075
• Email: [email protected]

Desenvolvido com ❤️ por Habibo Salimo Julio em Moçambique 🇲🇿