支持语音和文字的 SEO 关键词聊天助手

支持语音和文字的 SEO 关键词聊天助手

一个充当 SEO 聊天后端的 n8n 工作流。你的应用发来一个文字问题或一段语音留言，连同国家和语言。语音由 Gemini 转成文字，一个 Gemini 智能体用带表格的 Markdown 回答。它的工具通过你基于 DataForSEO 搭的子工作流，查关键词、竞争对手的排名、Google 搜索结果和 Google 的 AI Mode。Firecrawl 负责读取它点名的网页。答案在同一个网络请求里返回，聊天会为每个调用方记住最近 12 轮对话。

包里有什么

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

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

• ranked_keywords、related_keywords、keyword_ideas、serp_search、ai_mode 和 internal_links 原来调用的是作者自己 n8n 里的一个子工作流。导入后它们是空的，所以你要自己搭这个子工作流，并在这六个节点里选中它（见下文）。
• 🦺 Set Data 里的 Firecrawl 密钥原来是作者自己写法的占位符，现在和其他套件一样，写的是 YOUR_FIRECRAWL_KEY。

除此之外没有改动。原来的副本没有丢失反斜杠。

开始之前

• 一个 n8n 实例，n8n Cloud 或自己的服务器都行。
• 一个在 Google AI Studio 申请的 Gemini API 密钥。
• 一个 Firecrawl API 密钥。
• 一个 DataForSEO 的 API 登录名和密码，给子工作流用。
• 一个能发请求、能显示 Markdown 答案的应用、页面，或者 Postman 这样的工具。

设置

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 用你的密钥添加一个 Google Gemini 凭据，在 Transcribe Audio、2.5 Flash 和 2.5 Pro 里选中它。
3. 在 🦺 Set Data 里，把 YOUR_FIRECRAWL_KEY 换成你的 Firecrawl 密钥。
4. 按下面的说明搭好子工作流并保存。
5. 逐一打开 Keyword AI Agent 下面的六个工具节点，在工作流字段里选中你的子工作流。
6. 看一下 Memory。它的键是调用方的 IP 地址，取自 Cloudflare 加上的 cf-connecting-ip 请求头。如果你的 n8n 前面没有 Cloudflare，这个请求头就不存在，运行会停在 Memory。把键改成你的应用会发送的值，比如 {{ $('Webhook').first().json.body.session_id }}。
7. 打开 Webhook。它的路径是 keywordresearch，接收 POST。如果别人可能知道这个地址，就在这里加上 Header Auth。
8. 保存，往测试地址发一个测试请求，然后发布，改用正式地址。

子工作流

六个工具都调用同一个子工作流，function 说明要做哪件事。用一个 When Executed by Another Workflow 触发器开始，让它接收这六个字段：

{
  "function": "ranked_keywords, related_keywords, keyword_ideas, serp_search, ai_mode or internal_links",
  "keyword": "<智能体的搜索词>",
  "url": "<一个域名，比如 example.com，或一个网页地址>",
  "country_code": "<DataForSEO 的地区编号，比如 2840>",
  "language_code": "<DataForSEO 的语言代码，比如 en>",
  "firecrawl_api": "<你的 Firecrawl 密钥>"
}

每个工具都会发送 function 和两个代码。ranked_keywords 另外发送 url，提示词要求智能体只给不带协议的域名。internal_links 另外发送 url 和 Firecrawl 密钥。其余四个另外发送 keyword。country_code 虽然叫这个名字，装的却是 DataForSEO 的地区编号。返回智能体能读懂的文字或 JSON 就行。

文件里没有说明作者的版本做了什么，所以下面是一种搭法，依据的是 2026 年 11 月 2 日查看的 DataForSEO 和 Firecrawl API 页面。用一个按 function 分支的 Switch，每个分支接一个 HTTP Request，DataForSEO 的登录名和密码用 HTTP Basic Auth：

ranked_keywords   POST https://api.dataforseo.com/v3/dataforseo_labs/google/ranked_keywords/live
related_keywords  POST https://api.dataforseo.com/v3/dataforseo_labs/google/related_keywords/live
keyword_ideas     POST https://api.dataforseo.com/v3/dataforseo_labs/google/keyword_ideas/live
serp_search       POST https://api.dataforseo.com/v3/serp/google/organic/live/advanced
ai_mode           POST https://api.dataforseo.com/v3/serp/google/ai_mode/live/advanced
internal_links    POST https://api.firecrawl.dev/v2/map

