A plugin based on nonebot2, which is used to display the current peeping user information in QQ.
Project description
关于
本项目能够在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位置数据精准度
-
优化信息样式,拟采用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本仓库后进行更改,然后提交PR。
LICENSE
本项目采用 GPL 3.0 协议。
致谢
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.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 36948adccbfb67efb34ad34974a8043b7667939d54bd57f812d009e6e2a1377c |
|
MD5 | 6a185e192afcb74260d7ef1e982da726 |
|
BLAKE2b-256 | 6d8f5339b53d4464dc318ef474bb293e90774cc566a10aa5388cd89a105ffc24 |
Hashes for nonebot_plugin_repeep-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 28e2e957a185cb37789c7c2b2672d77c2d58a44a7421e91e8024576282561982 |
|
MD5 | d40c66dabe0911fe56e3715f2fd47923 |
|
BLAKE2b-256 | aea7f3a7ed701437270472c160b82d4a2b1c1102a5aca4cbc21a91bb4582e629 |