在 Discord 里通知刚开始的网球比赛

在 Discord 里通知刚开始的网球比赛

一个 n8n 工作流，向 Live Tennis API 询问现在正在进行的比赛，并为每场之前没有通知过的比赛，往一个 Discord 频道发一行提醒。它每 20 分钟运行一次。

包里有什么

• workflow.json：n8n 导出的工作流，六个节点：五个会运行的和一张便签。里面没有任何凭据。
• README.md：这份设置说明，压缩包里的是英文版。

我们相对原来的副本改了什么

• 定时原来是每 5 分钟一次，便签还说这样远低于免费套餐的限额。接口的参考文档（2026 年 11 月 12 日查阅）给免费套餐的是每分钟 30 次、每天 100 次。每 5 分钟一次调用，一天就是 288 次，大约八小时就会用完。现在定时改成每 20 分钟一次，一天 72 次。
• 便签改写了，和新的定时和限额一致。
• HTTP Request 和 Discord 两个节点写了凭据类型，却没有关联任何凭据，所以没有要删的。
• 别的都没改。

开始之前

• 一个 n8n 实例，n8n Cloud 或自己的服务器都行。
• 一个 Live Tennis API 密钥。它的网站有一个不需要银行卡的免费套餐。
• 一个带 Incoming Webhook 的 Discord 频道。在频道的设置里，Integrations 下面创建一个，并复制它的地址。

设置

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 新建一个 Header Auth 凭据，名称填 X-API-Key，值填你的密钥。在 Get Live Matches 里选中它。
3. 添加一个 Discord Webhook 凭据，填上 webhook 地址，在 Discord 里选中它。
4. 点 Test workflow。第一次运行会通知此刻正在进行的每一场比赛，因为之前没有见过任何一场。
5. 激活工作流。

一次运行的过程

1. Schedule Trigger 按它的定时器开始一次运行。
2. Get Live Matches 用 status=live 调用 GET /matches，请求头里带着你的密钥。返回里有一个 data 数组，没有比赛进行时它是空的。
3. Split Out Matches 把 data 拆成每场比赛一条。
4. Only New Matches 是一个 Remove Duplicates 节点，把每场比赛的 id 和前几次运行里见过的 id 比较，只放行新的。
5. Discord 发出一行，比如“New live match: Player A vs Player B”，后面跟着这场比赛的 status。

改变风格

• 多久查一次：Schedule Trigger 里的间隔。记住免费套餐每天 100 次调用。
• 查哪些比赛：在 Get Live Matches 里加查询参数。参考文档列出了 tour（atp、wta、challenger、itf、juniors）、gender、tier 和 player。
• 消息内容：Discord 里的文字。
• 发到哪里：把 Discord 换成别的聊天节点。

注意事项

• 超过每日上限的调用会得到 429 回复。参考文档提醒说，一直重试的循环会招来 24 小时的封禁，所以不要给那个节点加重试。
• 消息里带着比赛的 status 字段。status=live 的筛选本来就只留进行中的比赛，所以第一次运行时看看这个字段里写的是什么。参考文档还列出一个 event_status 字段，你可以改用它。
• 接口的页面（2026 年 11 月 12 日查阅）没有写明在公开频道里转用它的比分要遵守什么条款。发到人多的公开服务器之前，先看它的条款。
• 这个版本没有对接口或 Discord 运行过。返回的结构来自接口的参考文档。
• 你的密钥会发给接口，比赛的那些行发到 Discord。
• JSON 里没有任何凭据。