Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/postuf/telegram-osint-lib
Telegram scenario-based API aimed at OSINT
https://github.com/postuf/telegram-osint-lib
osint telegram telegram-api telegram-scenario
Last synced: 1 day ago
JSON representation
Telegram scenario-based API aimed at OSINT
- Host: GitHub
- URL: https://github.com/postuf/telegram-osint-lib
- Owner: Postuf
- License: mit
- Created: 2019-12-23T11:17:23.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-03-16T04:29:47.000Z (10 months ago)
- Last Synced: 2024-12-18T07:04:10.655Z (9 days ago)
- Topics: osint, telegram, telegram-api, telegram-scenario
- Language: PHP
- Homepage: https://habr.com/ru/post/486322
- Size: 3.26 MB
- Stars: 265
- Watchers: 16
- Forks: 42
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Telegram OSINT scenario library
[](https://gitpod.io/#https://github.com/Postuf/telegram-osint-lib)
[](https://codecov.io/gh/Postuf/telegram-osint-lib)
## Description
A lot of Telegram API libraries around, but none of them demonstrates how to execute complex scenarios like draining all photos from channels, monitor users presence or register new account. This projects aims to correct situation: now you can easily create new scenarios and one-click execute existing ones.
Using Telegram API from official Android client.
## Rationale
Telegram protocol https://core.telegram.org/ has technically thorough and detailed documentation, but does not cover usage scenarios.
Our goal is to make a library that implements some real-life OSINT usage scenarios, including:
* searching user in specific groups;
* parsing group members;
* monitoring user online status;
* downloading photos from channel;
* monitoring user profile changes (photo/bio/etc.);
* fetching messages by specific user.
## Requirements
* PHP 7.4+
* Composer
* phpseclib
## Docs
* [Create scenario](docs/create-scenario.md)
## QuickStart
First of all, add library to your app user composer:
```
composer require postuf/telegram-api-lib
```
To check out usage examples, go to `examples` dir.
You need auth keys generated, run `php registration.php` to get this.
Now you are all set, you can run any of examples, for example, `php parseGroupMembers.php`, and check the output.
Verbose logging (all messages sent/received) is enabled by default, add `--info` to arguments to suppress it.
### Docker container
```
docker build -t telegram-osint-lib .
docker run -d -t --name tg-osint-lib telegram-osint-lib
docker exec -it tg-osint-lib /bin/bash
php examples/registration.php
```
When you get AuthKey in registration script, you can use it the following way:
```
docker exec --env BOT=your-auth-key -i tg-osint-lib php examples/monitorNumbers.php -n 123123123
# if you save key to file
docker exec --env BOT=@auth-key-filename-in-docker -i tg-osint-lib php examples/monitorNumbers.php -n 123123123
```
# Limitations
2FA not supported.