Search1API

Máy chủ MCP Search1API

Tài liệu tiếng Trung

Máy chủ MCP chính thức cho Search1API — tìm kiếm web, tin tức, truy xuất trang, khám phá sơ đồ trang web và các chủ đề thịnh hành trong một API.

Xác thực

• Các ứng dụng khách hỗ trợ OAuth có thể kết nối trực tiếp đến URL MCP từ xa, sau đó đăng nhập và phê duyệt quyền truy cập trong trình duyệt.
• Các tích hợp hiện có có thể tiếp tục sử dụng khóa API từ bảng điều khiển Search1API.
• Mọi yêu cầu MCP — bao gồm cả khám phá công cụ (initialize, tools/list) — đều yêu cầu thông tin xác thực. Các yêu cầu chưa được xác thực sẽ kích hoạt thử thách OAuth, đây là cách các ứng dụng khách kích hoạt đăng nhập; việc kiểm tra trước khi kết nối được phục vụ bởi thẻ máy chủ tĩnh.

Bắt đầu nhanh (MCP từ xa)

Không cần cài đặt. Cấu hình ứng dụng khách MCP của bạn với URL từ xa. Sử dụng OAuth khi ứng dụng khách hỗ trợ, hoặc cung cấp khóa API.

Xác thực

Ba phương thức được hỗ trợ — sử dụng phương thức nào mà ứng dụng khách của bạn hỗ trợ:

Phương thức	Định dạng
OAuth 2.1	Kết nối đến https://mcp.search1api.com/mcp mà không cần khóa và làm theo luồng đăng nhập của ứng dụng khách
Tiêu đề Ủy quyền	Authorization: Bearer YOUR_SEARCH1API_KEY
Tham số Truy vấn URL (kế thừa)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

Ưu tiên OAuth hoặc tiêu đề Ủy quyền. Thông tin xác thực dưới dạng tham số truy vấn có thể bị lộ trong URL, nhật ký và lịch sử shell.

Claude Desktop

