Search1API

Search1API MCP Server

中文文档

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á sitemap và chủ đề thịnh hành trong một API.

Xác thực

• Các máy khách hỗ trợ OAuth có thể kết nối trực tiếp tới 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.

Bắt đầu nhanh (Remote MCP)

Không cần cài đặt. Cấu hình máy khách MCP của bạn với URL từ xa. Sử dụng OAuth khi máy 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áy khách của bạn hỗ trợ:

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

Nên ưu tiên OAuth hoặc tiêu đề Authorization. Thông tin xác thực trong 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 như plugin Cursor (khuyến nghị): repo 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 Remote MCP 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 symlink từ bên ngoài thư mục đó — Cursor từ chối các mục tiêu symlink 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 Agent

Kỹ năng Agent đã chuyển sang 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 clone:

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

Đối với triển khai HTTP tự lưu trữ sau proxy, hãy thêm mọi tên máy chủ nội bộ kết nối tới 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. Địa chỉ mcp.search1api.com và localhost được cho phép theo mặc định. Các máy 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 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ừ máy khách MCP phía máy chủ thường bỏ qua Origin và không cần 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ả tới 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 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 sitemap

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.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; thêm huy hiệu đăng ký Smithery và Glama
• v0.5.2: Xác thực MCP Origin giờ chạy trước khi phân tích yêu cầu và xác thực; triển khai HTTP tự lưu trữ có thể cấu hình nguồn trình duyệt đáng tin cậy với MCP_ALLOWED_ORIGINS
• v0.5.1: Tài liệu, manifest 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 máy khách HTTP thời 2025; xác thực cấp yêu cầu
• v0.4.0: Lược đồ đầu ra có cấu trúc, sơ đồ bảo mật OAuth, chú thích an toàn và siêu dữ liệu Official MCP Registry
• v0.3.1: Hỗ trợ OAuth 2.1 cho Remote MCP; loại bỏ công cụ suy luận đã ngừng hoạt động
• v0.3.0: Hỗ trợ Remote MCP qua Streamable HTTP; xác thực khóa API theo phiên
• v0.2.0: Hỗ trợ dự phòng .env 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ụ trending 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: Sitemap
• v0.1.1: Thu thập web
• v0.1.0: Phát hành đầu tiên

Giấy phép

MIT