> 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/guang-biao.md).

# 光标

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

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

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

**规则加载方式**

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

<kbd>.cursor/rules/\*.mdc</kbd>

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

囙此，在Cursor中使用该skill时，需要将<kbd>SKILL.md</kbd>内容复制到Cursor规则文件中：

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

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

**适用场景**

当您需要在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

{% hint style="warning" icon="thumbtack-angle" %}
如果需要执行真实搜索，还需要在Cursor中配置可用的**ThorData SERP MC**P工具。 skill只提供规则，不负责完成MCP工具配置。
{% endhint %}

**项目规则与全局规则**

建议优先使用项目规则。

* 项目规则只作用于当前项目，适合测试、团队协作和按项目管理，也便于后续删除或调整。
* 当多个Cursor项目都需要使用同一套ThorData SERP规则时，再考虑将规则加入全局规则。

**配置步骤**

{% stepper %}
{% step %}
**打开项目**

在Cursor中打开需要使用ThorData SERP的项目。
{% endstep %}

{% step %}
**创建Rules目录**

在项目根目录创建：

<kbd>.cursor/rules</kbd>

如果该目录已经存在，可以直接使用。
{% endstep %}

{% step %}
**创建规则文件**

在 <kbd>.cursor/rules</kbd> 目录中创建：

<kbd>thordata-serp-mcp.mdc</kbd>

完整路径应为：

<kbd>.cursor/rules/thordata-serp-mcp.mdc</kbd>
{% endstep %}

{% step %}
**写入 SKILL.md 内容**

打开：

<kbd>thordata-serp-mcp/SKILL.md</kbd>

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

<kbd>.cursor/rules/thordata-serp-mcp.mdc</kbd>

保存后，Cursor即可将这份skill作为当前项目的规则使用。
{% endstep %}

{% step %}
**补充详细规则（可选）**

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

如需更完整的行为约束，可以打开：

<kbd>thordata-serp-mcp/references/serp-rules.md</kbd>

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

<kbd>.cursor/rules/thordata-serp-mcp.mdc</kbd>

如果只是基础使用，仅复制<kbd>SKILL.md</kbd>通常已经足够。
{% endstep %}

{% step %}
**重新加载项目**

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

如需确保规则生效，可以关闭并重新打开当前项目。
{% endstep %}

{% step %}
**验证规则是否生效**

在 Cursor Chat 中输入：

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

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

<details>

<summary><strong>验证标准</strong></summary>

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

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

• 保留来源连结

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

• 不编造搜索结果

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

</details>
{% endstep %}
{% endstepper %}

**常见问题**

Cursor 是否可以直接读取原始 SKILL.md？&#x20;

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

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

为什么不使用简化规则模板？&#x20;

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

是否需要加入 serp-rules.md？&#x20;

<kbd>serp-rules.md</kbd> 是补充规则文件，不是必需项。

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

Cursor 提示无法搜索怎么办？&#x20;

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

如何只让当前项目使用该规则？&#x20;

将规则放在当前项目的：

<kbd>.cursor/rules/thordata-serp-mcp.mdc</kbd>

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

**如何卸载**

如需移除该skill规则，删除以下文件即可：

<kbd>.cursor/rules/thordata-serp-mcp.mdc</kbd>

{% hint style="success" icon="puzzle-piece" %}
删除规则文件不会删除或修改任何MCP工具配置。
{% endhint %}