Instaloader Bot: Automatize o Download de Perfis do Instagram com Python e Docker

Em projetos que envolvem análise de redes sociais, especialmente Instagram, obter dados de forma automatizada é essencial para agilidade e escala. Foi com esse objetivo que desenvolvemos o Instaloader Bot, uma solução robusta em Python que facilita o download completo de perfis do Instagram, incluindo stories, highlights, vídeos e fotos, além de exportação de metadados para CSV e banco de dados SQLite.

Este projeto faz parte do nosso portfólio de automações personalizadas aqui na Ad Rock Digital Mkt, e está disponível publicamente no GitHub para qualquer pessoa utilizar ou contribuir.

Tecnologias Utilizadas

• Linguagem principal: Python 3.10+

• Biblioteca base: Instaloader

• Exportação de dados: CSV e SQLite

• Execução automatizada: GitHub Actions

• Ambiente isolado: Docker + Docker Compose

• Interface de execução: CLI via argparse

• Execução facilitada no macOS: Script .command

Funcionalidades do Instaloader Bot

✅ Suporte a perfis públicos e privados (via login com credenciais)

✅ Download de:

• Foto de perfil

• Todos os posts (imagens e vídeos)

• Stories ativos

• Highlights

✅ Exportação completa de metadados:

• Em formato CSV para análise posterior

• Em banco de dados SQLite para integrações e visualizações personalizadas

✅ Interface CLI simples e prática

✅ Script .command para execução por clique no macOS

✅ Containerização via Docker (isolamento, replicabilidade)

✅ GitHub Actions com CI para builds automáticos, linting e testes

📁 Estrutura do Projeto

instaloader-bot/
├── cli.py                       # Entrada principal do script
├── csv_exporter.py              # Exportador de metadados para CSV
├── db_exporter.py               # Exportador de dados para SQLite
├── instaloader_rodar.command    # Execução facilitada no macOS
├── downloads/                   # Pasta de saída dos arquivos
├── .github/workflows/           # Integração contínua (CI) com GitHub Actions
├── Dockerfile
├── docker-compose.yml
├── requirements.txt
└── .env.example

 Como Usar

1. Clonar o repositório

git clone https://github.com/adrockmkt/instaloader-bot.git
cd instaloader-bot

2. Instalar dependências

pip install -r requirements.txt

3. Criar o .env com credenciais do Instagram

IG_USERNAME=seu_usuario
IG_PASSWORD=sua_senha

4. Executar via terminal:

python cli.py --target @perfil --login --stories --highlights --csv --db

5. Executar no macOS com 2 cliques:

chmod +x instaloader_rodar.command

Depois, clique duas vezes no Finder.

6. Rodar com Docker:

docker compose up

Contribuições Futuras

• Exportação direta para Google Sheets ou Notion

• Scheduler com painel Flask

• Integração com Zapier ou Make para automações

• Integração com dashboards de monitoramento social

Sobre o Projeto

O Instaloader Bot é uma das automações desenvolvidas pela Ad Rock para facilitar tarefas repetitivas com dados sociais. Ele pode ser útil para:

• Jornalistas e analistas de mídia

• Agências de marketing

• Pesquisadores acadêmicos

• Profissionais de monitoramento digital

Feito com ❤️ por Rafael Marques Lins – Ad Rock Digital Mkt