A plugin based on nonebot2, which is used to display the current peeping user information in QQ.
Project description
nonebot-plugin-repeep
✨ 一款基于nonebot2的插件，用于获取QQ中当前窥屏用户信息 ✨
关于
本项目能够在QQ中获取当前窥屏用户的信息（目前只支持移动端QQ检测）。
由于本项目性质，使用的人多了之后检测接口随时会失效，且用且珍惜。
开始使用
前置条件
- CSRF信息记录后端
- IP定位接口
CSRF后端
本项目的CSRF后端需要实现三个接口：
- 获取Key（用于标识一个会话用于收集CSRF信息）
- 渲染图片记录客户端信息
- 取出收集到的信息
目前仅支持PHP实现的后端，具体搭建见repeep-backend-php。
IP定位接口
目前采用IPUU提供的区县级定位接口，允许每天2000次免费调用，请开发者自行申请后将密钥填入配置项。
安装
使用 nb-cli 安装
nb plugin install nonebot-plugin-repeep
使用 pip 安装
pip install nonebot-plugin-repeep
配置项
配置方式：直接在 NoneBot 全局配置文件中添加以下配置项即可。
必填配置
CSRF后端
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| trace_secret | str |
无 | 后端接口的密钥 |
| trace_api | str |
无 | 后端接口的URL |
IP定位接口
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| geoip_api | str |
"ipuu" |
接口选项，目前仅支持ipuu接口 |
| ipuu_key | str |
无 | ipuu接口密钥 |
可选配置
XML样式
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| brief | str |
"I Got U" |
XML卡片简介 |
| url | str |
"https://www.p0ise.cn/" |
XML卡片跳转链接 |
| title | str |
"谁在窥屏" |
XML卡片标题 |
| content | str |
"抓住你了！" |
XML卡片内容 |
| source | str |
"I Got U" |
XML来源信息 |
| image | str |
"https://static-cdn.p0ise.cn/2022/11/20221120180503774.jpg" |
XML图片 |
用法
- 发送 Command ：
谁在窥屏或者leakip
开发计划
- 优化IP位置数据精准度
- export插件信息和接口，以供其他插件使用
- 优化信息样式，拟采用HTML渲染输出图片
- 增加指令选项，指定获取目标群、用户信息
- 优化基于UA的设备识别
- 增加对电脑的检测
- 智能选择CSRF方法
原理
机器人基于python的nonebot2框架，QQ协议基于go-cqhttp。
插件实现原理是QQ的跨站请求伪造。通过图片调起GET方法访问接口，从而获取客户端IP和UA信息。
根据IP，获取定位信息。基于ipuu的在线接口。
根据UA，获取设备信息。基于user_agents库，增加中文优化和型号名称优化。
CSRF原理参考：https://cloud.tencent.com/developer/article/1933686
贡献
贡献使开源社区成为学习、启发和创造的绝佳场所。我们非常感激您所做的任何贡献。
如果您有建议可以使本项目更好，请 fork 存储库并创建一个拉取请求。您也可以简单地使用标签 "enhancement" 打开问题。别忘了给项目点一颗 Star！再次感谢！
- Fork项目
- 创建功能分支（
git checkout -b feature/AmazingFeature） - 提交你的更改（
git commit -m 'Add some AmazingFeature''） - 推送到分支（
git push origin feature/AmazingFeature） - 打开拉取请求
LICENSE
本项目采用 GPL 3.0 协议。更多信息请查看 LICENSE。
联系
博客：p0ise's blog
项目地址：https://github.com/p0ise/nonebot-plugin-repeep
QQ交流群：https://jq.qq.com/?_wv=1027&k=eQPw3qT3
致谢
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for nonebot_plugin_repeep-0.1.4.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0f80974147dd54ee4a7c8a0646a617502b4faff008fcfedfbfe340776471ea0c |
|
| MD5 | 2b5d1076a5a78c286b89bc7f0c834fed |
|
| BLAKE2b-256 | e9b815382592c7a845e515a9467998cb9b2fde3deb5bb8b9aab29eb19d10b90a |
Hashes for nonebot_plugin_repeep-0.1.4-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b1c81dd6e41ac1b04c1e666b99b290c2b32333f10c2233411104cec3f63ddcdb |
|
| MD5 | a829859bbd367c3b796d82b6b3757995 |
|
| BLAKE2b-256 | 3ba294709ace102869b766efd426e1aaf05d5478575ff7376ec61e38cdca572b |
