> For the complete documentation index, see [llms.txt](https://doc.thordata.com/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.thordata.com/doc/zh/pa-qu/serp-api/mcp-fu-wu-qi/ji-neng-an-zhuang/n8n.md).
# n8n
在n8n中安装 Skill 规则时，需要让 AI Agent 节点的系统提示词（System Message）能够读取到 SKILL.md 的规则内容。 可以直接填入正文，也可以通过变量、文件读取或URL引用等方式注入； 关键是让AI代理在运行时看到完整规则。
**要求**
• n8n 中已经有一个启用了AI功能的工作流（例如AI Agent节点）
• 已经准备好 thordata-serp-mcp 的 SKILL.md 正文，或可被n8n读取的文件/URL/变量
• 可以编辑 AI Agent 节点的 **System Message**
**安装 Skill 规则**
{% stepper %}
{% step %}
**打开 AI Agent 节点**
在n8n工作流中打开需要使用ThorData SERP能力的AI Agent节点。
{% endstep %}
{% step %}
**找到 System Message**
进入AI Agent节点的系统提示词（System Message）配置区域。
{% endstep %}
{% step %}
**引入 SKILL.md 规则**
将thordata-serp-mcp的SKILL.md规则内容放入System Message。 可以直接填入正文，也可以先用文件读取、HTTP请求或变量节点获取内容，再注入到System Message。
{% hint style="info" icon="sign-hanging" %}
如果System Message中已有其他规则，请把skill规则放在同一段系统指令中，并确保语义不冲突。
{% endhint %}
{% endstep %}
{% step %}
**保留关键规则**
至少保留以下约束：
• 只允许使用 google / bing / yandex / duckduckgo 的白名单引擎与类型组合，不要发明不存在的引擎或类型
• 新闻类结果必须包含 title、source、published\_time、link
• 购物类结果必须包含 title、price、seller、rating、link
• 缺失的字段（价格、评分、电话、地址、发布时间等）不要编造
• 保留来源连结与查询时间戳，不要把SERP摘要当成完整网页内容
{% endstep %}
{% step %}
**保存工作流**
保存AI Agent节点和工作流配置，使新的系统提示词生效。
{% endstep %}
{% step %}
**测试Skill是否生效**
在AI Agent的聊天测试窗口里输入：
> 使用Thordata SERP搜索OpenAI的最新新闻，并返回标题、来源、发布时间和连结。
如果配置成功，AI代理会按照skill规则返回带来源连结的结构化结果，并且不会编造缺失字段。
{% endstep %}
{% endstepper %}
**常见问题**
**1. AI代理没有遵守Skill规则**
• 确认SKILL.md规则内容已经进入System Message，或在运行时被变量正确注入
• 确认没有其他系统提示词覆盖或冲突
• 确认测试问题和ThorData SERP、搜索结果、新闻、购物、地图或SEO排名有关
• 如果只引用了文件名或只填了摘要，建议改为注入完整SKILL.md规则内容
**2. 返回结果少了一些字段**
这是正常的。\
AI代理应该只展示真实返回的字段。 如果结果里没有价格、评分、电话、地址或发布时间，不应该自己编造——这也是判断System Message中的skill规则是否生效的一个标志。
**3. 应该把Skill规则放在哪里**
放在AI Agent节点的System Message中，而不是普通用户消息或临时聊天输入中。 普通消息容易被后续对话稀释，System Message更适合保存长期规则。