MCP Server 快速開始指南

依照快速開始教學設定 Talordata MCP Server，連接 API Token 並測試搜尋數據工具。

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

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

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

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

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

認證

支持三種方法：

路徑型（推薦）: /{YOUR_API_TOKEN}/mcp
Authorization 头: Authorization: Bearer YOUR_API_TOKEN
自定義頭: X-Talor-Serp-Token: YOUR_API_TOKEN

示例:

路徑型

curl "https://mcp.talordata.net/your_token/mcp" -d '...'

Authorization 头

curl "https://mcp.talordata.net/mcp" -H "Authorization: Bearer your_token" -d '...'

自定義頭

curl "https://mcp.talordata.net/mcp" -H "X-Talor-Serp-Token: your_token" -d '...'

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

工具

1.list_engines

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

參數：無

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

2.search

執行 SERP 搜索请求。使用 talor://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)

DuckDuckGo (1)

示例:

{"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 資源

索引資源： talor://engines

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

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

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

HTTP 路由

GET / 返回服務基本信息（無需認證）
GET /healthz 健康檢查（無需認證）
POST /mcp MCP 協议端點（需要認證）

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

最后更新于 20天前