For the complete documentation index, see llms.txt. This page is also available as Markdown.

光标

thordata-serp-mcp Skill = Cursor AI使用ThorData SERP时的规则说明

Cursor可通过Rules机制加载thordata-serp-mcp的规则内容。 接入后,Cursor AI在处理ThorData SERP、公开搜索结果、SEO排名、新闻监控、购物价格或本地商家相关任务时,会依据该skill判断搜索场景、输出字段和处理边界。

本文介绍如何将现有SKILL.md转换为Cursor可识别的规则文件。 ThorData SERP MCP服务、API和鉴权配置请参考对应产品文档。

规则加载方式

Cursor的项目规则通常通过以下目录加载:

.cursor/rules/*.mdc

而thordata-serp-mcp/SKILL.md是Codex skill的标准文件。 Cursor不会自动把Codex skill文件夹作为Rules目录加载。

囙此,在Cursor中使用该skill时,需要将SKILL.md内容复制到Cursor规则文件中:

thordata-serp-mcp/SKILL.md -> .cursor/rules/thordata-serp-mcp.mdc

规则来源仍然是原始SKILL.md,这样可以避免维护两套不一致的说明。

适用场景

当您需要在Cursor中处理以下任务时,可以接入这份skill:

• ThorData SERP 查询

• 公开搜索结果分析

• SEO 排名检查

• 新闻监控

• 商品价格或购物结果分析

• 地图、本地商​​家或本地搜索任务

• 批量 SERP 查询任务

配置后,Cursor AI会参考该 skill 判断:

• 何时使用ThorData SERP

• 如何区分不同SERP场景

• 输出中应保留哪些字段

• 工具不可用时如何说明

• 哪些字段不能推测或补写

准备工作

请先准备:

• 已安装 Cursor

• 一个需要接入该规则的项目

• thordata-serp-mcp 文件夹

• thordata-serp-mcp/SKILL.md

• 可选:thordata-serp-mcp/references/serp-rules.md

thumbtack-angle

项目规则与全局规则

建议优先使用项目规则。

  • 项目规则只作用于当前项目,适合测试、团队协作和按项目管理,也便于后续删除或调整。

  • 当多个Cursor项目都需要使用同一套ThorData SERP规则时,再考虑将规则加入全局规则。

配置步骤

1

打开项目

在Cursor中打开需要使用ThorData SERP的项目。

2

创建Rules目录

在项目根目录创建:

.cursor/rules

如果该目录已经存在,可以直接使用。

3

创建规则文件

在 .cursor/rules 目录中创建:

thordata-serp-mcp.mdc

完整路径应为:

.cursor/rules/thordata-serp-mcp.mdc

4

写入 SKILL.md 内容

打开:

thordata-serp-mcp/SKILL.md

将 SKILL.md 中的内容复制到:

.cursor/rules/thordata-serp-mcp.mdc

保存后,Cursor即可将这份skill作为当前项目的规则使用。

5

补充详细规则(可选)

references/serp-rules.md 是该skill的补充规则文件,包含更细的engine/type校验、降级策略、批量任务、错误处理和隐私边界说明。

如需更完整的行为约束,可以打开:

thordata-serp-mcp/references/serp-rules.md

将其中需要的内容追加到:

.cursor/rules/thordata-serp-mcp.mdc

如果只是基础使用,仅复制SKILL.md通常已经足够。

6

重新加载项目

保存规则文件后,Cursor通常会自动读取规则。

如需确保规则生效,可以关闭并重新打开当前项目。

7

验证规则是否生效

在 Cursor Chat 中输入:

使用 Thordata SERP 搜索 OpenAI 的最新新闻,并返回标题、来源、发布时间和连结。

如果配置成功,Cursor AI应能识别这是ThorData SERP新闻搜索场景,并在回答中关注来源连结、发布时间和查询条件。

验证标准

规则生效后,Cursor AI 的回答应具备以下特征:

• 不将新闻搜索误作普通网页搜索

• 保留来源连结

• 在缺少MCP工具时说明无法执行真实搜索

• 不编造搜索结果

• 不推测价格、评分、电话、地址等未返回字段

常见问题

Cursor 是否可以直接读取原始 SKILL.md?

不建议依赖Cursor自动读取原始SKILL.md。

Cursor的规则入口是.cursor/rules/*.mdc。为了确保规则稳定生效,应将 SKILL.md 内容复制到 .cursor/rules/thordata-serp-mcp.mdc。

为什么不使用简化规则模板?

SKILL.md是该skill的主规则来源。 直接复用SKILL.md可以减少规则分叉,避免教程中的简化规则与原始skill后续不一致。

是否需要加入 serp-rules.md?

serp-rules.md 是补充规则文件,不是必需项。

建议先接入SKILL.md。 当任务需要更细的 engine/type 校验、降级规则、批量任务规则或错误处理规则时,再追加 references/serp-rules.md 中的相关内容。

Cursor 提示无法搜索怎么办?

这通常不是规则接入失败。 Rules只告诉Cursor AI如何处理ThorData SERP任务。 真实搜索需要ThorData SERP MCP工具已经在Cursor中配置完成。

如何只让当前项目使用该规则?

将规则放在当前项目的:

.cursor/rules/thordata-serp-mcp.mdc

这样规则只会作用于当前项目。

如何卸载

如需移除该skill规则,删除以下文件即可:

.cursor/rules/thordata-serp-mcp.mdc

puzzle-piece

Last updated

Was this helpful?