JustSerpAPI MCP Server 教程：讓 AI 助手搜尋、檢查並呼叫 SERP API

MCP 是什麼

MCP 是 Model Context Protocol 的縮寫。它為 AI 客戶端提供一種標準方式，用來連接外部工具和 API。放到 SERP API 工作流中，這代表你的助手不只會解釋請求，還可以發現可用端點、檢查必填參數、呼叫 API，並在回應包含下一頁 token 或 offset 時繼續取得分頁結果。

JustSerpAPI MCP Server 會把 JustSerpAPI 暴露給 Codex、Claude Desktop、Cursor、Claude Code、OpenAI Agents SDK 以及其他 MCP 相容的 AI 助手工具。

JustSerpAPI MCP 能幫你做什麼

• 根據自然語言請求找到合適的 Google Search、Google Maps、Google Trends、Google Shopping 或 Web 端點。
• 呼叫前檢查必填參數、可選參數、列舉值和分頁提示。
• 使用你的 API key 呼叫選定的 JustSerpAPI 端點，並回傳原始 JSON 資料。
• 當上一次回應包含下一頁 token 或 offset 時，繼續取得分頁結果。
• 查詢訂閱狀態、剩餘 credits、最近 API 使用量、已消耗 credits 和端點趨勢。
• 讓助手解釋常見 API 錯誤，例如 402 回應。

準備 JustSerpAPI API key

使用 MCP 之前，請先準備 JustSerpAPI API key。登入 JustSerpAPI Dashboard，然後從帳戶或 API key 區域複製你的 key。

API key 是敏感資訊。不要提交到公開倉庫，不要放進截圖，也不要分享給不可信的人。請把範例中的 your_api_key 替換成你的真實 key。

推薦設定：Remote HTTP

Remote HTTP 是推薦方式。你不需要在本地執行伺服器，只需把託管的 MCP URL 和 Authorization header 加到 MCP 客戶端設定。

{
  "mcpServers": {
    "justserpapi": {
      "url": "https://mcp.justserpapi.com/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

儲存設定後，重新啟動或重新整理 MCP 客戶端。任何支援 Remote HTTP MCP server 的客戶端都可以透過這個 URL 連接 JustSerpAPI MCP。

替代設定：本地 stdio

如果你的客戶端更適合使用本地命令式 MCP server，可以透過 npx 在本地執行。

{
  "mcpServers": {
    "justserpapi": {
      "command": "npx",
      "args": ["-y", "justserpapi-mcp"],
      "env": {
        "JUSTSERPAPI_API_KEY": "your_api_key"
      }
    }
  }
}

這個設定會執行與 npx -y justserpapi-mcp 相同的本地命令，並透過 JUSTSERPAPI_API_KEY 傳入你的 key。

本地 stdio 適合你希望 MCP server 執行在自己機器上的情境。大多數使用者建議從 Remote HTTP 開始。

可以直接使用的提示詞

連線成功後，可以用正常業務語言提問。

Find the Google search API and show me the required parameters.

Search Google for "best running shoes" in the United States.

Find the Google Maps reviews endpoint and tell me how to request the next page.

Get Google Trends trending-now results for the US.

Find the Google Shopping search API and call it for "iphone 16 case".

Convert this web page to Markdown: https://example.com

Continue to the next page of the previous JustSerpAPI result.

Check my remaining JustSerpAPI credits.

Show my API usage for the last 30 days.

The API returned code 402. Explain what it means and what I should check.

推薦工作流

• 先讓助手為你的搜尋任務找到合適端點。
• 呼叫前讓它檢查 schema，尤其是位置、語言、裝置、分頁或結果類型會影響請求時。
• 查看必填欄位後再提供業務參數，不要讓助手猜測必填值。
• 如果回應包含分頁中繼資料，讓助手根據下一頁提示繼續請求。
• 呼叫失敗時，提供回應碼和錯誤資訊，方便助手結合端點 schema 和常見 API 行為判斷。

FAQ

API key 應該放在哪裡？

Remote HTTP 使用 Authorization: Bearer your_api_key header。本地 stdio 使用 JUSTSERPAPI_API_KEY 環境變數。

MCP 會取代 API 文件嗎？

不會。MCP 更適合讓 AI 助手在工作流中發現並呼叫 API。完整端點細節和欄位定義，仍然應該閱讀 API 文件。

助手可以呼叫所有 JustSerpAPI 端點嗎？

助手會透過你的 JustSerpAPI API key 呼叫 API。實際存取權限取決於你的帳戶、訂閱、剩餘 credits 和端點權限。呼叫前，建議讓助手展示它計畫使用的端點和參數。

下一步

如果你已經有 JustSerpAPI API key，可以先用 Remote HTTP 設定，然後讓 AI 客戶端為你常用的搜尋工作流找到一個端點。完整端點說明請開啟 JustSerpAPI 文件。原始碼和發布更新可以查看 JustSerpAPI MCP GitHub。