Search1API

chính thức

Một API cho Tìm kiếm, Thu thập dữ liệu và Sơ đồ trang web

GitHub

175

Bạn có thể làm gì với Search1API MCP?

Tìm kiếm trên web — Yêu cầu trợ lý chạy search trên các công cụ như Google, Bing, GitHub, arXiv hoặc Reddit, kèm bộ lọc trang web và khoảng thời gian.
Tra cứu tin tức — Dùng news để tìm các bài viết mới từ Google, Bing, DuckDuckGo, Yahoo hoặc Hacker News, có thể thu thập nội dung từ các kết quả hàng đầu.
Lấy nội dung trang và sơ đồ trang web — Trích xuất toàn bộ nội dung từ một URL hoặc liệt kê tất cả liên kết liên quan trên một trang web.
Chủ đề thịnh hành — Lấy các mục đang thịnh hành từ GitHub hoặc Hacker News.
Tìm kiếm bằng tác tử — Mô tả nhu cầu bằng ngôn ngữ tự nhiên và để ask chọn công cụ tìm kiếm, rồi trả về các kết quả được xếp hạng và có thể trích dẫn.
Tìm kiếm địa điểm gần đây — Tìm doanh nghiệp và địa điểm trên Google Maps cùng địa chỉ, đánh giá, giờ hoạt động và thông tin liên hệ.

Tài liệu

Search1API MCP Server

中文文档 | Deutsch

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 ứng dụng khách hỗ trợ OAuth có thể kết nối trực tiếp với URL Remote MCP, 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 cần thông tin xác thực. Các yêu cầu chưa xác thực sẽ nhận được thử thách OAuth, qua đó ứng dụng khách có thể bắt đầu quy trình đăng nhập; việc kiểm tra trước khi kết nối được cung cấp qua thẻ máy chủ tĩnh.

Bắt đầu nhanh (Remote MCP)

Không cần cài đặt. Cấu hình ứng dụng khách MCP bằng URL từ xa. Dùng OAuth nếu ứng dụng khách hỗ trợ, hoặc cung cấp khóa API.

Xác thực

Có ba phương thức được hỗ trợ — hãy dùng phương thức 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 vớ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 ứng dụng khách
Authorization Header	`Authorization: Bearer YOUR_SEARCH1API_KEY`
Tham số truy vấn URL (cũ)	`https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY`

Ưu tiên OAuth hoặc Authorization header. 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.

Giao diện tìm kiếm và tin tức tùy chọn

Remote MCP cung cấp render_results tại endpoint tiêu chuẩn ở trên. Các công cụ dữ liệu như search, news và ask trả về kết quả mà không tự động hiển thị thẻ. Khi danh sách nguồn hữu ích, mô hình có thể chọn hoặc kết hợp các kết quả hiện có rồi chuyển chúng cho render_results. Công cụ này trả về thẻ nguồn trong các ứng dụng khách MCP Apps và danh sách văn bản đầy đủ, dễ đọc ở những nơi khác. Việc hiển thị không lặp lại tìm kiếm hay tiêu tốn tín dụng tìm kiếm; không cần tham số URL giao diện.

Cả HTTP và stdio đều quảng bá logo Search1API hình vuông thông qua siêu dữ liệu serverInfo.icons tiêu chuẩn. Tệp PNG 512×512 được cung cấp công khai tại https://mcp.search1api.com/assets/icon-square.png, không cần xác thực và không chuyển hướng. Thẻ máy chủ và tệp kê khai registry sử dụng cùng biểu tượng. Ứng dụng khách tự quyết định có hiển thị biểu tượng hay không; biểu tượng này không thay thế biểu tượng được lưu riêng bởi thư mục plugin.

Xem thỏa thuận hiển thị để biết các đối số, giới hạn và cách xử lý dự phòng. Gói npm có trình hiển thị này từ phiên bản 0.8.0. Cập nhật các bản cài đặt hiện có và khởi động lại kết nối MCP; npx -y search1api-mcp@latest khởi chạy gói mới nhất đã phát hành.

Sau khi thay đổi URL, hãy kết nối lại hoặc làm mới định nghĩa công cụ của connector; ứng dụng khách có thể lưu bộ nhớ đệm. Cài đặt URL này chỉ áp dụng cho Remote MCP; hành vi stdio cục bộ không thay đổi. Xem giao diện MCP Apps để biết chi tiết và trạng thái phát hành.