{
  "mcpServers": {
    "search1api": {
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Claude.ai (Web)

Cài đặt > Trình kết nối > Thêm trình kết nối tùy chỉnh:

https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

Cursor

Cài đặt dưới dạng plugin Cursor (khuyến nghị): kho lưu trữ này bao gồm Agent Plugins plugin.json + mcp.json (di động) và .cursor-plugin/plugin.json (siêu dữ liệu / logo Cursor Marketplace) cho MCP từ xa với OAuth. Gửi hoặc cài đặt từ cursor.directory / Cursor Marketplace, sau đó đăng nhập khi được nhắc.

Để kiểm tra cục bộ, sao chép các tệp plugin vào ~/.cursor/plugins/local/search1api (plugin.json, .cursor-plugin/, mcp.json, assets/). Không tạo liên kết tượng trưng từ bên ngoài thư mục đó — Cursor từ chối các mục tiêu liên kết tượng trưng bên ngoài.

Hoặc cấu hình thủ công:

{
  "mcpServers": {
    "search1api": {
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

VS Code

{
  "servers": {
    "search1api": {
      "type": "http",
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add --transport http search1api https://mcp.search1api.com/mcp \
  --header "Authorization: Bearer YOUR_SEARCH1API_KEY"

Windsurf

{
  "mcpServers": {
    "search1api": {
      "serverUrl": "https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY"
    }
  }
}

Kỹ năng tác nhân

Kỹ năng tác nhân đã được chuyển đến search1api-cli. Cài đặt nó bằng:

npm install -g search1api-cli
npx skills add superagents-lab/search1api-cli

Chế độ cục bộ (stdio)

Nếu bạn muốn chạy máy chủ cục bộ, hãy sử dụng Node.js 20 trở lên với npx — không cần sao chép kho lưu trữ:

{
  "mcpServers": {
    "search1api": {
      "command": "npx",
      "args": ["-y", "search1api-mcp"],
      "env": {
        "SEARCH1API_KEY": "YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Đối với các triển khai HTTP tự lưu trữ phía sau proxy, hãy thêm bất kỳ tên máy chủ nội bộ nào có thể truy cập tiến trình Node.js vào biến môi trường MCP_ALLOWED_HOSTS phân tách bằng dấu phẩy. mcp.search1api.com và địa chỉ localhost được phép theo mặc định. Các ứng dụng khách dựa trên trình duyệt gửi tiêu đề Origin cũng phải có tên máy chủ nguồn gốc đáng tin cậy của chúng được thêm vào biến MCP_ALLOWED_ORIGINS phân tách bằng dấu phẩy. Các yêu cầu từ ứng dụng khách MCP phía máy chủ thường bỏ qua Origin và không yêu cầu mục nhập.

Công cụ

search

Tìm kiếm web bằng Search1API. Kết quả bao gồm cấu trúc id/title/url có thể trích dẫn. Truyền URL kết quả đến crawl khi bạn cần toàn bộ trang.

Tham số	Bắt buộc	Mặc định	Mô tả
query	Có	-	Truy vấn tìm kiếm
max_results	Không	10	Số lượng kết quả
search_service	Không	google	google, bing, duckduckgo, yahoo, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia
crawl_results	Không	0	Số lượng kết quả hàng đầu để thu thập nội dung đầy đủ; mỗi lần thu thập thành công thêm 1 tín dụng vào yêu cầu tìm kiếm cơ bản 1 tín dụng
include_sites	Không	[]	Các trang web để bao gồm
exclude_sites	Không	[]	Các trang web để loại trừ
time_range	Không	-	day, month, year

news

Tìm kiếm các bài báo tin tức.

Tham số	Bắt buộc	Mặc định	Mô tả
query	Có	-	Truy vấn tìm kiếm
max_results	Không	10	Số lượng kết quả
search_service	Không	bing	google, bing, duckduckgo, yahoo, hackernews
crawl_results	Không	0	Số lượng kết quả hàng đầu để thu thập nội dung đầy đủ; mỗi lần thu thập thành công thêm 1 tín dụng vào yêu cầu tin tức cơ bản 1 tín dụng
include_sites	Không	[]	Các trang web để bao gồm
exclude_sites	Không	[]	Các trang web để loại trừ
time_range	Không	-	day, month, year

crawl

Trích xuất nội dung từ một URL.

Tham số	Bắt buộc	Mô tả
url	Có	URL để thu thập

sitemap

Lấy tất cả các liên kết liên quan từ một URL.

Tham số	Bắt buộc	Mô tả
url	Có	URL để lấy sơ đồ trang web

trending

Lấy các chủ đề thịnh hành từ các nền tảng phổ biến.

Tham số	Bắt buộc	Mặc định	Mô tả
search_service	Có	-	github, hackernews
max_results	Không	10	Số lượng mục

Lịch sử phiên bản

• v0.6.1: Sửa lỗi — khám phá MCP (initialize, tools/list, resources/*, prompts/list, server/discover) yêu cầu thông tin xác thực trở lại. Việc phục vụ ẩn danh khiến các ứng dụng khách coi "công cụ được liệt kê" là "đã đăng nhập" hiển thị trạng thái đã kết nối mà không có cách nào kích hoạt luồng OAuth; thử thách 401 hiện trả lời mọi yêu cầu chưa được xác thực, khôi phục đăng nhập OAuth tại thời điểm kết nối. Khả năng hiển thị thư mục không thay đổi qua thẻ máy chủ tĩnh và siêu dữ liệu đăng ký
• v0.6.0: Khám phá MCP (initialize, tools/list, resources/*, prompts/list, server/discover) được phục vụ mà không cần thông tin xác thực để ứng dụng khách và thư mục có thể liệt kê các công cụ trước khi đăng nhập; các lệnh gọi công cụ vẫn yêu cầu OAuth hoặc khóa API. Chế độ stdio khởi động mà không có SEARCH1API_KEY và phục vụ siêu dữ liệu công cụ, chỉ từ chối tại thời điểm gọi. Các yêu cầu sai định dạng trả lời dưới dạng JSON-RPC thay vì trang lỗi HTML
• v0.5.4: Nhà phát hành OAuth được chuyển đến clerk.s1.dev và có thể cấu hình bằng OAUTH_AUTHORIZATION_SERVER; thẻ máy chủ MCP được xuất bản tại /.well-known/mcp/server-card.json; tài liệu khám phá OAuth hiện gửi tiêu đề bộ nhớ đệm
• v0.5.3: Siêu dữ liệu tài nguyên và công cụ OAuth không còn yêu cầu phạm vi phiên OIDC; huy hiệu đăng ký Smithery và Glama được thêm vào
• v0.5.2: Xác thực Origin MCP hiện chạy trước khi phân tích yêu cầu và xác thực; các triển khai HTTP tự lưu trữ có thể cấu hình nguồn gốc trình duyệt đáng tin cậy bằng MCP_ALLOWED_ORIGINS
• v0.5.1: Tài liệu, tệp kê khai LobeHub và siêu dữ liệu MCP Registry được đồng bộ hóa; robots.txt được phục vụ trên máy chủ truyền tải
• v0.5.0: Hỗ trợ MCP 2026-07-28 với đàm phán giao thức tự động; tương thích không trạng thái cho các ứng dụng khách HTTP thời đại 2025; xác thực cấp yêu cầu
• v0.4.0: Lược đồ đầu ra có cấu trúc, lược đồ bảo mật OAuth, chú thích an toàn và siêu dữ liệu MCP Registry chính thức
• v0.3.1: Hỗ trợ OAuth 2.1 cho MCP từ xa; công cụ suy luận đã ngừng sử dụng được loại bỏ
• v0.3.0: Hỗ trợ MCP từ xa qua Streamable HTTP; xác thực khóa API theo phiên
• v0.2.0: Hỗ trợ .env dự phòng cho tích hợp LibreChat
• v0.1.8: Dịch vụ tìm kiếm X (Twitter) và Reddit
• v0.1.7: Công cụ thịnh hành cho GitHub và Hacker News
• v0.1.6: Dịch vụ tìm kiếm Wikipedia
• v0.1.5: Tham số và dịch vụ tìm kiếm mới (arxiv, wechat, bilibili, imdb)
• v0.1.3: Tìm kiếm tin tức
• v0.1.2: Sơ đồ trang web
• v0.1.1: Thu thập web
• v0.1.0: Phát hành ban đầu

Giấy phép

MIT