> 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/fa-dian.md).

# 法典

thordata-serp-mcp Skill =让Codex知道如何正确使用ThorData SERP MCP的说明书

**概述**

将thordata-serp-mcp skill放入Codex的skills文件夹后，Codex就能在处理ThorData SERP相关问题时，自动参考这份skill的规则。

本教程适合第一次安装Codex skill的用户。 您只需要复制一个文件夹、重启Codex，然后用一句测试问题确认是否生效。

> Codex会自动读取本机skills文件夹里的skill。 您不需要修改代码，也不需要在本文档中配置MCP服务。

**要求**

• 已安装Codex Desktop或Codex CLI

• 已准备好<kbd>thordata-serp-mcp</kbd>文件夹

• Codex中已经配置好ThorData SERP MCP工具

{% hint style="warning" %}
如果第三项还没有完成，skill仍然可以安装，但Codex不能真正发起ThorData SERP搜索。
{% endhint %}

**如何安装这个Skill**

{% stepper %}
{% step %}
**找到Codex的skills文件夹**

Windows 通常是：

C:\Users\你的用户名.codex\skills

例如：

<kbd>C:\Users\user.codex\skills</kbd>

如果没有<kbd>.codex</kbd>或<kbd>skills</kbd>文件夹，可以手动新建\*。 \*
{% endstep %}

{% step %}
**复制skill文件夹**

把整个<kbd>thordata-serp-mcp</kbd>文件夹复制到skills文件夹中。

复制完成后应该类似这样：

C:\Users\user.codex\skills\
`-- thordata-serp-mcp\ |-- SKILL.md |-- agents\ |` -- openai.yaml `-​​- references\` -- serp-rules.md

{% hint style="info" %}
请注意：要复制整个<kbd>thordata-serp-mcp</kbd>文件夹，不是只复制里面的<kbd>SKILL.md</kbd>。
{% endhint %}
{% endstep %}

{% step %}
**重启Codex**

关闭Codex Desktop，然后重新打开。

如果您使用Codex CLI，请退出当前会话，再重新打开一个新会话。
{% endstep %}

{% step %}
**测试是否生效**

在Codex中输入：

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

如果安装成功，Codex会识别这是ThorData SERP相关任务，并按照skill的规则处理。
{% endstep %}
{% endstepper %}

**何时使用这个Skill**

* 在Codex中使用ThorData SERP MCP搜索公开结果
* 查询新闻、网页、图片、视频、购物、地图、本地商​​家、学术或趋势内容
* 做SEO排名检查、价格监控、本地商家调研或批量搜索任务
* 希望Codex保留来源连结、查询条件和时间戳

**常见问题**

<details>

<summary><strong>Codex 没有使用这个 skill</strong></summary>

• 确认文件夹已放入C:\Users\你的用户名.codex\skills

• 确认文件夹名是<kbd>thordata-serp-mcp</kbd>

• 确认文件夹里有<kbd>SKILL.md</kbd>

• 确认复制后已经重启 Codex

• 确认您的问题和ThorData SERP、搜索结果、新闻、购物、地图或SEO排名有关

</details>

<details>

<summary><strong>Codex 说不能搜索</strong></summary>

这通常不是skill安装失败。\
skill只负责告诉Codex“应该怎么使用ThorData SERP”。 真正搜索还需要ThorData SERP MCP工具已经在Codex中配置好。

</details>

<details>

<summary><strong>返回结果少了一些字段</strong></summary>

这是正常的。\
这个skill会要求Codex只展示真实返回的字段。如果搜索结果里没有价格、评分、电话、地址或发布时间，Codex不应该自己猜。

</details>

<details>

<summary><strong>如何卸载</strong></summary>

删除这个文件夹：

C:\Users\你的用户名.codex\skills\thordata-serp-mcp

然后重启 Codex。

{% hint style="success" icon="thumbtack-angle" %}
删除 skill 不会影响已经配置好的MCP工具。
{% endhint %}

</details>
