用 Gemini 总结 YouTube 视频的 Webhook

用 Gemini 总结 YouTube 视频的 Webhook

一个接收 YouTube 链接的 n8n webhook。你发一个链接，工作流向 YouTube 查询这个视频，再由 Gemini 观看视频并写出结构化摘要。摘要返回给调用方，标题和链接发到 Telegram。

包里有什么

• workflow.json：n8n 导出的工作流，九个节点。其中一个是 Mindket 加的便签。里面没有任何凭据。
• README.md：这份设置说明，压缩包里的是英文版。

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

• 原来的副本通过一个社区节点 n8n-nodes-youtube-transcription 读取视频，它把视频变成逐字稿交给 OpenAI 模型。社区节点要在 n8n 的社区节点设置里按包名安装。这个包已不在 npm 上：它被撤下了，它指向的仓库也不存在了（npm 注册表，2026 年 11 月 12 日读取）。所以没有可安装的东西。同一天，YouTube 自己的字幕地址对普通请求也什么都不返回。
• Mindket 用一个 HTTP Request 节点 Summarize and Analyze Video，换掉了逐字稿节点、它后面的三个节点和 OpenAI 模型。它把视频的地址发给 Google 的 Gemini API，由 Gemini 自己读视频，所以工作流仍然以一份结构化摘要收尾。现在的摘要来自模型对视频画面和声音的理解，而不是来自逐字稿。
• 原来的副本里，Get YouTube Video 和逐字稿节点后面都没有接任何东西，所以运行到视频查询就停了。现在 Get YouTube Video 接到了新节点。
• Telegram 原来没有设置聊天。它现在填的是占位符 <YOUR_TELEGRAM_CHAT_ID>。
• 提示词现在要求 Gemini 观看视频，原来是要求总结给定的文字。
• 加了一张便签，说明新节点的来历。

开始之前

• 一个 n8n 实例，n8n Cloud 或自己的服务器都行。
• 一个 Gemini API 密钥，来自 Google AI Studio。
• 一个开通了 YouTube Data API 的 Google Cloud 项目，用来给 Get YouTube Video 建 OAuth2 凭据。
• 一个 Telegram 机器人，以及它写入的聊天的 id。不想收消息的话，删掉 Telegram。

设置

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 添加一个 Header Auth 凭据，名称填 x-goog-api-key，值填你的 Gemini 密钥。在 Summarize and Analyze Video 里选中它。
3. 添加一个 YouTube OAuth2 凭据，在 Get YouTube Video 里选中它。
4. 添加一个 Telegram 凭据，在 Telegram 里选中它，并把 <YOUR_TELEGRAM_CHAT_ID> 换成聊天的 id。
5. 保存，打开 Webhook，用它的测试地址。向它发一个链接：

curl -X POST "<YOUR_N8N_HOST>/webhook-test/ytube" -H "Content-Type: application/json" -d '{"youtubeUrl": "https://www.youtube.com/watch?v=<VIDEO_ID>"}'

1. 正式使用时，发布工作流，向 <YOUR_N8N_HOST>/webhook/ytube 发请求。

一次运行的过程

1. Webhook 在路径 ytube 上接收 POST 请求，并让调用方一直等到 Respond to Webhook。
2. Get YouTube URL 把 body.youtubeUrl 复制到名为 youtubeUrl 的字段。
3. YouTube Video ID 用正则表达式从链接里取出 11 位的 id。它能读 watch、youtu.be 和 embed 链接。Shorts 或直播链接取不到 id。
4. Get YouTube Video 查询这个视频，得到标题、描述和 id。
5. Summarize and Analyze Video 向 Gemini 的 interactions 接口发 POST，模型是 gemini-3.8-flash。请求体里有提示词，以及用 id 拼出的视频观看地址。store 是 false，所以 Google 不会为后续轮次保留这次交流的副本。
6. Response Object 从答案的 steps 里取出模型的文字，并设置 summary、空的 topics、title、description、id 和 youtubeUrl。
7. Respond to Webhook 把这些字段作为 JSON 返回给调用方，Telegram 发出标题和链接。

想换个结果，改这里

• 摘要的形状：Summarize and Analyze Video 请求体里的提示词。
• 模型：同一个请求体里的 model 一行。
• 调用方拿到什么：Response Object 的各个字段。
• Telegram 消息：Telegram 的文字。

值得知道的事

• Gemini 只读公开视频，不读私享或不公开列出的视频。Google 的视频理解页面（2026 年 11 月 12 日读取）称 YouTube 链接功能是预览版，价格和限制很可能变化。免费层每天最多接收 8 小时的 YouTube 视频。
• Interactions API 默认会保留请求：免费层一天，付费层 55 天，除非 store 是 false。这个文件把它设成了 false。
• 这个 webhook 没有认证，和原来的副本一样。任何知道地址的人都能启动一次运行，消耗 Gemini 额度并发出一条 Telegram 消息。发布之前，在 Webhook 里开启 Basic Auth 或 Header Auth。
• Telegram 的 HTML 模式不接受带有零散 < 或 & 的标题。
• topics 永远是空列表，没有任何东西去填它。
• Gemini 返回错误时，答案里没有 steps，Response Object 会出错。
• 视频链接发给 Google。标题和链接发给 Telegram。