webQQ在今年1月已经停止服务了。想用python写一个QQ机器人,但是python的QQbot库因为webQQ停止服务,挂得不能再彻底了。后来google了好几天,终于在github找到了一个神奇的插件=coolq-http-api。
这个插件的神奇之处在于,它运行一个server,把qq信息转成http形式。发送,接收信息的时候,只需要使用http请求,即可和server进行交互,非常方便,也非常使用python(requests库无敌)。当然,插件运行基于酷Q,需要用酷Q加载插件才能正常使用。
要实现用python发送/接收消息,要用requests发送http请求之外,还要用flask在本地搭建一个flask服务端,告知插件flask服务器的地址和端口,这样所有的qq消息都会自动传递给flask,我们可以根据消息的来源,内容,自动判断是否要回复(用requests向酷Q进行http请求)即可。原理图如下:
一、 准备工作
- 酷Q下载安装: https://cqp.cc/t/23253 下载任意版本,右键解压即可使用。
- 插件下载安装: https://github.com/richardchien/coolq-http-api/releases 下载cpk文件,放到酷Q的app文件夹中
- python下载安装:这个就不说了,说太多次了,去官网下载安装包,一键安装就行了,注意要使用python3版本。
- python IDE下载安装:推荐使用pycharm,具体安装过程略。也是一键安装。
搞定后你的酷Q app文件夹下应该是这样的:
- 启动酷Q主目录下的CQA.exe,打开酷Q登录你要做机器人的QQ号,建议使用小号,防止被封。
- 由于酷Q使用的是手机TIM协议,成功上线后, 你可以看到小号为TIM在线。
- 右键酷Q的小图标,进入应用管理,找到HTTP API直接启用。
成功启用后,会弹出一个控制台窗口,提示正在监听5700端口。
二、 配置酷Q httpApi插件
插件的配置文档: http://richardchien.gitee.io/coolq-http-api/docs/
配置文件在酷Q Air\data\app\io.github.richardchien.coolqhttpapi\config 文件夹下,是一个以QQ名称命名的json文件。
以下几项配置比较关键:
- port : 酷Q server监听的端口,可自定义。
- use_http:务必是true,除非你使用websocket。
- post_url:flask服务端接收消息的接口,可自定义。
- post_message_format:酷Q向flask发送消息的格式,建议改成array。
其他的配置项可见文档: https://richardchien.gitee.io/coolq-http-api/docs/4.12/#/Configuration?id=%E9%85%8D%E7%BD%AE%E9%A1%B9
附上自己的简单配置:
三、用python发送自己的第一条QQ消息
先悄悄用pip安装一个requests库….
插件的api文档: https://richardchien.gitee.io/coolq-http-api/docs/4.12/#/API
我们看下发送私聊消息的接口:
用requests构造一个http post请求,post的数据填入相关信息:
import requests
data = {
'user_id':723690032,
'message':'我是一个可爱的小机器人喵~',
'auto_escape':False
}
api_url = 'http://127.0.0.1:5700/send_private_msg'
#酷Q运行在本地,端口为5700,所以server地址是127.0.0.1:5700
r = requests.post(api_url,data=data)
print(r.text)
四、接收第一条QQ消息
同样先悄咪咪安装一个flask….
from flask import Flask,request
from json import loads
bot_server = Flask(__name__)
@bot_server.route('/api/message',methods=['POST'])
#路径是你在酷Q配置文件里自定义的
def server():
data = request.get_data().decode('utf-8')
data = loads(data)
print(data)
return ''
if __name__ == '__main__':
bot_server.run(port=5701)
#端口也是你在酷Q配置文件里自定义的
运行一下这个flask程序,然后用自己的QQ给你的机器人随便发条信息:
{'font': 65320440, 'message': [{'data': {'text': '你才不是可爱的小机器人呢'}, 'type': 'text'}], 'message_id': 8, 'message_type': 'private', 'post_type': 'message', 'raw_message': '你才不是可爱的小机器人呢', 'self_id': 766202408, 'sender': {'age': 0, 'nickname': 'Misery_', 'sex': 'unknown', 'user_id': 723690032}, 'sub_type': 'friend', 'time': 1573044578, 'user_id': 723690032}
控制台打印的内容是一个python的字典格式,我们可以优化一下,取出需要的信息,如QQ号,昵称,消息内容:
QQ = data.get('user_id')
nickname = data['sender'].get('nickname')
message = data['message'][0]['data'].get('text')
print('来自QQ:{},昵称:{} 的信息:\n{}'.format(QQ,nickname,message))
五、后记
到这里,你就写出了一个hello world QQ机器人,想实现更多的功能,需要多去研究研究API,多研究研究python。这个插件功能相当强大,几乎涵盖了所有的QQ功能。博主曾经写过一个,可以对接某面板,涵盖登录,查询,支付等多种功能,并带有群管模块,接入阿里云tts语音系统,实现语音聊天。真的非常强大,有兴趣的同学可以好好研究一下。
博主,第一个发送消息,pycharm出现d1循环是什么意思
什么是d1循环?
你好,我在应用管理里没有发现新下载cpk,可能是什么原因?
酷Q前几天倒闭了!
现在不能用了吗
关于在docker上面运行的时候报出A VNC is already running as : 11的错误,novnc都不可以打开。(运行命令如下)
docker run -ti –rm –network=host –name cq -v /home/wt/coolq/coolq-data:/home/user/coolq -p 8080:9000 -p 5700:5700 -e COOLQ_ACCOUNT=3303907850 -e CQHTTP_SERVE_DATA_FILES=yes -e VNC_PASSWD=12345678 -e COOLQ_URL=https://dlsec.cqp.me/cqp-full richardchien/cqhttp:latest