如何在 SerpApi MCP 中使用 SerpApi 引擎模式来提升工具调用质量

Source: Dev.to

快速回顾：SerpApi MCP 在您的工作流中

SerpApi MCP 让您可以将 AI 工具（如 Claude Desktop、Cursor、VS Code MCP 兼容扩展，或您自定义的 AI 代理）直接连接到 SerpApi 的实时搜索基础设施。

配置完成后，您的 AI 助手可以：

• 发现可用的搜索引擎
• 使用结构化参数调用 search 工具
• 接收标准化的 JSON 结果

如果您尚未设置，需要一个 SerpApi API 密钥。您可以在 此处 获取。

将 SerpApi MCP 添加到您的 MCP 配置中：

{
  "mcpServers": {
    "serpapi": {
      "url": "https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

连接成功后，您的 AI 助手即可立即开始与 SerpApi 工具和资源交互。

新功能：将引擎模式（Engine Schemas）作为 MCP 资源

以前，LLM 必须猜测每个 SerpApi 引擎接受的参数，或依赖硬编码的知识。
现在，每个引擎都会将自己的模式作为 MCP 资源公开。

这意味着什么

通过新功能，MCP 提供：

• 可用引擎的列表
• 每个引擎的详细参数模式

概念示意：

每个模式描述：

• 参数名称
• 数据类型
• 可选字段与必填字段
• 参数说明

这为 AI 代理提供了每个引擎的实时合同。

如何通过引擎模式提升工具调用质量

此升级在构建 AI 驱动的集成时解决了多个真实场景问题。

1. 不再需要猜测参数名称
   代理不必再自行编造 origin 或 destination 等字段，而是可以直接看到真实的 API 字段，例如：

   • departure_id
   • arrival_id
   • departure_date

2. 针对引擎的专属优化
   每个 SerpApi 引擎都有其独特功能。模式让助手能够：

   • 为 Google Flights 使用航班专属过滤器
   • 为 Google Shopping 使用价格区间
   • 为 Google News 使用主题标记

3. 减少请求失败
   当参数直接依据模式生成时：

   • 避免无效参数
   • 更早检测缺失的必填字段
   • 请求变得确定且可重复

4. 提升开发者体验
   在 VS Code 等 IDE 中，模式可实现：

   • 更好的提示对齐
   • 更智能的自动补全
   • 自文档化的集成

示例：使用 Google Flights 与 MCP 引擎模式

让我们通过一个真实案例来演示。假设你希望你的 AI 助手搜索从旧金山 (SFO) 到纽约 (JFK) 的往返航班。

步骤 1 – 发现可用引擎

serpapi://engines

响应中包含（除此之外）：

• google_search
• google_news
• google_shopping
• google_flights

代理选择 google_flights。

步骤 2 – 加载 Google Flights 模式

serpapi://engines/google_flights

返回的模式列出了支持的参数，例如：

• departure_id
• arrival_id
• departure_date
• return_date
• currency
• travel_class

现在助手准确了解 Google Flights 接受哪些参数。

步骤 3 – 发起结构化搜索调用

{
  "name": "search",
  "arguments": {
    "params": {
      "engine": "google_flights",
      "departure_id": "SFO",
      "arrival_id": "JFK",
      "departure_date": "2026-03-15",
      "return_date": "2026-03-20",
      "currency": "USD"
    }
  }
}

由于参数符合模式：

• 请求有效
• 不涉及字段猜测
• 结果会立即返回

响应中包含结构化的航班数据（价格、航空公司、时长、经停等）。

示例：使用 Google 购物进行商品搜索

模式在商品搜索中同样强大。假设你想查找价格低于 100 美元的无线耳塞。

加载引擎模式

serpapi://engines/google_shopping

你会看到以下参数：

• q
• min_price
• max_price
• gl（地理位置）
• hl（语言）

执行搜索

{
  "name": "search",
  "arguments": {
    "params": {
      "engine": "google_shopping",
      "q": "wireless earbuds",
      "min_price": 10,
      "max_price": 100,
      "gl": "us",
      "hl": "en"
    }
  }
}

该模式确保请求格式正确，减少错误并提升返回的商品列表的相关性。

✅ 检查清单

• 使用了正确的过滤字段
• 查询结构与引擎匹配
• 响应干净且可预测

在 VS Code 中使用模式

VS Code 是最受欢迎的 MCP‑powered 工作流环境之一。

配置了 SerpApi MCP 后，您可以：

• 动态加载引擎模式
• 生成有效的工具调用
• 在不切换标签页的情况下迭代搜索逻辑

示例工作流

• “查找低于 500 美元的最便宜航班”
• “追踪购物价格下降”
• “按主题监控突发新闻”

所有这些均由实时、基于模式的请求驱动。

摘要：为何此功能重要

通过将引擎模式公开为 MCP 资源，SerpApi MCP 变得：

• 更可靠
• 更友好于开发者
• 更适合自动化

您将获得：

• 精准的参数生成
• 引擎感知的 AI 行为
• 更低的错误率
• 更快的集成周期

这使 SerpApi MCP 成为面向 AI 代理的 自描述 API 层。

今日开始

1. 创建 SerpApi 账户
2. 使用您的 API 密钥启用 MCP
3. 从 VS Code、Claude Desktop 或 Cursor 进行连接

开始探索：

serpapi://engines

如果您正在构建依赖搜索、购物数据、旅行数据或新闻情报的 AI 驱动工具——引擎模式将显著提升您集成的质量和可靠性。