> 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/kuai-su-kai-shi-zhi-nan.md).

# 快速开始指南

使用 API Token 配置 Thordata MCP Server，连接远程 MCP 端点，完成请求身份验证，并使用搜索、历史记录和统计工具。

{% stepper %}
{% step %}
**在开始之前，请确保你具备以下条件：**

<table data-view="cards"><thead><tr><th></th><th data-type="image"></th><th></th></tr></thead><tbody><tr><td><a href="https://dashboard.thordata.com/"><strong>Thordata账户</strong></a></td><td></td><td><em>注册帐户即可获取5000次免费SERP API请求。</em></td></tr><tr><td><a href="https://dashboard.talordata.com/scraping/serp-api/api-token"><strong>Thordata API Token</strong></a></td><td></td><td><em>在SERP API仪表板获取API密钥。</em></td></tr></tbody></table>
{% endstep %}

{% step %}
**使用以下端点连接到远程MCP服务器**

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

{% endstep %}
{% endstepper %}

**认证**

支持三种方法：

1. **路径型（推荐）:** <kbd><mark style="color:red;">/{YOUR\_API\_TOKEN}/mcp<mark style="color:red;"></kbd>
2. **Authorization 头:** <kbd><mark style="color:red;">Authorization: Bearer YOUR\_API\_TOKEN<mark style="color:red;"></kbd>
3. **自定义头:** <kbd><mark style="color:red;">X-Thor-Serp-Token: YOUR\_API\_TOKEN<mark style="color:red;"></kbd>

> 示例:

**路径型**

```
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 '...'
```

{% hint style="info" %}
注意: GET / 和 GET /healthz 端点无需认证。
{% endhint %}

**工具**

**1.list\_engines**

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

参数：无

示例: <kbd>{"name": "list\_engines"}</kbd>

**2.search**

执行 SERP 搜索请求。使用 <kbd>thor://engines</kbd> 下的资源查看各引擎的具体参数后再调用此工具。

参数:

<kbd>engine</kbd> (可选): 引擎标识，例如 google, google\_images, bing\_images, duckduckgo。

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

<kbd>params</kbd> (必填): 引擎特定参数对象，需匹配对应引擎的Schema资源定义。

<kbd>json</kbd>（可选）：上游响应格式。 json->1，json-html->2，html->3。

<kbd>response\_mode</kbd> (可选): complete 返回完整响应，compact 移除常见元数据字段。默认：complete

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

<details>

<summary>Google (25)</summary>

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

</details>

<details>

<summary>Bing (6)</summary>

Search, Images, Maps, News, Shopping, Videos

</details>

<details>

<summary>Yandex (1)</summary>

Search

</details>

<details>

<summary>DuckDuckGo (1)</summary>

Search

</details>

> 示例:

```
{"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使用历史记录。

参数:

<kbd>page</kbd> (可选): 页码，默认1

<kbd>page\_size</kbd> (可选): 每页大小，常用20/50/100

<kbd>search\_query</kbd>(可选): 按搜索关键词筛选

<kbd>search\_engine</kbd> (可选): 按搜索引擎显示名称筛选

<kbd>status</kbd> (可选): 状态筛选。 可选值：all, success, error

<kbd>start\_time</kbd> (可选): 起始时间（Unix时间戳，秒）

<kbd>end\_time</kbd> (可选): 结束时间（Unix时间戳，秒）

<kbd>timezone</kbd> (可选): 时区，例如 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使用统计数据。

参数：

<kbd>start\_date</kbd> (必填): 起始日期，格式 YYYY-MM-DD

<kbd>end\_date</kbd> (必填): 结束日期，格式 YYYY-MM-DD

<kbd>engines</kbd> (可选): 引擎筛选，逗号分隔的字符串或字符串数​​组

<kbd>timezone</kbd> (可选): 时区偏移，例如 +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 资源**

* 索引资源： <kbd>thor://engines</kbd>

返回所有引擎的列表、分类和资源URI。

* 引擎Schema资源： <kbd>thor://engines/{engine\_key}</kbd>

返回特定引擎的完整参数Schema定义，用于在调用search工具前了解可用参数。

**HTTP 路由**

1. <kbd>GET /</kbd> 返回服务基本信息（无需认证）
2. <kbd>GET /healthz</kbd> 健康检查（无需认证）
3. <kbd>POST /mcp</kbd> MCP 协议端点（需要认证）

如需更多协助，请透过 **线上客服** 或电邮 [**support@thordata.com**](mailto:support@thordata.com) 联络我们。