searchapi-mcp-server

searchapi-mcp-server

npx @ahmednsh/searchapi-mcp-server

将 SearchApi.io 封装为四种工具的 MCP 服务：Google 搜索、Google 购物、Google 职位和 YouTube 搜索。结果以紧凑的结构化文本返回，专为大模型上下文设计——优先提供直接答案，不返回原始 JSON。

社区项目，与 SearchApi.io 无关联，也未获得其认可。 “SearchApi” 是其各自所有者的商标。

Claude Desktop 配置

在 searchapi.io 获取 API 密钥，然后将服务添加到 claude_desktop_config.json（Windows 上为 %AppData%\Claude\，macOS 上为 ~/Library/Application Support/Claude/）：

{
  "mcpServers": {
    "searchapi": {
      "command": "npx",
      "args": ["-y", "@ahmednsh/searchapi-mcp-server"],
      "env": {
        "SEARCHAPI_API_KEY": "your-api-key"
      }
    }
  }
}

重启 Claude Desktop。四种工具会显示在“searchapi”服务下。

工具

google_search

q（必填）、num（1–20，默认值为 10）、gl（国家代码，例如 sa）、hl（语言代码，例如 ar）。

只要 Google 返回直接答案功能（答案框、知识图谱、AI 概览），就会将其置于自然搜索结果之前：

Search results for "capital of Saudi Arabia":

---

[Answer box]
Saudi Arabia Capital: Riyadh

---

1. Riyadh
   https://en.wikipedia.org/wiki/Riyadh
   Riyadh is the capital and largest city of Saudi Arabia. It is also the capital of the Riyadh Province and the centre of the Riyadh Governorate.
2. Riyadh | Population, Climate, Map, History, & Facts
   https://www.britannica.com/place/Riyadh
   Riyadh is Saudi Arabia's capital and largest city. It became the capital of the Saud dynasty in 1824 and, except for a brief period in the ...

google_shopping

q（必填）、gl（国家代码）、include_links（布尔值，默认值为 false）。

Shopping results for "wireless mouse" (showing 10 of 40):

1. Logitech M220 Silent Wireless Mouse
   $13.83 — Walmart — 4.8★ (44,000 reviews)
   Free 90-day returns
2. Logitech G305 Lightspeed Wireless Gaming Mouse
   $29.99 — Target — 4.6★ (8,100 reviews)
   30-day returns

google_jobs

q（必填）、location（例如 "Riyadh, Saudi Arabia"）。

Job results for "software engineer" in "Riyadh, Saudi Arabia":

1. Senior Software Engineer - Backend — Delivery Hero
   Riyadh Saudi Arabia · via Delivery Hero
   No degree mentioned
   Apply: https://careers.deliveryhero.com/job/senior-software-engineer-backend-in-riyadh-saudi-arabia-jid-7417
   About the opportunity We are looking for a highly talented Senior Backend Engineer to join our Riyadh office. If you are looking for a place where ...

youtube_search

q（必填）。

YouTube results for "model context protocol tutorial":

1. Model Context Protocol Clearly Explained | MCP Beyond the Hype
   https://www.youtube.com/watch?v=tzrwxLNHtRY
   codebasics ✓ — 557,404 views — 15:04 — 1 year ago
   This video contains a very simple explanation of MCP, also known as Model Context Protocol. We will first understand what ...
2. What is MCP? Integrate AI Agents with Databases & APIs
   https://www.youtube.com/watch?v=eur8dUO9mvE
   IBM Technology ✓ — 684,035 views — 3:46 — 1 year ago
   Dive into the world of Model Context Protocol and learn how to seamlessly connect AI agents to databases, APIs, and more.

开发者须知

• 错误语义： 工具执行失败（缺少或无效的密钥、HTTP 429/4xx/5xx、网络错误）时，会返回一条易读消息并设置 isError: true，让客户端和模型能够区分调用失败与搜索内容。“无结果”不是错误——空搜索也算成功，消息会提示模型更换关键词，而不是重试。
• google_shopping 的 include_links 默认关闭，因为 Google 购物的商品链接是约 500 个字符的跟踪 URL，指向 Google 而非商家；结果会显示卖家名称。如有需要，请设置 include_links: true。
• 输出上限： 每次调用最多返回 10 条结果（截断时，标题会显示 showing 10 of N）；职位描述会移除 HTML，并截断至 250 个字符。
• 布局： src/index.ts 用于注册工具并与 SearchApi 通信；src/format.ts 包含纯粹的响应转文本格式化函数，并在 src/format.test.ts 中进行单元测试（npm test）。

开发

git clone https://github.com/Ahmednsh/searchapi-mcp-server.git && cd searchapi-mcp-server && npm install && npm run build

npm test

许可证

MIT