SanDeals Logo
SanDeals.net
Giới thiệuSản phẩm nổi bậtTìm kiếm nâng cao
SanDeals/Tài liệu

API ưu đãi

MCP và REST công khai cho catalog ưu đãi Việt Nam và Đông Nam Á. Không cần API key.

Kết nối MCPXem OpenAPISpec Markdown
>_mcp.json
{
  "mcpServers": {
    "sandeals": {
      "url": "https://www.sandeals.net/mcp"
    }
  }
}

Cài đặt

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

Prompt cho agent

Connect to https://www.sandeals.net/mcp. Call search_deals. Return each deal title and link from the response.

Máy chủ MCP

Streamable HTTP tại /mcp. Tool search_deals và list_deals. CORS mở. Không cần xác thực.

Xem thêm

OpenAPI

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

Xem thêm

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 đó.

MCP

POST /mcp. Alias POST /api/mcp. JSON-RPC initialize, tools/list, tools/call.

Xem thêm

Tìm kiếm REST

GET /api/search-advanced?q=QUERY&limit=10. Dùng khi runtime chỉ gọi được HTTP.

Xem thêm

HTML dự phòng

GET /search?q=coffee. Không cần JavaScript. Chỉ dùng khi không đọc được JSON.

Xem thêm

Danh mục

GET /api/deals, lọc theo category, search/q và limit.

Xem thêm

MCP

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

Endpoint
POST /mcp
Alias
POST /api/mcp
Auth
None
Transport
JSON-RPC 2.0
Methods
initialize, tools/list, tools/call
>_mcp.json
{
  "mcpServers": {
    "sandeals": {
      "url": "https://www.sandeals.net/mcp"
    }
  }
}
ToolTham số
search_dealsquery: string
limit?: 1-50
list_dealscategory?: food | travel | shopping | tech | books | lifestyle | education
search?: string
limit?: 1-100
>_tools-call.json
{
  "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.

>_terminal
GET https://www.sandeals.net/api/search-advanced?q=coffee&limit=5
>_terminal
POST https://www.sandeals.net/api/search-advanced
Content-Type: application/json

{
  "query": "coffee",
  "mode": "agent",
  "limit": 10
}

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, travel, shopping, tech, books, lifestyle
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ụ: coffee · giay · voucher · JSON cà phê

Chỉ mục

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

  • /llms.txtMarkdown
  • /api/llmsJSON
  • /.well-known/ai.txtText
  • GET/mcpJSON
  • /docs#mcpTài liệu
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

© 2026 SanDeals.net.

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