SanDeals.net
Di halaman iniPilih cara integrasi
Spesifikasi MarkdownLihat OpenAPI

Pengembang

Mulai membangun dengan SanDeals

Hubungkan agen AI atau aplikasi Anda ke katalog penawaran SanDeals. Halaman ini membahas penyiapan lewat MCP, REST API, dan ChatGPT Actions, lalu dilanjutkan dengan referensi lengkap.

claude mcp add --transport http sandeals https://www.sandeals.net/mcp
URL server
https://www.sandeals.net/mcp
  • Streamable HTTP
  • Auth: None
  • Hanya baca

Kompatibel denganClaude CodeChatGPTCursor

Integrasi

Pilih cara integrasi

Pilih antarmuka yang sesuai dengan klien Anda. Ketiganya membaca katalog yang sama.

MCP

Untuk asisten AI dan agen. Hubungkan sekali, lalu model Anda memanggil search_deals dan list_deals sebagai alat.

REST API

Untuk aplikasi, skrip, dan backend. Kirim satu permintaan HTTP dan terima JSON terstruktur.

ChatGPT Actions

Untuk custom GPT. Impor spesifikasi OpenAPI dan panggil operasi searchDeals.

Mulai

Mulai cepat

Panduan ini menghubungkan SanDeals ke Claude Code dan menjalankan pencarian pertama Anda. Langkah untuk ChatGPT, Cursor, dan klien lain menyusul setelahnya.

Prasyarat

  • Klien MCP seperti Claude Code, ChatGPT, atau Cursor
  • Atau klien HTTP apa pun, seperti curl, untuk REST API
  • Tanpa akun atau kunci API: server bersifat publik dan hanya baca

Claude Code

  1. Tambahkan server

    Jalankan perintah ini di terminal Anda. Perintah ini mendaftarkan SanDeals sebagai server Streamable HTTP bernama sandeals.

    Terminal
    claude mcp add --transport http sandeals https://www.sandeals.net/mcp

  2. Periksa koneksi

    Tampilkan daftar server Anda. Koneksi yang berhasil menampilkan ✓ Connected di samping sandeals. Jika muncul Failed to connect, periksa jaringan Anda dan jalankan kembali perintah penambahan. Di dalam sesi Claude, /mcp menampilkan status yang sama.

    Terminal
    claude mcp list
    Keluaran
    Checking MCP server health...

sandeals: https://www.sandeals.net/mcp (HTTP) - ✓ Connected

  3. Cari penawaran

    Tanyakan dengan bahasa sehari-hari. Claude memanggil search_deals dan menjawab dengan judul serta tautan dari katalog.

    Claude Code
    Gunakan SanDeals untuk mencari penawaran kopi dan kembalikan judul serta tautan setiap penawaran.
    Keluaran
    Berikut penawaran kopi dari SanDeals:

1. Kopi bubuk 500 g — https://slink.sandeals.net/AbC123
2. Kopi instan 3-in-1, 20 sachet — https://slink.sandeals.net/XyZ789

Periksa syarat dan ketentuan di situs toko sebelum membeli.
Untuk berbagi server dengan tim Anda, tambahkan --scope project. Claude Code menyimpannya ke .mcp.json di repositori Anda.
claude mcp add --scope project --transport http sandeals https://www.sandeals.net/mcp

ChatGPT

  1. Di ChatGPT Connectors, tambahkan custom MCP server.

  2. Tempel URL server dan pilih No authentication.

    URL server
    https://www.sandeals.net/mcp

  3. Instal server. Di obrolan baru, ketik @ lalu pilih SanDeals.

Ketersediaan bergantung pada izin workspace Anda. ChatGPT Actions di bawah adalah integrasi REST terpisah.

Cursor dan klien lain

Setiap klien yang mendukung MCP jarak jauh lewat Streamable HTTP dapat terhubung dengan URL server. Di Cursor, tambahkan ke mcp.json:

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

ChatGPT Actions

Di ChatGPT, buat custom GPT, buka Actions, lalu pilih Import from URL. Tempel URL di bawah, atur Authentication ke None, dan GPT akan memanggil operasi searchDeals.

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

Prompt agen

Arahkan agen ke www.sandeals.net/for-agents.md, atau gunakan prompt ini:

Prompt agen
Hubungkan ke https://www.sandeals.net/mcp. Panggil search_deals. Kembalikan judul dan tautan setiap penawaran dari respons.

Referensi

Server MCP

Server MCP menggunakan Streamable HTTP dan tidak menyimpan status sesi antar permintaan. URL servernya adalah 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

Alat

search_dealsHanya baca

Mencari penawaran berdasarkan kata kunci. Setiap hasil memiliki judul, tautan, dan kategori.

BidangTipeCatatan
queryWajibstring1–512 chars
limitinteger1–50 · default 10
list_dealsHanya baca

Menampilkan katalog, dapat disaring berdasarkan kategori atau kata kunci.

BidangTipeCatatan
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 API

REST API menjalankan pencarian yang sama dengan alat MCP search_deals. Kirim kueri Anda lewat q. limit bersifat opsional, default 10 dan maksimum 50. Untuk permintaan POST, sertakan mode: "agent" agar menerima JSON terstruktur.

GETPOST/api/search-advanced

curl "https://www.sandeals.net/api/search-advanced?q=coffee&limit=5"
  • Katalog: GET /api/deals menampilkan katalog. Saring dengan category, search (atau aliasnya q), dan limit.
  • Cadangan HTML: GET /search?q=coffee mengembalikan halaman hasil HTML yang berjalan tanpa JavaScript. Gunakan hanya jika klien Anda tidak bisa membaca JSON.

Respons

Setiap hasil memuat title dan 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.",
      "score": 13,
      "source": "deals"
    }
  ],
  "response": "Found 1 deal for \"coffee\": 1. Example Cafe — https://slink.sandeals.net/example",
  "meta": {
    "mode": "agent",
    "matched": true
  }
}
BidangTipeCatatan
results[].titlestringNama toko atau penawaran
results[].hrefstringURL penawaran
results[].categorystringfood (kuliner), travel (perjalanan), shopping (belanja), tech (teknologi), books (buku), lifestyle (gaya hidup)
meta.matchedbooleanfalse berarti saran cadangan

Batasan

Jika meta.matched bernilai false, laporkan bahwa tidak ada hasil yang cocok persis, lalu kembalikan baris yang disarankan. Gunakan hanya nilai yang ada di respons.

Coba

Jalankan pencarian langsung dari browser Anda. Formulir ini mengirim permintaan GET ke /search, halaman hasil yang sama dengan yang dilihat pengguna, dan tetap berjalan saat JavaScript dimatikan.

Contoh: coffeegiàyvoucherJSON kopi

Indeks

File-file ini mendeskripsikan SanDeals untuk crawler dan agen pengkodean. Masing-masing mencantumkan endpoint yang sama dalam format berbeda.

JalurFormat
/llms.txtMarkdown
/for-agents.mdMarkdown
/api/llmsJSON
/.well-known/ai.txtText
/openapi.jsonOpenAPI 3
GET /mcpJSON

Langkah berikutnya

Anda sudah menghubungkan SanDeals. Selanjutnya, jelajahi referensi lengkap dan cara integrasi lainnya.

Referensi APISemua endpoint, parameter, dan skema respons.Server MCPDetail server, alat, dan langkah koneksi dalam satu halaman.Spesifikasi OpenAPIImpor ke ChatGPT Actions atau buat klien.Panduan untuk agenDokumentasi dalam format Markdown untuk agen pengkodean dan crawler.