{"id":20321970,"url":"https://github.com/postuf/telegram-osint-lib","last_synced_at":"2025-04-12T23:42:55.380Z","repository":{"id":36758380,"uuid":"229737274","full_name":"Postuf/telegram-osint-lib","owner":"Postuf","description":"Telegram scenario-based API aimed at OSINT ","archived":false,"fork":false,"pushed_at":"2024-03-16T04:29:47.000Z","size":3423,"stargazers_count":282,"open_issues_count":3,"forks_count":43,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-04-12T23:42:49.449Z","etag":null,"topics":["osint","telegram","telegram-api","telegram-scenario"],"latest_commit_sha":null,"homepage":"https://habr.com/ru/post/486322","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Postuf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-12-23T11:17:23.000Z","updated_at":"2025-03-24T10:11:05.000Z","dependencies_parsed_at":"2024-01-14T12:16:58.156Z","dependency_job_id":"deb28515-12e7-40d7-91a9-4dc8cc91bf87","html_url":"https://github.com/Postuf/telegram-osint-lib","commit_stats":{"total_commits":204,"total_committers":15,"mean_commits":13.6,"dds":0.5784313725490196,"last_synced_commit":"8d4642c27251a6a201ae4cdfcf847e703f43ac10"},"previous_names":[],"tags_count":118,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Postuf%2Ftelegram-osint-lib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Postuf%2Ftelegram-osint-lib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Postuf%2Ftelegram-osint-lib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Postuf%2Ftelegram-osint-lib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Postuf","download_url":"https://codeload.github.com/Postuf/telegram-osint-lib/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248647256,"owners_count":21139081,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["osint","telegram","telegram-api","telegram-scenario"],"created_at":"2024-11-14T19:18:12.079Z","updated_at":"2025-04-12T23:42:55.360Z","avatar_url":"https://github.com/Postuf.png","language":"PHP","readme":"# Telegram OSINT scenario library\n\n[![Gitpod ready-to-code](https://img.shields.io/badge/Gitpod-ready--to--code-blue?logo=gitpod)](https://gitpod.io/#https://github.com/Postuf/telegram-osint-lib)\n\n[![codecov](https://codecov.io/gh/Postuf/telegram-osint-lib/branch/master/graph/badge.svg)](https://codecov.io/gh/Postuf/telegram-osint-lib)\n\n## Description\n\nA 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.\n\nUsing Telegram API from official Android client.\n\n## Rationale\n\nTelegram protocol https://core.telegram.org/ has technically thorough and detailed documentation, but does not cover usage scenarios.\nOur goal is to make a library that implements some real-life OSINT usage scenarios, including:\n* searching user in specific groups;\n* parsing group members;\n* monitoring user online status;\n* downloading photos from channel;\n* monitoring user profile changes (photo/bio/etc.);\n* fetching messages by specific user.\n\n## Requirements\n\n* PHP 7.4+\n* Composer\n  * phpseclib\n\n## Docs\n* [Create scenario](docs/create-scenario.md)\n\n## QuickStart\n\nFirst of all, add library to your app user composer:\n\n```\ncomposer require postuf/telegram-api-lib\n```\n\nTo check out usage examples, go to `examples` dir.\nYou need auth keys generated, run `php registration.php` to get this.\nNow you are all set, you can run any of examples, for example, `php parseGroupMembers.php`, and check the output.\n\nVerbose logging (all messages sent/received) is enabled by default, add `--info` to arguments to suppress it.\n\n### Docker container\n\n```\ndocker build -t telegram-osint-lib .\ndocker run -d -t --name tg-osint-lib telegram-osint-lib\ndocker exec -it tg-osint-lib /bin/bash\nphp examples/registration.php\n```\n\nWhen you get AuthKey in registration script, you can use it the following way:\n```\ndocker exec  --env BOT=your-auth-key -i tg-osint-lib php examples/monitorNumbers.php -n 123123123\n# if you save key to file\ndocker exec  --env BOT=@auth-key-filename-in-docker -i tg-osint-lib php examples/monitorNumbers.php -n 123123123\n```\n\n# Limitations\n\n2FA not supported.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpostuf%2Ftelegram-osint-lib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpostuf%2Ftelegram-osint-lib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpostuf%2Ftelegram-osint-lib/lists"}