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.
{
"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:
Connect to https://www.sandeals.net/mcp. Call search_deals. Return each deal title and link from the 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 đó.
MCP
POST /mcp. Alias POST /api/mcp. JSON-RPC initialize, tools/list, tools/call.
Xem thêmTìm kiếm REST
GET /api/search-advanced?q=QUERY&limit=10. Dùng khi runtime chỉ gọi được HTTP.
Xem thêmHTML dự phòng
GET /search?q=coffee. Không cần JavaScript. Chỉ dùng khi không đọc được JSON.
Xem thêmDanh mục
GET /api/deals, lọc theo category, search/q và limit.
Xem thêmMCP
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
{
"mcpServers": {
"sandeals": {
"url": "https://www.sandeals.net/mcp"
}
}
}| Tool | Tham số |
|---|---|
| search_deals | query: string limit?: 1-50 |
| list_deals | category?: food | travel | shopping | tech | books | lifestyle | education search?: string limit?: 1-100 |
{
"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.
GET https://www.sandeals.net/api/search-advanced?q=coffee&limit=5
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.
{
"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ường | Kiểu | Ghi chú |
|---|---|---|
| results[].title | string | Tên cửa hàng hoặc ưu đãi |
| results[].href | string | URL ưu đãi |
| results[].category | string | food, travel, shopping, tech, books, lifestyle |
| meta.matched | boolean | false 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.