Claude Desktop

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

Claude.ai (Web)

Cài đặt Search1API từ thư mục Claude, nhấp Connect rồi đăng nhập bằng tài khoản Search1API của bạn.

Tránh thêm https://mcp.search1api.com/mcp qua Add custom connector: thao tác đó tạo một connector tùy chỉnh riêng, mà Claude sẽ đặt tên theo máy chủ của URL (mcp.search1api.com) trừ khi bạn nhập tên.

Cursor

Cài đặt dưới dạng plugin Cursor (được khuyến nghị): repo này bao gồm Agent Plugins plugin.json + mcp.json (có tính di động) và .cursor-plugin/plugin.json (siêu dữ liệu / logo của 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.

Để thử nghiệm 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 đích 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"
      }
    }
  }
}

Antigravity

Cài đặt dưới dạng plugin Antigravity: antigravity-plugin/ chứa tệp kê khai, mcp_config.json (Remote MCP với OAuth), kỹ năng Search1API và README của Marketplace. Cài đặt trực tiếp từ GitHub, sau đó đăng nhập khi trình duyệt mở:

agy plugin install https://github.com/superagents-lab/search1api-mcp/tree/main/antigravity-plugin

Để thử nghiệm cục bộ, chạy agy plugin validate --strict ./antigravity-plugin và agy plugin install ./antigravity-plugin từ bản checkout.

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"
    }
  }
}

Agent Skill

Agent Skill đã được chuyển sang search1api-cli. Cài đặt bằng lệnh:

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

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

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

