postuf/telegram-api-lib

面向OSINT的基于Telegram场景的API


README

Gitpod ready-to-code

codecov

描述

周围有很多Telegram API库,但没有一个能够展示如何执行像从频道中清空所有照片、监控用户在线状态或注册新账户等复杂场景。本项目旨在解决这个问题:现在您可以轻松创建新的场景,并一键执行现有场景。

使用官方Android客户端的Telegram API。

原因

Telegram协议https://core.telegram.org/ 技术上全面且详细,但没有涵盖使用场景。我们的目标是创建一个库,实现一些实际的OSINT使用场景,包括

  • 在特定群组中搜索用户;
  • 解析群组成员;
  • 监控用户在线状态;
  • 从频道下载照片;
  • 监控用户资料变化(照片/简介等.);
  • 通过特定用户获取消息。

要求

  • PHP 7.4+
  • Composer
    • phpseclib

文档

快速入门

首先,将库添加到您的应用程序的composer中

composer require postuf/telegram-api-lib

要查看使用示例,请转到 examples 目录。您需要生成的认证密钥,运行 php registration.php 获取这些密钥。现在您已经准备好了,可以运行任何示例,例如,php parseGroupMembers.php,并检查输出。

详细日志(所有发送/接收的消息)默认启用,将 --info 添加到参数中可抑制它。

Docker容器

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

在注册脚本中获取AuthKey时,您可以按以下方式使用它

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

限制

不支持两步验证。