🕷️ TGSpyder

TGSpyder é uma ferramenta CLI de OSINT para Telegram de código aberto por Darksight Analytics.

Funcionalidades

• Extrair lista de membros de grupos públicos e privados para CSV
• Extrair mensagens de chat de grupos públicos e privados para CSV
• Extrair links de convite t.me do histórico de chat (grupos públicos e privados)
• Pesquisar um usuário do Telegram por nome de usuário ou ID numérico (limitado)
• Identificar ID do criador de pacote de stickers (inferido pelo ID do conjunto de stickers) Créditos para: https://hackernoon.com/whats-wrong-with-stickers-in-telegram-deanonymize-anonymous-channels-in-two-clicks
• Suporte a proxy:
  • Salvar proxy (--set-proxy)
  • Remover proxy (--remove-proxy)
  • Substituição de proxy única (--proxy)

Requisitos

• Python 3.10+

Instalação

git clone https://github.com/Darksight-Analytics/tgspyder.git
cd tgspyder
pip install -r requirements.txt
pip install -e .

🕷️ Introdução

Ferramenta CLI de OSINT para Telegram Construída para investigadores, analistas, jornalistas e pesquisadores.

TGSpyder é uma ferramenta OSINT de linha de comando para coleta e análise estruturada de dados do Telegram. Ela permite extrair membros, mensagens, links de convite, usuários e metadados de grupos e canais públicos e privados do Telegram — exportando tudo para arquivos CSV amigáveis para investigadores.

Funcionalidades

• 📋 Extrair listas de membros (onde o Telegram permite)
• 💬 Rastrear mensagens de chat
• 🔗 Extrair e deduplicar links de convite do Telegram
• 🧍 Pesquisar usuários por ID ou nome de usuário
• 🎭 Identificar criadores de pacotes de stickers
• 🌐 Suporte a proxy SOCKS (Tor / VPN)
• 📁 Saída CSV limpa para fluxos de trabalho OSINT
• 📦 Estrutura de saída

Todos os dados coletados são armazenados em uma única pasta de execução:

TGSpyder Output/
├── members/
│   └── members_<target>_<timestamp>.csv
├── chats/
│   └── messages_<target>_<timestamp>.csv
└── crawled_links/
    └── crawled_links_<target>_<timestamp>.csv

🚀 Início Rápido

1️⃣ Clone o repositório

git clone https://github.com/Darksight-Analytics/tgspyder.git
cd tgspyder

2️⃣ Crie e ative um ambiente virtual

python3 -m venv venv
source venv/bin/activate

3️⃣ Instale as dependências

pip install -r requirements.txt

4️⃣ Instale o TGSpyder como CLI

pip install -e .

Verifique a instalação:

tgspyder --help

🔑 Credenciais da API do Telegram

• Acesse https://my.telegram.org e faça login com sua conta do Telegram.
• Navegue até Ferramentas de desenvolvimento de API para gerar seu API ID e API Hash, que são necessários para autenticar o TGSpyder com o Telegram.

🧭 Uso Básico

Extrair membros e chats

tgspyder https://t.me/examplegroup --members --chats

Extrair apenas links de convite

tgspyder https://t.me/examplegroup --crawl-invites

Pesquisa de usuário

tgspyder --user 123456789
tgspyder --user @username

Pesquisa de criador de pacote de stickers

tgspyder --sticker-pack https://t.me/addstickers/packname

🌐 Suporte a Proxy

TGSpyder suporta proxies SOCKS (amigável para Tor / VPN).

Proxy único

tgspyder --proxy socks5://127.0.0.1:9050 <target> --chats

Salvar proxy para execuções futuras

tgspyder --set-proxy socks5://127.0.0.1:9050

Remover proxy salvo

tgspyder --remove-proxy

🔐 Autenticação e Configuração

Na primeira execução, o TGSpyder solicitará:

• ID da API do Telegram
• Hash da API do Telegram
• Conta de usuário ou token de bot

As credenciais são armazenadas localmente em: ~/.tgspyder.conf

Os arquivos de sessão são reutilizados automaticamente.

⚠️ Limitações

• Alguns grupos não expõem listas de membros
• Grupos privados exigem links de convite válidos
• A atribuição do criador do sticker nem sempre é garantida
• Sujeito a limites da API do Telegram

🧪 Uso Ético & Aviso de OSINT

TGSpyder é destinado a:

• Investigações de OSINT
• Pesquisa acadêmica
• Jornalismo
• Análise de ameaças e redes

Os usuários são responsáveis por cumprir:

• Leis locais
• Termos de serviço da plataforma
• Padrões éticos de pesquisa

📄 Licença

MIT License Consulte LICENSE para detalhes.

🚀 Demonstração

👤 Autor

• Valdemar Balle
• Fundador da Darksight Analytics

⚖️ Aviso Legal

TGSpyder é fornecido apenas para fins de inteligência de código aberto (OSINT), pesquisa, investigação e educação.

Os usuários são os únicos responsáveis por garantir que o uso desta ferramenta esteja em conformidade com:

• Leis e regulamentos aplicáveis
• Termos de serviço da plataforma
• Padrões éticos de pesquisa e investigação

O autor e os colaboradores não assumem nenhuma responsabilidade pelo uso indevido desta ferramenta ou por quaisquer consequências decorrentes de seu uso.