> 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-hk/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？**

不建議依賴Cursor自動讀取原始**SKILL.md**。

Cursor的規則入口是<kbd>.cursor/rules/\*.mdc</kbd>。為了確保規則穩定生效，應將 <kbd>SKILL.md</kbd> 內容複製到 <kbd>.cursor/rules/thordata-serp-mcp.mdc</kbd>。

**為什麼不使用簡化規則模板？**

<kbd>SKILL.md</kbd>是該skill的主規則來源。 直接複用<kbd>SKILL.md</kbd>可以减少規則分叉，避免教程中的簡化規則與原始skill後續不一致。

**是否需要加入 serp-rules.md？**

<kbd>serp-rules.md</kbd> 是補充規則文件，不是必需項。

建議先接入<kbd>SKILL.md</kbd>。 當任務需要更細的 <kbd>engine/type</kbd> 校驗、降級規則、批量任務規則或錯誤處理規則時，再追加 <kbd>references/serp-rules.md</kbd> 中的相關內容。

**Cursor 提示無法搜索怎麼辦？**

這通常不是規則接入失敗。\
Rules只告訴Cursor AI如何處理ThorData SERP任務。 真實搜索需要**ThorData SERP MCP**工具已經在Cursor中配寘完成。

**如何只讓當前項目使用該規則？**

將規則放在當前項目的：

<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 %}