{
  "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 mọi tên máy chủ nội bộ dẫn đến tiến trình Node.js vào biến môi trường MCP_ALLOWED_HOSTS dạng danh sách phân tách bằng dấu phẩy. mcp.search1api.com và các địa chỉ localhost được cho phép theo mặc định. Các ứng dụng khách dựa trên trình duyệt gửi header Origin cũng phải có tên máy chủ nguồn đáng tin cậy được thêm vào biến MCP_ALLOWED_ORIGINS dạng danh sách 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 không có Origin và không cần thêm mục.

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ả cho crawl khi cần toàn bộ nội dung 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, bingcn, duckduckgo, yahoo, yandex, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia, grokipedia
`page`	Không	1	Trang kết quả (1-100); chỉ bing, bingcn, baidu và grokipedia hỗ trợ phân trang
`crawl_results`	Không	0	Số kết quả đầu tiên cần thu thập nội dung đầy đủ; mỗi lần thu thập thành công cộng thêm 1 tín dụng vào yêu cầu tìm kiếm cơ bản tốn 1 tín dụng
`include_sites`	Không	[]	Các trang cần bao gồm
`exclude_sites`	Không	[]	Các trang cần loại trừ
`time_range`	Không	-	day, week, month, year

Kết quả có published_date trong metadata khi công cụ tìm kiếm cung cấp; kết quả github bổ sung kind, stars, language và num_comments.

news

Tìm kiếm bài viết tin tức. Kết quả hackernews liên kết đến chuỗi thảo luận và bổ sung story_url, points và num_comments vào metadata.

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ố kết quả đầu tiên cần thu thập nội dung đầy đủ; mỗi lần thu thập thành công cộng thêm 1 tín dụng vào yêu cầu tin tức cơ bản tốn 1 tín dụng
`include_sites`	Không	[]	Các trang cần bao gồm
`exclude_sites`	Không	[]	Các trang cần loại trừ
`time_range`	Không	-	day, week, 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 cần thu thập

sitemap

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

Tham số	Bắt buộc	Mô tả
`url`	Có	URL cần lấy sitemap

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

ask

Tìm kiếm theo tác vụ: mô tả nhu cầu bằng ngôn ngữ tự nhiên, Search1API sẽ chọn tối đa năm công cụ tìm kiếm và một khoảng thời gian, loại bỏ kết quả lạc đề, rồi trả về tối đa 10 kết quả có thể trích dẫn được xếp hạng theo mức độ liên quan. Kết quả cũng có intent (từ khóa, công cụ tìm kiếm và khoảng thời gian đã dùng) và errors (các công cụ tìm kiếm gặp lỗi trong khi những công cụ khác hoàn tất). Mỗi yêu cầu hoàn tất tốn 5 tín dụng; hãy dùng search khi bạn đã biết công cụ tìm kiếm cần dùng.

Tham số	Bắt buộc	Mô tả
`query`	Có	Yêu cầu bằng ngôn ngữ tự nhiên, tối đa 500 ký tự

maps

Tìm doanh nghiệp và địa điểm địa phương trên Google Maps. Trả về một trang gồm tối đa 20 địa điểm dưới dạng kết quả có thể trích dẫn: title là tên địa điểm, url là liên kết Google Maps của địa điểm đó và metadata chứa địa chỉ, số điện thoại, trang web, danh mục, điểm đánh giá, số lượt đánh giá, tọa độ, giờ mở cửa, trạng thái mở cửa và khoảng giá nếu có. Mỗi trang tốn 3 tín dụng, bất kể có bao nhiêu địa điểm.

Tham số	Bắt buộc	Mặc định	Mô tả
`query`	Có	-	Nội dung cần tìm, chẳng hạn "quán cà phê" hoặc "nha sĩ ở Austin"
`country`	Không	us	Mã quốc gia gồm hai chữ cái
`language`	Không	en	Ngôn ngữ kết quả, chẳng hạn en, de hoặc zh-CN
`location`	Không	-	`{ latitude, longitude, zoom? }` để tìm quanh một điểm; bắt buộc từ trang 2 trở đi
`page`	Không	1	Trang Google Maps, từ 1 đến 6; mỗi trang là một lần gọi riêng
`max_results`	Không	20	Số địa điểm trả về từ trang đó (1-20); trả về ít địa điểm hơn không làm giảm giá

deepcrawl

Đọc nhiều trang của một trang web trong một tác vụ, chẳng hạn một mục tài liệu. Tìm URL của trang web thông qua sitemap, giữ lại những URL khớp với quy tắc đường dẫn và trả về tối đa max_pages trang dưới dạng kết quả có thể trích dẫn: title, url và nội dung Markdown của trang trong text. Kết quả cũng có stats (đã phát hiện, khớp, bỏ qua, đã thu thập, thất bại), failed (các URL không thể đọc cùng lý do), API message và result_url, một tệp JSON chứa đầy đủ mọi trang. Mỗi tác vụ đã bắt đầu tốn 20 tín dụng, bất kể số trang được đọc.

Công cụ chờ tối đa khoảng 45 giây. Nếu quá trình thu thập vẫn đang chạy, công cụ trả về status: "running" cùng với task_id; gọi lại deepcrawl với task_id đó để nhận các trang, thao tác này miễn phí và không bắt đầu lượt thu thập mới. Văn bản mỗi trang bị giới hạn ở 8.000 ký tự và tổng cộng 80.000 ký tự; các trang bị rút gọn có metadata.truncated: true, còn result_url chứa toàn bộ văn bản.

Tham số	Bắt buộc	Mặc định	Mô tả
`url`	Có, trừ khi cung cấp `task_id`	-	Trang web hoặc mục cần thu thập, chẳng hạn `https://example.com/docs/`
`max_pages`	Không	10	Số trang tối đa cần đọc (1-50), theo thứ tự phát hiện sau khi áp dụng quy tắc đường dẫn; giá không đổi dù số lượng là bao nhiêu
`include_paths`	Không	-	Tối đa 20 quy tắc đường dẫn URL cần giữ lại. Nếu không có ``, quy tắc là tiền tố đường dẫn theo ranh giới phân đoạn (`/docs` khớp với `/docs/api`, nhưng không khớp với `/docsearch`); nếu có ``, quy tắc phải khớp toàn bộ đường dẫn và `*` cũng khớp với `/`
`exclude_paths`	Không	-	Tối đa 20 quy tắc đường dẫn cần bỏ qua, dùng cùng cú pháp; quy tắc loại trừ được ưu tiên
`type`	Không	sitemap	`sitemap` dùng sitemap của trang web, hoặc các liên kết trên trang bắt đầu nếu không có sitemap; `all` dùng mọi liên kết được phát hiện từ URL bắt đầu
`task_id`	Không	-	`task_id` của lượt thu thập vẫn đang chạy; chỉ kiểm tra trạng thái, các tham số khác sẽ bị bỏ qua

send_feedback

Báo cáo kết quả sai, trống hoặc chưa đầy đủ, lỗi bạn không thể khắc phục, tài liệu không khớp với hành vi thực tế hoặc tính năng còn thiếu cho nhóm Search1API. Miễn phí; không tốn tín dụng. Khi máy chủ có thông tin xác thực Search1API, báo cáo sẽ được liên kết với tài khoản đó để nhóm có thể phản hồi. Không đưa thông tin xác thực hoặc dữ liệu riêng tư vào báo cáo.

Tham số	Bắt buộc	Mô tả
`message`	Có	Điều gì đã xảy ra hoặc còn thiếu, tối đa 4000 ký tự
`intent`	Không	Bạn đang cố gắng thực hiện điều gì
`category`	Không	bug, feature_request, docs, other
`request_id`	Không	ID yêu cầu của lệnh gọi gặp sự cố
`model`	Không	Tên mô hình của bạn

Lịch sử phiên bản

v0.11.0: Công cụ deepcrawl mới để đọc tối đa 50 trang của một trang web trong một tác vụ (20 credit mỗi tác vụ; kiểm tra tác vụ đang chạy miễn phí)
v0.10.0: Công cụ maps mới để tìm kiếm địa điểm trên Google Maps (3 credit mỗi trang, tối đa 20 địa điểm)
v0.7.0: Công cụ ask mới dành cho tìm kiếm tác tử. search bổ sung các công cụ tìm kiếm bingcn, yandex và grokipedia, cùng tham số page; search và news chấp nhận time_range: "week" và chuyển tiếp các trường published_date, GitHub và Hacker News trong kết quả metadata
v0.6.1: Sửa lỗi — tính năng 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 cung cấp tính năng này ẩn danh khiến các ứng dụng khách xem trạng thái “đã kết nối” khi đồng nhất “có danh sách công cụ” với “đã đăng nhập”, nhưng không có cách nào kích hoạt luồng OAuth; giờ đây, thử thách 401 được trả về cho mọi yêu cầu chưa 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ị trong thư mục không thay đổi nhờ thẻ máy chủ tĩnh và siêu dữ liệu registry
v0.6.0: Tính năng khám phá MCP (initialize, tools/list, resources/*, prompts/list, server/discover) được cung cấp 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ô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ần SEARCH1API_KEY và cung cấp 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 được phản hồ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 sang 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; các 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 OAuth và công cụ không còn yêu cầu phạm vi phiên OIDC; bổ sung huy hiệu registry Smithery và Glama
v0.5.2: Việc xác thực MCP Origin 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: Đồng bộ tài liệu, tệp kê khai LobeHub và siêu dữ liệu MCP Registry; robots.txt được cung cấp trên máy chủ truyền tải
v0.5.0: Hỗ trợ MCP 2026-07-28 với thương lượng giao thức tự động; khả năng tương thích không trạng thái cho các ứng dụng khách HTTP thời kỳ 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 Official MCP Registry
v0.3.1: Hỗ trợ OAuth 2.1 cho Remote MCP; đã loại bỏ công cụ suy luận không còn dùng
v0.3.0: Hỗ trợ Remote MCP qua Streamable HTTP; xác thực bằng khóa API theo từng 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ụ xu hướng 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 dữ liệu web
v0.1.0: Bản phát hành đầu tiên

Giấy phép

MIT

Ghi nhận UI và bên thứ ba

Giao diện MCP Apps render_results hiển thị các nguồn hiện có dưới dạng thẻ kèm tiêu đề và tên miền. Mọi ứng dụng khách cũng nhận được toàn bộ văn bản và danh sách kết quả có cấu trúc. Thành phần này được điều chỉnh từ Rare UI, do Swami Malode thực hiện. Các điều khoản MIT + Commons Clause + Attribution được sao chép trong THIRD_PARTY_NOTICES.md.

Thiết lập UI, nguồn gốc sandbox và kiểm tra phát hành: MCP Apps UI.

Search1API

Bạn có thể làm gì với Search1API MCP?

Tài liệu

Search1API MCP Server

Xác thực

Bắt đầu nhanh (Remote MCP)

Xác thực

Giao diện tìm kiếm và tin tức tùy chọn

Claude Desktop

Claude.ai (Web)

Cursor

Antigravity

VS Code

Claude Code

Windsurf

Agent Skill

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

Công cụ

search

news

crawl

sitemap

trending

ask

maps

deepcrawl

send_feedback

Lịch sử phiên bản

Giấy phép

Ghi nhận UI và bên thứ ba