在每个 DataForSEO 请求体里，用这两个代码填 location_code 和 language_code。ranked_keywords 把域名放在 target 里，related_keywords 接收一个 keyword，keyword_ideas 接收一个 keywords 列表。Firecrawl 的请求把地址放在 url 里，密钥放在 Bearer 请求头里。

怎么调用

文字问题用 JSON 请求体：

{
  "type": "text",
  "message": "Keyword ideas for a bike repair shop in Leeds",
  "country": "United Kingdom",
  "language": "English"
}

语音留言用 multipart 表单，录音放在一个叫 audio 的字段里：

curl -X POST "https://<your n8n>/webhook/keywordresearch" -F type=voice -F country=Germany -F language=German -F audio=@question.mp3

type 必须是小写的 voice 或 text。country 和 language 必须和 Code 节点列表里的名称完全一致，比如 United States、Turkiye 或 Chinese (Simplified)。列表里有 94 个国家和 46 种语言。

一次运行的过程

1. Webhook 收到请求，等 Respond to Webhook 之后才回应。
2. Code 为国家和语言查出 DataForSEO 的地区编号和语言代码。
3. Switch 把语音留言交给 Transcribe Audio，由 Gemini 转成文字，文字问题则交给 Set Message。
4. 🦺 Set Data 汇总问题、Firecrawl 密钥、两个代码和调用方的 IP 地址。
5. Keyword AI Agent 带着它的长系统提示词、Memory 里最近的对话和它的工具来回答。写答案之前，它可能调用好几个工具。
6. Respond to Webhook 把智能体的答案作为 JSON 发回，放在一个叫 output 的字段里。

改改样子

• 助手的口吻和格式：Keyword AI Agent 里的系统提示词。它规定了人设、每种回答必须带的表格，以及结尾的三行建议。
• 更多国家或语言：Code 顶部的两个列表。
• 聊天记住多少内容：Memory 里的 Context Window Length，文件里是 12。
• 备用模型：2.5 Pro，2.5 Flash 出错时智能体才用它。
• 抓取的网页要多新：URL_search 请求体里的 maxAge，文件里是四小时。

需要知道的

• 费用：智能体每一轮都由 Gemini 计费，光系统提示词就有大约 18,000 个字符，每次都要发出去。Firecrawl 每次抓取都计数，PDF 按页算。DataForSEO 对子工作流发出的每次请求计费。
• 模型：2.5 Flash 和 2.5 Pro 都没写型号，所以都用节点的默认型号 Gemini 2.5 Flash。想让备用模型真的是 Pro，就在 2.5 Pro 里选 models/gemini-2.5-pro。
• 2026 年 11 月 2 日查看时：Google 的弃用页面没有给 Gemini 2.5 定停用日期，但只对以前用过的用户开放。新密钥可能要在三个 Gemini 节点里改用 gemini-3.8-flash。Firecrawl 的文档仍然列着 URL_search 调用的 v1 抓取接口，并注明 v2 已经推出。
• 提示词要求模型语气笃定、从不含糊，要求它声称自己并不具备的经验，还要给出点击率潜力、可读性评分和关键词密度，这些都没有工具去测。把这些数字当作猜测，或者从提示词里删掉这几行。
• 提示词里有一节写的是 2025 年，引用的流量数字没有出处。提示词里有两个工具的名字和节点略有不同（url_search 和 AI_Mode），而且 internal_links 接收的是网页地址，提示词却让它填域名。
• 建议：每个答案结尾都有三行以 [SUGGESTION] 开头的内容。提示词原本是为能把它们变成按钮的前端准备的，所以你的应用要么照这样显示，要么去掉。
• 名称不对：Code 列表里没有的国家或语言会让代码为空，之后 DataForSEO 的请求就会失败。type 不是 voice 或 text 时，运行会在给出任何回答之前停下。
• 共用记忆：同一个 IP 地址后面的调用方，比如一间办公室里的人，会共用一段对话。记忆存在 n8n 内部，所以一重启就清空。
• 公开的 webhook：发布之后，在你加上 Header Auth 之前，任何知道地址的人都能用你的密钥运行它。
• 你的数据：问题和语音留言发给 Google，网页发给 Firecrawl，关键词和域名发给 DataForSEO。每个调用方的 IP 地址就是记忆的键。因为 🦺 Set Data 里存着 Firecrawl 密钥，每次运行的记录里也会存下它，所以不要公开运行记录列表。