InstaVault

Extrator de Mídia Pública do Instagram

Vibecoded with ❤️

---

📖 Sobre

InstaVault é uma ferramenta para extrair fotos e vídeos de posts públicos do Instagram, sem necessidade de login. Ideal para arquivamento, pesquisa ou backup de conteúdo próprio.

⚠️ Aviso legal: Esta ferramenta deve ser usada apenas para conteúdo público e respeitando os termos de uso do Instagram. Não nos responsabilizamos pelo uso indevido.

✨ Features

• 📸 Fotos - Extrai imagens em alta resolução de posts públicos
• 🎬 Vídeos & Reels - Download via yt-dlp (mais confiável)
• 🎠 Carrosséis - Suporta posts com múltiplas mídias
• 🌐 Interface Web - UI simples e funcional
• 🔌 API REST - Integração com outros sistemas
• 🐳 Docker Ready - Deploy em um comando

🚀 Quick Start

Usando Docker (Recomendado)

# Clone o repositório
git clone https://github.com/cirokk/insta-vault.git
cd insta-vault

# Build e run
docker build -t insta-vault .
docker run -d -p 3219:3219 --name insta-vault insta-vault

# Acesse
open http://localhost:3219

Docker Compose

docker-compose up -d

Desenvolvimento Local

# Instale as dependências
npm install

# Instale yt-dlp (necessário para Reels)
# Ubuntu/Debian: sudo apt install yt-dlp
# macOS: brew install yt-dlp

# Execute
npm start

📡 API

Extrair Mídia

POST /api/fetch
Content-Type: application/json

{
  "url": "https://www.instagram.com/p/XXXXXXXXXX/"
}

Resposta:

{
  "success": true,
  "media": [
    {
      "type": "image",
      "url": "https://...",
      "filename": "post_1.jpg"
    }
  ]
}

Download Direto

GET /api/download?url=<media_url>&filename=<nome>

🛠️ Stack

Tecnologia	Propósito
Node.js + Express	Backend server
Playwright	Navegação headless
yt-dlp	Extração de vídeos

⚙️ Configuração

Variável	Default	Descrição
PORT	3219	Porta do servidor

🚧 Limitações Conhecidas

• ✅ Apenas posts públicos (requer login para privados)
• ✅ Reels requer yt-dlp instalado no container/host
• ✅ Rate limiting do Instagram pode bloquear uso excessivo
• ✅ Stories não são suportados

🤝 Contribuindo

Contribuições são bem-vindas! Por favor:

1. Fork o projeto
2. Crie sua branch (git checkout -b feature/nova-feature)
3. Commit suas mudanças (git commit -m 'Adiciona nova feature')
4. Push para a branch (git push origin feature/nova-feature)
5. Abra um Pull Request

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

---

Vibecoded - Desenvolvido com ajuda de IA para automatizar tarefas do dia-a-dia.

Se este projeto foi útil, deixe uma ⭐ no repositório!