> 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/ji-cheng/mcp-ji-cheng/hermes-agent-ji-cheng/hermes-agent-mcp-ji-cheng.md).

# Hermes Agent MCP 集成

使用 API Token 和 MCP 配置将 Hermes Agent 连接到 Thordata SERP MCP，用于实时搜索、新闻监控、本地研究和 SEO 工作流。

#### 先决条件

开始之前，请确保您拥有：

* 一个拥有有效 SERP API 密钥的 ThorData 记帐。
* 可新增 MCP 伺服器的 Hermes Agent 安装。
* 存取 Hermes Agent 配置档案的权限。

{% stepper %}
{% step %}

#### 取得您的 ThorData API 密钥

登入 [ThorData 面板](https://dashboard.thordata.com/serp-api/get-started)，并建立或复制一个 SERP API 密钥。

{% hint style="warning" %}
请将此金钥保密。它会用于MCP伺服器网址，并消耗您ThorData SERP API计画的配额。
{% endhint %}
{% endstep %}

{% step %}

#### 开启 Hermes 配置档案

开启 Hermes 配置档案：

* Linux, macOS, 或者 WSL2: `~/.hermes/config.yaml`
* 原生 Windows: `%LOCALAPPDATA%\hermes\config.yaml`

如果档案不存在，请先运行一次 `hermes` 以完成初始设定，然后再重新开启该档案。
{% endstep %}

{% step %}

#### 新增 ThorData SERP MCP

将以下其中一个项目加入您的 MCP 客户端设定中，并以 `YOUR_USER_TOKEN` 替换为您的个人令牌。

**方法一：建议使用标题**

适用于支援自订标头的 MCP 客户。

```json
{
"mcpServers": {
"thordata": {
"url": "https://mcp.thordata.net/mcp",
"headers": {
"Authorization": "Bearer YOUR_USER_TOKEN"
}
}
}
}
```

**方法二：当不支援标头时，使用路径令牌**

```json
{
"mcpServers": {
"thordata": {
"type": "http",
"url": "https://mcp.thordata.net/YOUR_API_TOKEN/mcp"
}
}
}
```

{% hint style="info" %}
仅使用一种方法。如果您的设定中已包含 `mcpServers`，请在其中添加 `thordata` 的条目即可，不要新增第二个 `mcpServers` 档案，也不要替换现有的伺服器条目。
{% endhint %}
{% endstep %}

{% step %}

#### 验证连线

启动新的 Hermes Agent 会话，并发送请求，例如：

```
使用 ThorData SERP 查找关于 AI 闪探的五篇最新新闻文章。
为每篇文章返回标题、发行单位、发布时间、来源网址以及一段简短摘要。
```

当连线正常时，Hermes Agent 应该呼叫 ThorData 搜寻工具，并返回包含来源网址的即时结果。具体可用的工具与结果类型取决于您的 ThorData 计画以及所选的搜寻引擎。
{% endstep %}
{% endstepper %}

#### 范例提示

**市场研究**

```
使用 ThorData SERP 比较美国顶尖的五家 AI 会议助手竞争对手。
包含公司名称、定位、价格讯号及来源连结
```

**新闻监控**

```
使用 ThorData SERP 查找过去 24 小时内关于 OpenAI 的新闻。
按主题分组结果，并包含原始文章的网址。
```

**本地商业研究**

```
使用 ThorData SERP 查找德克萨斯州奥斯汀市评价极高的共享办公空间。
请返回企业名称、评分、评论数量、地址、网站及来源连结。
```

**SEO 可见性检查**

```
使用 ThorData SERP 检查美国「AI agent platform」在 Google 搜寻结果中的内容。
确认 example.com 是否出现在自然搜寻结果中，并报告其排名位置。
```

#### ThorData SERP MCP 能帮助 Hermes Agent 做什么

ThorData SERP MCP 提供跨支援引擎与结果类型的结构化即时公共搜寻资料，包括：

* 网页、新闻、图片与影片搜寻
* 本地与地图结果
* 购物与产品研究
* SEO 排名与竞争对手分析
* Google 财务、航班、饭店、工作、学术、趋势、专利及 Google Play 结果（支援时）
* Google、Bing、Yandex 及 DuckDuckGo 搜寻工作流程（支援时）

请赫尔墨斯代理保留原始连结，并在结果相关时，明确标示搜寻国家、语言、新鲜度窗口及其他查询条件。

#### 故障排除

<details>

<summary>ThorData 工具未显示</summary>

确认 URL 中包含有效的 ThorData API 密钥，YAML 检印格式正确，且 `thordata_serp` 资料嵌套于 `mcp_servers` 下。储存设定后，重新启动 Hermes Agent。

</details>

<details>

<summary>验证或配额错误</summary>

若现有 API 隐码无效或已停用，请在 ThorData 管理面板中创建新的 SERP API 隐码。在重试请求前，请先确认您的订阅方案及剩余配额。

</details>

<details>

<summary>搜寻结果为空</summary>

空结果不一定是整合错误。请尝试更广泛的查询、其他国家或语言，或使用不同的支援结果类型。

</details>

<details>

<summary>所要求的搜寻类型失败</summary>

某些搜寻类型需要特定的参数，例如位置、日期范围、图片网址或目标网域。请要求 Hermes Agent 使用支援的 ThorData SERP 搜寻结果类型，并提供所需的查询条件。

</details>

#### 安全与使用说明

* 请勿将您的 ThorData API 隐码贴入提示语、共享的截图、公共储存库或客户端程式码中。
* 仅限于使用 ThorData 进行公开搜寻结果资料，并遵守适用的法律、平台条款以及内部资料使用政策。
* 搜寻结果受时间与地点影响，因此在需要可追溯性的报告中，请保留原始网址与查询条件。