SanDeals Logo
SanDeals.net
Giới thiệuSản phẩm nổi bậtTìm kiếm nâng caoTài liệu API
Trên trang nàyKết nối MCP
Kết nối MCPGiao diệnMáy chủ MCPRESTKết quảRàng buộcThửChỉ mục

Kết nối

  • Claude Code
  • ChatGPT
  • Cursor và client khác
  • ChatGPT Actions
  • Prompt cho agent

Tham chiếu

  • Giao diện
  • Máy chủ MCP
  • Công cụ
  • REST
  • Kết quả
  • Ràng buộc

Tài nguyên

  • Thử
  • Chỉ mục
  • Spec Markdown
  • API reference
SanDeals/Tài liệu API
Spec MarkdownXem OpenAPI

API ưu đãi

Tìm ưu đãi Việt Nam từ ChatGPT và Claude qua máy chủ MCP tương thích. API MCP và REST công khai. Không cần API key.

URL máy chủ
https://www.sandeals.net/mcp
  • Streamable HTTP
  • Auth: None
  • Chỉ đọc

Dùng vớiClaude CodeChatGPTCursor

Kết nối MCP

Claude Code

  1. Thêm máy chủ vào Claude Code.

    Terminal
    claude mcp add --transport http sandeals https://www.sandeals.net/mcp
    
  2. Kiểm tra kết nối. Trong phiên Claude, lệnh /mcp cũng hiển thị trạng thái này.

    Terminal
    claude mcp list
    
  3. Hỏi ưu đãi bằng ngôn ngữ tự nhiên.

    Claude Code
    Dùng SanDeals tìm ưu đãi cà phê, trả về tên và link của từng ưu đãi.
Để dùng chung với team, thêm --scope project. Claude Code sẽ lưu cấu hình vào .mcp.json trong repo.
claude mcp add --scope project --transport http sandeals https://www.sandeals.net/mcp

ChatGPT

  1. Trong ChatGPT Plugins, thêm một custom MCP server.

  2. Dán URL máy chủ và chọn No authentication.

    URL máy chủ
    https://www.sandeals.net/mcp
  3. Cài đặt, rồi chọn SanDeals bằng @ trong cuộc trò chuyện.

Tính năng phụ thuộc quyền workspace của bạn. ChatGPT Actions bên dưới là một tích hợp REST riêng.

Cursor và client khác

Mọi client hỗ trợ remote MCP qua Streamable HTTP đều kết nối được bằng URL máy chủ. Với Cursor, thêm vào mcp.json:

~/.cursor/mcp.json
{
  "mcpServers": {
    "sandeals": {
      "url": "https://www.sandeals.net/mcp"
    }
  }
}

ChatGPT Actions

Import /openapi.json vào ChatGPT Custom GPT Actions. Thao tác searchDeals. Auth: None.

OpenAPI
https://www.sandeals.net/openapi.json

Prompt cho agent

Trỏ agent tới www.sandeals.net/for-agents.md, hoặc dùng prompt này:

Prompt cho agent
Kết nối https://www.sandeals.net/mcp. Gọi search_deals. Trả về title và link của từng ưu đãi trong response.

Giao diện

Cùng một catalog qua MCP, REST hoặc HTML. Người dùng dùng form tìm kiếm trên website. Model không được gửi form đó.

MCPPOST /mcp. Tên gọi khác: POST /api/mcp. JSON-RPC initialize, tools/list, tools/call.Tìm kiếm RESTGET /api/search-advanced?q=QUERY&limit=10. Dùng khi runtime chỉ gọi được HTTP.HTML dự phòngGET /search?q=coffee. Không cần JavaScript. Chỉ dùng khi không đọc được JSON.Danh mụcGET /api/deals, lọc theo category, search/q và limit.

Máy chủ MCP

Streamable HTTP. Không lưu phiên. URL chuẩn www.sandeals.net/mcp.

EndpointPOST /mcp
AliasPOST /api/mcp
AuthNone
TransportStreamable HTTP · JSON-RPC 2.0
Protocol2025-03-26 · 2025-06-18 · 2025-11-25
Methodsinitialize · tools/list · tools/call

Công cụ

search_dealsChỉ đọc

Tìm ưu đãi theo từ khóa. Mỗi kết quả có tên, link và danh mục.

TrườngKiểuGhi chú
queryBắt buộcstring1–512 chars
limitinteger1–50 · default 10
list_dealsChỉ đọc

Liệt kê catalog, có thể lọc theo danh mục hoặc từ khóa.

TrườngKiểuGhi chú
categoryenumall · food · travel · shopping · tech · books · lifestyle · education
searchstring≤ 512 chars
limitinteger1–100 · default 20
tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_deals",
    "arguments": {
      "query": "coffee",
      "limit": 5
    }
  }
}

REST

Cùng kết quả với tool search_deals. Tham số q là bắt buộc. limit tùy chọn, mặc định 10, tối đa 50. POST cần mode: "agent" để nhận JSON có cấu trúc.

GETPOST/api/search-advanced

curl "https://www.sandeals.net/api/search-advanced?q=coffee&limit=5"

Kết quả

Mỗi kết quả có title và href.

response.json
{
  "ok": true,
  "query": "coffee",
  "total": 1,
  "results": [
    {
      "title": "Example Cafe",
      "href": "https://slink.sandeals.net/example",
      "category": "food",
      "summary": "Example cafe — coffee and tea, Vietnam.",
      "score": 13,
      "source": "deals"
    }
  ],
  "response": "Found 1 deals for \"coffee\": 1. Example Cafe — https://slink.sandeals.net/example",
  "meta": {
    "mode": "agent",
    "matched": true
  }
}
TrườngKiểuGhi chú
results[].titlestringTên cửa hàng hoặc ưu đãi
results[].hrefstringURL ưu đãi
results[].categorystringfood (ăn uống), travel (du lịch), shopping (mua sắm), tech (công nghệ), books (sách), lifestyle (đời sống)
meta.matchedbooleanfalse nghĩa là gợi ý thay thế

Ràng buộc

Nếu meta.matched là false thì báo không có kết quả khớp chính xác, rồi trả các dòng gợi ý. Chỉ dùng giá trị có trong response.

Thử

Form GET. Chạy khi tắt JavaScript. Cùng đường dẫn người dùng xem kết quả HTML.

Ví dụ: coffeegiàyvoucherJSON cà phê

Chỉ mục

Tệp máy đọc được cho crawler và coding agent.

Đường dẫnĐịnh dạng
/llms.txtMarkdown
/for-agents.mdMarkdown
/api/llmsJSON
/.well-known/ai.txtText
/openapi.jsonOpenAPI 3
GET /mcpJSON

Trên trang này

Kết nối MCPGiao diệnMáy chủ MCPRESTKết quảRàng buộcThửChỉ mục
Máy chủ MCPAPI referenceSpec Markdown
SanDeals Logo
SanDeals.net

Công cụ tìm kiếm ưu đãi.

Cập nhật hàng giờ

Liên kết nhanh

  • Giới thiệu
  • Sản phẩm nổi bật
  • Tìm kiếm nâng cao
  • Tài liệu API
  • Điều khoản sử dụng
  • Chính sách quyền riêng tư

© 2026 SanDeals.net.

Đang kiểm tra hệ thống...