
Osintgram é uma ferramenta OSINT no Instagram. Oferece um shell interativo para realizar análises na conta do Instagram de qualquer usuário pelo seu apelido.
# Osintgram 🔎📸
[](doc/CHANGELOG.md)
[](LICENSE)
[](https://www.python.org/)
[](.github/workflows/tests.yml)
[](#quick-start)
**Aponte-o para uma conta do Instagram e descubra quem está por trás dela.** O Osintgram
coleta, faz referência cruzada e organiza tudo o que um perfil público revela
— seguidores, legendas, hashtags, locais com geolocalização, hábitos de postagem, dados
de contato públicos — em uma interface web que você executa na sua própria máquina.
Pergunte em linguagem natural e um **modelo de IA local** descobre quais consultas
executar. Ou não: escolha os comandos você mesmo e dispense o modelo por completo.
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/143/d6eaa19d795a604cab713f300cd9b5db4dce554bc604e3436a88d3d63e6f132b/6e4b370c0dd97191375d1281f84ddf2bc1653a0379d942b46787fd1ebe124ba0-display-v1.webp" width="900" alt="A interface web do Osintgram: o formulário de solicitação com uma folha de execução mostrando limites e custo, a resposta escrita e os resultados numerados com detalhes do perfil e hashtags">
</p>
---
## Por que você pode gostar
**Ele responde perguntas, não apenas comandos.** *"Quantos seguidores eles têm e quais
hashtags eles mais usam?"* executa três consultas e retorna com uma resposta escrita —
e os resultados brutos por baixo, para que você possa verificar o trabalho em vez de confiar
no texto.
**Nada sai da sua máquina, exceto as próprias consultas.** A IA é executada
localmente através do [Ollama](https://ollama.com): sem chave da OpenAI, sem assinatura, sem
prompt seu enviado a ninguém. A interface é servida a partir de `127.0.0.1`.
**Ele informa quanto custará uma pesquisa antes de você executá-la.** Os dados do Instagram
não são gratuitos, e a maioria das ferramentas deixa você descobrir isso da maneira cara. Esta
calcula o preço da sua seleção antecipadamente, mostra seu crédito restante, armazena em cache cada solicitação para que
você nunca pague duas vezes pela mesma consulta, e permite limitar ou interromper uma execução —
no lado do servidor, não apenas no navegador.
**Ele mostra o que encontrou, adequadamente.** Miniaturas de postagens em uma grade filtrável,
locais com geolocalização em um mapa, um mapa de calor de dia da semana × hora de quando alguém posta,
comparação entre duas contas. Não uma parede de JSON — embora o JSON esteja a um
clique de distância em cada cartão.
**Você pode entregar o resultado a outra pessoa.** Um botão transforma uma pesquisa concluída
em um relatório HTML autônomo que abre em qualquer navegador, sem servidor e sem
Osintgram.
---
## Duas maneiras de conduzi-lo
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/143/423f425ac28ff28e4a24bbfa2e327d0d6a7120758dcc141a88a05ee4dc244424/6c18229ce4134dc3117d01b134aab494b5c4e8f6e36d817b4cacd9abababebfc-display-v1.webp" width="860" alt="Modo base: 28 comandos em duas colunas, agrupados por cor e recolhíveis, com uma caixa de pesquisa e a folha de execução">
</p>
**Modo IA** — descreva o que você quer. Um modelo local escolhe os comandos, executa-os
e resume. Ele só pode escolher da mesma lista abaixo; não pode
inventar consultas ou fabricar dados.
**Modo base** — sem modelo, sem necessidade do Ollama. Todos os 29 comandos, um por linha,
agrupados e pesquisáveis. Marque o que você quer, defina os parâmetros, execute-os em
ordem.
Você também pode deixar o nome de usuário vazio no modo IA e apenas perguntar sobre uma hashtag
ou um local — essas pesquisas não pertencem a nenhuma conta.
---
## O que você pode descobrir
| | |
|---|---|
| **Perfil** | Bio e todos os links nela, contagens de seguidores/seguindo/publicações, categoria, e-mail público, telefone e endereço comercial até as coordenadas, id do Facebook vinculado — além do próprio *Sobre esta conta* do Instagram: país de registro, data de criação, quantas vezes o nome de usuário foi alterado |
| **Rede** | Seguidores e seguindo, contas que o Instagram sugere como relacionadas, quem os marcou, quem eles marcaram, quem mais comenta — e **conexões mútuas** entre duas contas |
| **Conteúdo** | Hashtags classificadas por uso, legendas, todos os comentários, estatísticas de curtidas e comentários, detalhamento de foto/vídeo/carrossel com visualizações e parcerias pagas, **mapa de calor de horários de publicação**, locais com geotag **em um mapa**, texto alternativo das fotos |
| **Contatos** | E-mails e números de telefone públicos entre os seguidores ou seguindo de um alvo |
| **Sem necessidade de alvo** | Publicações publicadas com uma **hashtag** (principais ou recentes) ou de um **local**, e quem as publicou — além de todos os **comentários em uma publicação ou reel específico**, dado seu URL, shortcode ou id |
Stories, destaques e fotos de perfil retornam como links diretos de CDN — e
qualquer cartão com mídia oferece um zip dos originais com um clique.
---
## Início rápido
```bash
pip install -r requirements.txt
uvicorn src.web.app:app --host 127.0.0.1 --port 8000 --reload # or: make run
```
Abra **<http://127.0.0.1:8000>**.
Você precisa de um backend de dados. A página abre em um painel onde você pode colar uma
chave do [HikerAPI](https://hikerapi.com) diretamente — ela é verificada antes de ser
aceita, e pode ser salva para a próxima vez. (Um login gratuito do
[instagrapi](https://github.com/subzeroid/instagrapi) também funciona, usando uma
conta do Instagram sua — consulte o guia para as vantagens e desvantagens.)
Para o modo de IA, instale o [Ollama](https://ollama.com/download) e baixe um
modelo com capacidade de chamada de ferramentas:
```bash
ollama pull llama3.1:8b # ~4.7 GB, the default
```
O modo base funciona sem ele.
Prefere contêineres?
```bash
docker compose up --build # or: make docker
```
Mesmo endereço, mesmo comportamento — publicado apenas em `127.0.0.1`. Sua chave, cache
e buscas salvas ficam no host em `config/`, `cache/` e `dossier/`,
nunca dentro da imagem. O modo de IA acessa um Ollama em execução no seu host.
> $${\color{red}Aviso:}$$ Isto é executado em `127.0.0.1` **sem autenticação**. Foi feito para rodar na sua própria máquina — não o exponha além do localhost sem antes colocar uma camada de autenticação na frente.
### 📖 [Leia o guia completo → `doc/web-ui.md`](https://github.com/datalux/osintgram/blob/master/doc/web-ui.md)
Configuração para ambos os backends, cada comando com seus parâmetros e custo, como
manter os gastos baixos, exportar e compartilhar resultados, todas as opções de configuração,
e solução de problemas.
---
## Antes de usar
**APENAS PARA FINS EDUCACIONAIS.** Os contribuidores não assumem qualquer
responsabilidade pelo uso desta ferramenta.
- **Não use sua própria conta do Instagram ou sua conta principal** com ela.
- **Nunca faça commit de `config/credentials.ini`** — chaves de API e credenciais
do Instagram ficam lá. Está no git-ignore; mantenha assim. Se uma chave já
foi enviada, rotacione-a: excluir o arquivo não o remove do histórico.
- Os resultados contêm dados pessoais de outras pessoas. Trate-os em conformidade com
a legislação de proteção de dados (GDPR e equivalentes) e os Termos de Uso do Instagram.
- Você não consegue ver perfis privados. Nada consegue. Ferramentas que afirmam o contrário são
golpes.
---
## Desenvolvimento
```bash
pip install -r requirements-dev.txt
python -m pytest
```
A suíte de testes é executada inteiramente com fixtures sintéticas — sem chave de API, sem cota, sem rede. Ela também verifica se a documentação não se desviou do código.
Solicitações de recursos e pull requests são bem-vindos — abra uma issue. Encontrou um problema de segurança? Por favor, reporte-o de forma privada: consulte [SECURITY.md](https://github.com/datalux/osintgram/blob/master/SECURITY.md).
---
## Créditos
Osintgram é escrito por **Giuseppe Criscione**
([Datalux](https://github.com/Datalux)). A versão 2.0 o reconstrói em torno de uma interface web e de uma camada de serviço reutilizável, e adiciona o modo de IA, os controles de custo e as análises mais recentes — consulte o [changelog](https://github.com/datalux/osintgram/blob/master/doc/CHANGELOG.md).
Deve muito a todos que contribuíram desde o primeiro lançamento:
<a href="https://github.com/Datalux/Osintgram/graphs/contributors">
<img src="https://contributors-img.web.app/image?repo=Datalux/Osintgram" alt="Osintgram contributors">
</a>
Os dados do Instagram vêm do [HikerAPI](https://hikerapi.com) ou do
[instagrapi](https://github.com/subzeroid/instagrapi). Geocodificação por
[Nominatim](https://nominatim.org) / [OpenStreetMap](https://www.openstreetmap.org/copyright).
Mapas por [Leaflet](https://leafletjs.com). Modelos locais via
[Ollama](https://ollama.com).
Lançado sob a licença [GPL-3.0](https://github.com/datalux/osintgram/blob/master/LICENSE).
Instagram é uma marca registrada da Meta Platforms, Inc. Este projeto não é afiliado, endossado ou aprovado pela Meta.Descubra as ferramentas mais usadas pela nossa comunidade.
Sem dados de popularidade ainda.