SerpApi MCP

Máy chủ SerpApi MCP

Một máy chủ triển khai Model Context Protocol (MCP) tích hợp với SerpApi để thu thập kết quả tìm kiếm toàn diện và trích xuất dữ liệu.

Tính năng

• Tìm kiếm đa công cụ: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay, và nhiều hơn nữa
• Tài nguyên công cụ: Lược đồ tham số cho từng công cụ có sẵn qua tài nguyên MCP (xem Công cụ Tìm kiếm)
• Dữ liệu thời tiết thời gian thực: Thời tiết dựa trên vị trí với dự báo qua truy vấn tìm kiếm
• Dữ liệu thị trường chứng khoán: Tài chính công ty và dữ liệu thị trường thông qua tích hợp tìm kiếm
• Xử lý kết quả động: Tự động phát hiện và định dạng các loại kết quả khác nhau
• Chế độ phản hồi linh hoạt: Phản hồi JSON đầy đủ hoặc rút gọn
• Phản hồi JSON: Đầu ra JSON có cấu trúc với chế độ đầy đủ hoặc rút gọn
• Giao diện tương tác (Ứng dụng MCP): Công cụ search_table và search_dashboard tùy chọn hiển thị kết quả dưới dạng giao diện tương tác trong các máy chủ hỗ trợ

Bắt đầu nhanh

Máy chủ SerpApi MCP có sẵn dưới dạng dịch vụ được lưu trữ tại mcp.serpapi.com. Để kết nối với nó, bạn cần cung cấp khóa API. Bạn có thể tìm khóa API của mình trên bảng điều khiển SerpApi.

Bạn có thể cấu hình Claude Desktop để sử dụng máy chủ được lưu trữ:

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

Bạn cũng có thể thêm máy chủ được lưu trữ vào các ứng dụng khách MCP sau:

OpenClaw

openclaw mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp --transport streamable-http

Claude Code

claude mcp add --transport http serpapi https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp

Hermes

hermes mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp

Codex

codex mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp

Tự lưu trữ

git clone https://github.com/serpapi/serpapi-mcp.git
cd serpapi-mcp
uv sync && uv run src/server.py

Cấu hình Claude Desktop:

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "url": "http://localhost:8000/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

Lấy khóa API của bạn: serpapi.com/manage-api-key

Xác thực

Hai phương thức được hỗ trợ:

• Dựa trên đường dẫn: /YOUR_API_KEY/mcp (khuyến nghị)
• Dựa trên tiêu đề: Authorization: Bearer YOUR_API_KEY

Ví dụ:

# Path-based
curl "https://mcp.serpapi.com/your_key/mcp" -d '...'

# Header-based  
curl "https://mcp.serpapi.com/mcp" -H "Authorization: Bearer your_key" -d '...'

Công cụ Tìm kiếm

Máy chủ MCP có một Công cụ Tìm kiếm chính hỗ trợ tất cả các công cụ và loại kết quả của SerpApi. Bạn có thể tìm thấy tất cả các tham số có sẵn trên tài liệu tham khảo API SerpApi. Lược đồ tham số công cụ cũng được hiển thị dưới dạng tài nguyên MCP: serpapi://engines (chỉ mục) và serpapi://engines/<engine>.

Các tham số bạn có thể cung cấp là cụ thể cho từng công cụ API. Một số tham số mẫu được cung cấp dưới đây:

• params.q (bắt buộc): Truy vấn tìm kiếm
• params.engine: Công cụ tìm kiếm (mặc định: "google_light")
• params.location: Bộ lọc địa lý
• mode: Chế độ phản hồi - "complete" (mặc định) hoặc "compact"
• ...xem các tham số khác trên tài liệu tham khảo API SerpApi

Ví dụ:

{"name": "search", "arguments": {"params": {"q": "coffee shops", "location": "Austin, TX"}}}
{"name": "search", "arguments": {"params": {"q": "weather in London"}}}
{"name": "search", "arguments": {"params": {"q": "AAPL stock"}}}
{"name": "search", "arguments": {"params": {"q": "news"}, "mode": "compact"}}
{"name": "search", "arguments": {"params": {"q": "detailed search"}, "mode": "complete"}}

Công cụ được hỗ trợ: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay, và nhiều hơn nữa (xem serpapi://engines).

Loại kết quả: Hộp trả lời, kết quả tự nhiên, tin tức, hình ảnh, mua sắm - được tự động phát hiện và định dạng.

Giao diện tương tác (Ứng dụng MCP)

Công cụ search mặc định trả về JSON và không thay đổi. Đối với các máy chủ hỗ trợ tiện ích mở rộng Ứng dụng MCP (SEP-1865), hai công cụ tùy chọn hiển thị kết quả dưới dạng giao diện tương tác trực tiếp trong cuộc trò chuyện, do đó JSON SERP khối lượng lớn không bao giờ vào cửa sổ ngữ cảnh của mô hình:

• search_table: kết quả tự nhiên dưới dạng bảng có thể sắp xếp, tìm kiếm.
• search_dashboard: số liệu tóm tắt, biểu đồ phân tích nguồn và bảng kết quả với bảng chi tiết nhấp để mở rộng.

Cả hai đều chấp nhận cùng params như search. Các máy chủ không hỗ trợ Ứng dụng MCP chỉ đơn giản bỏ qua các công cụ này.

Xem trước chúng cục bộ mà không cần máy chủ MCP:

uv run fastmcp dev apps src/server.py

Phát triển

# Local development
uv sync && uv run src/server.py

# Docker
docker build -t serpapi-mcp . && docker run -p 8000:8000 serpapi-mcp

# Regenerate engine resources (Playground scrape)
python build-engines.py

# Testing with MCP Inspector
npx @modelcontextprotocol/inspector
# Configure: URL mcp.serpapi.com/YOUR_KEY/mcp, Transport "Streamable HTTP transport"

Khắc phục sự cố

• "Thiếu khóa API": Bao gồm khóa trong đường dẫn URL /{YOUR_KEY}/mcp hoặc tiêu đề Bearer YOUR_KEY
• "Khóa không hợp lệ": Xác minh tại serpapi.com/dashboard
• "Vượt quá giới hạn tốc độ": Chờ hoặc nâng cấp gói SerpApi của bạn
• "Không có kết quả": Thử truy vấn hoặc công cụ khác

Đóng góp

1. Fork kho lưu trữ
2. Tạo nhánh tính năng của bạn: git checkout -b feature/amazing-feature
3. Cài đặt phụ thuộc: uv install
4. Thực hiện thay đổi của bạn
5. Cam kết thay đổi: git commit -m 'Add amazing feature'
6. Đẩy lên nhánh: git push origin feature/amazing-feature
7. Mở Yêu cầu Kéo

Giấy phép

Giấy phép MIT - xem tệp LICENSE để biết chi tiết.