光标
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
如果需要執行真實搜索,還需要在Cursor中配寘可用的ThorData SERP MCP工具。 skill只提供規則,不負責完成MCP工具配寘。
項目規則與全局規則
建議優先使用項目規則。
項目規則只作用於當前項目,適合測試、團隊协作和按項目管理,也便於後續删除或調整。
當多個Cursor項目都需要使用同一套ThorData SERP規則時,再考慮將規則加入全局規則。
配寘步驟
打開項目
在Cursor中打開需要使用ThorData SERP的項目。
創建Rules目錄
在項目根目錄創建:
.cursor/rules
如果該目錄已經存在,可以直接使用。
創建規則文件
在 .cursor/rules 目錄中創建:
thordata-serp-mcp.mdc
完整路徑應為:
.cursor/rules/thordata-serp-mcp.mdc
寫入 SKILL.md 内容
打開:
thordata-serp-mcp/SKILL.md
將 SKILL.md 中的內容複製到:
.cursor/rules/thordata-serp-mcp.mdc
保存後,Cursor即可將這份skill作為當前項目的規則使用。
補充詳細規則(可選)
references/serp-rules.md 是該skill的補充規則文件,包含更細的engine/type校驗、降級策略、批量任務、錯誤處理和隱私邊界說明。
如需更完整的行為約束,可以打開:
thordata-serp-mcp/references/serp-rules.md
將其中需要的內容追加到:
.cursor/rules/thordata-serp-mcp.mdc
如果只是基礎使用,僅複製SKILL.md通常已經足够。
重新加載項目
保存規則文件後,Cursor通常會自動讀取規則。
如需確保規則生效,可以關閉並重新打開當前項目。
驗證規則是否生效
在 Cursor Chat 中輸入:
使用 Thordata SERP 搜索 OpenAI 的最新新聞,並返回標題、來源、發佈時間和連結。
如果配寘成功,Cursor AI應能識別這是ThorData SERP新聞搜索場景,並在回答中關注來源連結、發佈時間和查詢条件。
常見問題
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
删除規則文件不會删除或修改任何MCP工具配寘。
Last updated
Was this helpful?