> For the complete documentation index, see [llms.txt](https://docs.talordata.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.talordata.com/cn-tw/serp-api/integration/mcp-integration/hermes-agent-ji-cheng/hermes-agent-mcp-ji-cheng.md).

# Hermes Agent MCP 集成

將 Hermes 代理與 TalorData SERP MCP 相連，讓您的代理可獲取即時且結構化的公開搜尋結果。TalorData 可支援網路研究、新聞監控、本地企業發現、產品與價格調查、SEO 可見性檢測及其他依賴 SERP 的工作流程。

## 先決條件

開始之前，請確保您擁有：

* 一個擁有有效 SERP API 密鑰的 TalorData 記帳。
* 可新增 MCP 伺服器的 Hermes Agent 安裝。
* 存取 Hermes Agent 配置檔案的權限。

{% stepper %}
{% step %}

## 取得您的 TalorData API 密鑰

登入 [TalorData 面板](https://dashboard.talordata.com/zh-tw/dashboard/)，並建立或複製一個 SERP API 密鑰。

{% hint style="warning" %}
請將此金鑰保密。它會用於MCP伺服器網址，並消耗您TalorData SERP API計畫的配額。
{% endhint %}
{% endstep %}

{% step %}

## 開啟 Hermes 配置檔案

開啟 Hermes 配置檔案：

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

如果檔案不存在，請先運行一次 `hermes` 以完成初始設定，然後再重新開啟該檔案。
{% endstep %}

{% step %}

## 新增 TalorData SERP MCP

將以下其中一個項目加入您的 MCP 客戶端設定中，並以 `YOUR_USER_TOKEN` 替換為您的個人令牌。

### 方法一：建議使用標題

適用於支援自訂標頭的 MCP 客戶。

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

### 方法二：當不支援標頭時，使用路徑令牌

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

{% hint style="info" %}
僅使用一種方法。如果您的設定中已包含 `mcpServers`，請在其中添加 `talordata` 的條目即可，不要新增第二個 `mcpServers` 檔案，也不要替換現有的伺服器條目。
{% endhint %}
{% endstep %}

{% step %}

## 驗證連線

啟動新的 Hermes Agent 會話，並發送請求，例如：

```
使用 TalorData SERP 查找關於 AI 閃探的五篇最新新聞文章。  
為每篇文章返回標題、發行單位、發布時間、來源網址以及一段簡短摘要。
```

當連線正常時，Hermes Agent 应該呼叫 TalorData 搜尋工具，並返回包含來源網址的即時結果。具體可用的工具與結果類型取決於您的 TalorData 計畫以及所選的搜尋引擎。
{% endstep %}
{% endstepper %}

## 範例提示

### 市場研究

```
使用 TalorData SERP 比較美國頂尖的五家 AI 會議助手競爭對手。  
包含公司名稱、定位、價格訊號及來源連結
```

### 新聞監控

```
使用 TalorData SERP 查找過去 24 小時內關於 OpenAI 的新聞。
按主題分組結果，並包含原始文章的網址。
```

### 本地商業研究

```
使用 TalorData SERP 查找德克薩斯州奧斯汀市評價極高的共享辦公空間。  
請返回企業名稱、評分、評論數量、地址、網站及來源連結。
```

### SEO 可見性檢查

```
使用 TalorData SERP 檢查美國「AI agent platform」在 Google 搜尋結果中的內容。  
確認 example.com 是否出現在自然搜尋結果中，並報告其排名位置。
```

## TalorData SERP MCP 能幫助 Hermes Agent 做什麼

TalorData SERP MCP 提供跨支援引擎與結果類型的結構化即時公共搜尋資料，包括：

* 網頁、新聞、圖片與影片搜尋
* 本地與地圖結果
* 購物與產品研究
* SEO 排名與競爭對手分析
* Google 財務、航班、飯店、工作、學術、趨勢、專利及 Google Play 結果（支援時）
* Google、Bing、Yandex 及 DuckDuckGo 搜尋工作流程（支援時）

請赫爾墨斯代理保留原始連結，並在結果相關時，明確標示搜尋國家、語言、新鮮度窗口及其他查詢條件。

## 故障排除

<details>

<summary>TalorData 工具未顯示</summary>

確認 URL 中包含有效的 TalorData API 密鑰，YAML 檢印格式正確，且 `talordata_serp` 資料嵌套於 `mcp_servers` 下。儲存設定後，重新啟動 Hermes Agent。

</details>

<details>

<summary>驗證或配額錯誤</summary>

若現有 API 隱碼無效或已停用，請在 TalorData 管理面板中創建新的 SERP API 隱碼。在重試請求前，請先確認您的訂閱方案及剩餘配額。

</details>

<details>

<summary>搜尋結果為空</summary>

空結果不一定是整合錯誤。請嘗試更廣泛的查詢、其他國家或語言，或使用不同的支援結果類型。

</details>

<details>

<summary>所要求的搜尋類型失敗</summary>

某些搜尋類型需要特定的參數，例如位置、日期範圍、圖片網址或目標網域。請要求 Hermes Agent 使用支援的 TalorData SERP 搜尋結果類型，並提供所需的查詢條件。

</details>

## 安全與使用說明

* 請勿將您的 TalorData API 隱碼貼入提示語、共享的截圖、公共儲存庫或客戶端程式碼中。
* 僅限於使用 TalorData 進行公開搜尋結果資料，並遵守適用的法律、平台條款以及內部資料使用政策。
* 搜尋結果受時間與地點影響，因此在需要可追溯性的報告中，請保留原始網址與查詢條件。