init: scripts diversos (crawlers, conversores, scrapers)

tts-generator/README_OPENAI.md

@@ -0,0 +1,74 @@
+# Gerador de Voz OpenAI TTS - Descomplicar
+
+## 🎯 Configuração Automática OpenAI
+
+Configurar API key no ficheiro `.env` antes de usar.
+
+## Execucao
+
+### **Opcao 1 - Script Automatico:**
+```bash
+chmod +x run_openai_tts.sh
+./run_openai_tts.sh
+```
+
+### **Opcao 2 - Manual:**
+```bash
+source venv/bin/activate
+source .env
+pip install openai
+python openai_tts.py
+```
+
+## 🎙️ Funcionalidades
+
+### **Vozes Disponíveis:**
+- **nova**: Feminina, natural (recomendada)
+- **alloy**: Neutra
+- **echo**: Masculina 
+- **fable**: Brit, masculina
+- **onyx**: Masculina, profunda
+- **shimmer**: Feminina, suave
+
+### **Modelos:**
+- **tts-1**: Rápido e eficiente
+- **tts-1-hd**: Alta qualidade (recomendado)
+
+### **Formatos:**
+- **MP3**: Compacto (padrão)
+- **WAV**: Sem compressão
+- **FLAC**: Alta qualidade
+
+## 📊 Vantagens OpenAI TTS
+
+✅ **Qualidade consistente**
+✅ **API estável e confiável** 
+✅ **Sem problemas de quota complexos**
+✅ **Suporte excelente para português**
+✅ **Pricing transparente**
+✅ **Velocidade de processamento**
+
+## 🎵 Ficheiros Gerados
+
+- `descomplicar_teste.mp3` - Teste rápido
+- `descomplicar_marketing_digital.mp3` - Áudio completo
+
+## 💡 Uso no Projeto
+
+Ideal para:
+- **Podcasts** da Descomplicar
+- **Conteúdo de redes sociais**
+- **Narração de vídeos**
+- **Acessibilidade** de artigos
+- **Apresentações** automáticas
+
+## ⚡ Execução Rápida
+
+O script permite escolher:
+- **(t)este** - Texto pequeno, geração rápida
+- **(c)ompleto** - Artigo inteiro sobre Marketing Digital
+
+**Execute agora:**
+```bash
+./run_openai_tts.sh
+```