从零搭建轻量网红带货直播实时弹幕关键词触发自动提示钩子

一、准备工具清单

• Python 3.9.x 64位：下载地址https://www.python.org/ftp/python/3.9.13/python-3.9.13-amd64.exe，安装时务必勾选「Add Python 3.9 to PATH」
• obs-websocket插件：对应OBS 27/28/29通用版下载地址https://github.com/obsproject/obs-websocket/releases/download/4.9.1-compat/obs-websocket-4.9.1-compat-Windows-Installer.exe
• 抖音/快手/视频号通用弹幕抓取库：Python第三方库danmuji，后续通过pip安装

二、OBS端配置

打开已安装obs-websocket的OBS Studio，按以下步骤操作

1. 开启obs-websocket服务

• 点击顶部菜单栏「工具」→「WebSockets Server Settings」
• 勾选「Enable WebSockets Server」
• 端口默认保留4444，勾选「Enable Authentication」，设置固定密码（比如123456，后面Python脚本会用到）
• 点击「OK」保存

2. 创建自动提词文本源

• 在OBS「来源」面板点击「+」→「文本(GDI+)」
• 命名为「带货钩子提示」，点击「确定」
• 设置字体（微软雅黑加粗，72号）、颜色（红色，半透明80%）、位置（居中偏下，Y坐标设为显示器高度-200），点击「确定」
• 右键「来源」面板的「带货钩子提示」，勾选「隐藏」（默认隐藏，触发关键词后自动显示）

三、Python端安装依赖库

按下Win+R键，输入cmd，回车打开命令提示符，依次输入以下命令并回车

pip install danmuji==0.1.2 -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install obs-websocket-py==0.10.0 -i https://pypi.tuna.tsinghua.edu.cn/simple

若提示「Successfully installed」则安装成功

四、编写完整Python控制脚本

在电脑桌面新建文件夹「直播提词助手」，进入后右键新建文本文档，重命名为「hook_trigger.py」（注意后缀名从.txt改为.py），右键选择「打开方式」→「记事本」，粘贴以下完整可复制代码

import time
from danmuji import Danmuji
from obswebsocket import obsws, events, requests
-- 配置区（可直接修改） --
ROOM_URL = "https://live.douyin.com/你的抖音直播间号"   抖音/快手/视频号直播间链接
OBS_HOST = "localhost"
OBS_PORT = 4444
OBS_PASSWORD = "123456"   对应OBS WebSocket设置的密码
HOOK_KEYWORDS = ["想要链接", "上车", "福利", "多少钱", "优惠", "试用"]   触发关键词，可增减
HOOK_TEXT = "⚠️ 福利钩子触发！库存只剩300件！点击1号链接下单！"   提词内容
SHOW_DURATION = 5   提词显示时长（秒）
-- 配置区结束 --
初始化OBS WebSocket连接
ws = obsws(OBS_HOST, OBS_PORT, OBS_PASSWORD)
def on_event(message):
处理弹幕消息
if hasattr(message, "data") and "content" in message.data:
content = message.data["content"]
检查是否包含关键词
if any(keyword in content for keyword in HOOK_KEYWORDS):
print(f"触发关键词弹幕：{content}")
更新文本源内容
ws.call(requests.SetTextGDIPlusProperties(source="带货钩子提示", text=HOOK_TEXT))
显示文本源
ws.call(requests.SetSceneItemProperties(item="带货钩子提示", visible=True))
等待指定时长
time.sleep(SHOW_DURATION)
隐藏文本源
ws.call(requests.SetSceneItemProperties(item="带货钩子提示", visible=False))
if __name__ == "__main__":
try:
连接OBS
ws.connect()
print("已成功连接OBS")
初始化弹幕抓取器
dmj = Danmuji(ROOM_URL)
dmj.register(on_event)
print(f"已开始监听弹幕，触发关键词：{', '.join(HOOK_KEYWORDS)}")
dmj.start()
保持脚本运行
while True:
time.sleep(1)
except Exception as e:
print(f"出错：{e}")
finally:
断开连接
ws.disconnect()
print("已断开OBS连接")

修改「配置区」的以下内容后保存： 1. 把ROOM_URL换成你正在/即将开播的直播间链接（支持抖音、快手、视频号） 2. 把OBS_PASSWORD换成你在OBS WebSocket设置的密码 3. 根据你的产品调整HOOK_KEYWORDS、HOOK_TEXT、SHOW_DURATION

五、启动与运行验证

1. 启动提词脚本

回到「直播提词助手」文件夹，按住Shift键右键空白处，选择「在此处打开PowerShell窗口」，输入以下命令并回车

python hook_trigger.py

若提示「已成功连接OBS」「已开始监听弹幕」则启动成功

2. 验证功能

• 用小号进入你的直播间（可以在手机/另一台电脑登录）
• 在弹幕区发送任意一个配置的关键词（比如「想要链接」）
• 观察OBS预览画面，「带货钩子提示」是否会在5秒内显示后自动隐藏
• 若成功，说明系统已正常工作

六、常见问题排查

1. 提示「Add Python to PATH」未勾选

卸载当前Python，重新下载安装包，务必勾选安装界面最下方的「Add Python 3.9 to PATH」

2. 提示「无法连接OBS」

检查： 1. OBS是否已开启 2. OBS WebSocket服务是否已勾选「Enable」 3. OBS_HOST、OBS_PORT、OBS_PASSWORD是否与配置区一致 4. 是否关闭了Windows防火墙对Python的拦截（首次运行脚本时会弹出防火墙提示，点击「允许访问」）

3. 弹幕监听成功但OBS无反应

检查： 1. OBS「来源」面板是否有「带货钩子提示」文本源（名称必须完全一致，包括空格） 2. 文本源是否默认隐藏（首次创建后需手动隐藏一次）

4. 抖音直播间无法抓取弹幕

当前版本danmuji需要直播间处于「开播状态」才能抓取，若刚开播等待1-2分钟再试