# sockysec/Telerecon

A reconnaissance framework for researching and investigating Telegram.

Repository: https://github.com/sockysec/Telerecon
Canonical: https://ross.abutalabs.com/products/telerecon
Language: Python
License Family: other
Last push: 2024-07-11T19:35:52+00:00

## Health v2 (maintenance only)
Score: 28/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 78
- inputs: {"age_days": 1099, "days_push": 783, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1324, forks 178 (observed 2026-08-28T04:04:22.299740+00:00)

## What it is
Telerecon is a Python-based OSINT reconnaissance framework for researching and investigating Telegram. It scrapes user profiles, messages, and channel activity, then extracts selectors, named entities, network maps, and geolocation analytics.

## Use cases
- investigate a telegram username across multiple channels
- scrape telegram channels and groups for research
- map a target's network of associates on telegram
- extract named entities and indicators from user messages
- build an exif metadata geo-map from telegram media
- run a community census of a telegram channel
- automated forward mapping for network analysis

## When to choose
- you need to profile or investigate a Telegram user or channel
- you want automated scraping plus NLP analytics in one tool
- you're doing OSINT research on extremist or criminal Telegram activity

## When to avoid
- you need a compliant or authorized-use data collection tool - it requires your own Telegram API credentials and may violate Telegram ToS
- you need a maintained library with a license - the repo has no license
- you target platforms other than Telegram

## Facets
- artifact type: framework
- maturity: active
- function: osint, web-scraping, nlp, data-science, analytics
- domain: osint, security, social-media
- platform: python, cli
- tags: telegram, reconnaissance, investigation, ner, network-analysis, exif, scraper, natural-language-processing, linux

## Member repositories
- sockysec/Telerecon (main) score 28

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:22.299740+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:47:02.043310+00:00, confidence not recorded.
  - readme: https://github.com/sockysec/Telerecon (fetched 2026-08-28T04:04:22.299740+00:00, sha cdd04944b145)
- Data as of 2026-08-30T08:39:29.467469+00:00.