A plugin based on nonebot2, which is used to display the current peeping user information in QQ.
Project description
关于
本项目能够在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
致谢
Project details
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 |