快速開始指南

使用 API Token 配置 Thordata MCP Server，連接遠端 MCP 端點，完成請求身分驗證，並使用搜尋、歷史記錄和統計工具。

1

在開始之前，請確保你具備以下條件：

Thordata账户

注册帳戶即可獲取5000次免費SERP API請求。

Thordata API Token

在SERP API儀錶板獲取API密钥。

2

使用以下端點連接到遠程MCP服務器

{
  "mcpServers": {
    "thordata": {
      "type": "http",
      "url": "https://mcp.thordata.com/YOUR_API_TOKEN/mcp"
    }
  }
}

認證

支持三種方法：

1. 路徑型（推薦）: /{YOUR_API_TOKEN}/mcp

2. Authorization 头: Authorization: Bearer YOUR_API_TOKEN

3. 自定義頭: X-Thor-Serp-Token: YOUR_API_TOKEN

示例:

路徑型

curl "https://mcp.thordata.com/your_token/mcp" -d '...'

Authorization 头

curl "https://mcp.thordata.com/mcp" -H "Authorization: Bearer your_token" -d '...'

自定義頭

curl "https://mcp.thordata.com/mcp" -H "X-Thor-Serp-Token: your_token" -d '...'

注意: GET / 和 GET /healthz 端点无需认证。

工具

1.list_engines

列出所有支持的搜索引擎、分類和資源URI。

參數：無

示例: {"name": "list_engines"}

2.search

執行 SERP 搜索请求。使用 thor://engines 下的資源查看各引擎的具體參數後再調用此工具。

参数:

engine (可選): 引擎标识，例如 google, google_images, bing_images, duckduckgo。

如果不提供，使用 params 中的 engine 字段或默認引擎。

params (必填): 引擎特定參數對象，需匹配對應引擎的Schema資源定義。

json（可選）：上游响应格式。 json->1，json-html->2，html->3。

response_mode (可選): complete 返回完整响应，compact 移除常見元数据字段。默認：complete

支持的搜索引擎（共 33 個）:

Google (25)

Search, Finance, Finance Markets, Flights, Hotels, Images, Jobs, Lens, Local, Maps, News, Patents, Patents Details, Play Search, Play Books, Play Games, Play Movies, Play Product, Scholar, Scholar Author, Scholar Cite, Shopping, Trends, Videos, Web

Bing (6)

Search, Images, Maps, News, Shopping, Videos

Yandex (1)

Search

DuckDuckGo (1)

Search

示例:

{"name": "search", "arguments": {"engine": "google", "params": {"q": "coffee shops", "location": "Austin, TX"}}} 
{"name": "search", "arguments": {"engine": "google", "params": {"q": "weather in London"}}} 
{"name": "search", "arguments": {"engine": "google", "params": {"q": "AAPL stock"}}} 
{"name": "search", "arguments": {"engine": "duckduckgo", "params": {"q": "car"}}} 
{"name": "search", "arguments": {"engine": "bing", "params": {"q": "latest news"}, "response_mode": "compact"}}

結果類型：答案框、自然結果、新聞、圖片、購物、知識卡片——由上游API自動檢測並格式化。

3.history

査詢SERP使用歷史記錄。

参数:

page (可選): 頁碼，默認1

page_size (可選): 每頁大小，常用20/50/100

search_query(可選): 按搜索关键词篩選

search_engine (可選): 按搜索引擎顯示名稱篩選

status (可選): 狀態篩選。 可選值：all, success, error

start_time (可選): 起始時間（Unix時間戳，秒）

end_time (可選): 結束時間（Unix時間戳，秒）

timezone (可選): 時區，例如 Asia/Shanghai 或 +08:00

示例:

{"name": "history", "arguments": {"page": 1, "page_size": 20}} 
{"name": "history", "arguments": {"search_query": "coffee", "status": "success"}} 
{"name": "history", "arguments": {"start_time": 1700000000, "end_time": 1700100000, "timezone": "Asia/Shanghai"}}

4.statistics

査詢SERP使用統計数据。

參數：

start_date (必填): 起始日期，格式 YYYY-MM-DD

end_date (必填): 結束日期，格式 YYYY-MM-DD

engines (可選): 引擎篩選，逗號分隔的字符串或字符串數組

timezone (可選): 時區偏移，例如 +00:00, +08:00, -05:00

示例:

{"name": "statistics", "arguments": {"start_date": "2025-01-01", "end_date": "2025-01-31"}} 
{"name": "statistics", "arguments": {"start_date": "2025-01-01", "end_date": "2025-01-31", "engines": "google,bing"}} 
{"name": "statistics", "arguments": {"start_date": "2025-01-01", "end_date": "2025-01-31", "timezone": "+08:00"}}

MCP 資源

• 索引資源： thor://engines

返回所有引擎的列表、分類和資源URI。

• 引擎Schema資源： thor://engines/{engine_key}

返回特定引擎的完整參數Schema定義，用於在調用search工具前瞭解可用參數。

HTTP 路由

1. GET / 返回服務基本信息（無需認證）

2. GET /healthz 健康檢查（無需認證）

3. POST /mcp MCP 協议端點（需要認證）

如需更多協助，請透過 線上客服 或電郵 [e-mail] 聯絡我們。