TikTok Hashtag Scraper

Script em Python para coletar links de vídeos do TikTok a partir de uma hashtag.

🚀 Como funciona

• Acessa a página da hashtag no TikTok (https://www.tiktok.com/tag/)
• Extrai os links de vídeos associados
• Salva em um arquivo outputs/results.txt

📋 Pré-requisitos

• Python 3.9+
• Pacotes do requirements.txt

Instale com:

pip install -r requirements.txt

🛠️ Instruções de Uso

1. Clone este repositório:

git clone https://github.com/AdRockers/tiktok_hashtag_scraper.git
cd tiktok_hashtag_scraper

2. Instale as dependências:

pip install -r requirements.txt

3. Execute o script passando a hashtag desejada como argumento:

python scraper.py --hashtag nomeDaHashtag

4. Os links dos vídeos serão salvos no arquivo outputs/results.txt.

📂 Exemplo de Saída

https://www.tiktok.com/@usuario/video/1234567890
https://www.tiktok.com/@outro_usuario/video/0987654321
https://www.tiktok.com/@exemplo/video/1122334455

✨ Funcionalidades Atuais

• Login persistente no TikTok usando tiktok_state.json.
• Coleta de links de vídeos de uma hashtag específica.
• Armazena resultados em outputs/results.txt.
• Gera debug em outputs/debug_rendered.html para inspeção do HTML.

🚧 Futuro / Roadmap

• Exportar resultados também em CSV e JSON com metadados (views, likes, usuário).
• Permitir múltiplas hashtags em um único arquivo de entrada.
• Configuração de limite customizável de vídeos (ex.: --limit 50).
• Agendamento de execuções automáticas (cron jobs ou GitHub Actions).
• Versão avançada para baixar todos os thumbnails (alta, média e baixa resolução) para comparação.

⚠️ Observações e Limitações

• O scraper depende da estrutura atual do site do TikTok, que pode mudar e quebrar o funcionamento do script.
• O TikTok pode impor limitações de acesso ou bloqueios para requisições automatizadas.
• Recomenda-se usar com moderação para evitar bloqueios temporários.
• Não coleta vídeos privados ou restritos.

🤝 Contribuição

Contribuições são bem-vindas! Por favor, leia nosso guia de contribuição antes de enviar pull requests:

CONTRIBUTING.md

📄 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

📞 Contato

Para dúvidas, sugestões ou suporte, entre em contato:

• Site: https://adrock.com.br
• Email: rafael@adrock.com.br