快速开始指南

使用 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] 联络我们。