mcllrealestate/agent-skills

MCLL 房地產

MCLL（mcllrealestate.com）是一家頂級泰國房地產公司。此技能讓代理人能夠搜尋並讀取該公司已發布的公開物件清單——包含買賣與租賃，範圍涵蓋曼谷、普吉島及各島嶼。此處所有資料皆為唯讀公開資料；無需金鑰或登入即可使用。

請選擇您的執行環境所支援的存取方式。MCP 與 REST 會回傳物件清單；Markdown 則會呈現區域、新聞與開發資訊頁面。

1. MCP 伺服器（功能最豐富——優先使用）

Streamable-HTTP MCP 端點：https://mcllrealestate.com/api/mcp 伺服器卡片：https://mcllrealestate.com/.well-known/mcp/server-card.json

三個工具：

• search_listings — 搜尋物件。參數：type（"sale" | "rent"，必填）、 locale（en/fr/th/zh，預設 en），以及可選的 city、area、 propertyType（使用人類可讀名稱——如 "Phuket"、"Condo"）、bedrooms、minPrice、maxPrice （泰銖）、page。回傳 { total, page, results: [{ id, title, url, transactionType, city, area, bedrooms, bathrooms, areaSqm, priceThb, image }] }——每個結果的 url 結尾為一個 slug，您需將其傳遞給 get_listing。
• get_listing — 單一物件的完整詳細資訊。參數：type（"sale"|"rent"）、 slug（來自搜尋結果）、locale。回傳價格、大小、特色、座標， 以及一個 Markdown 格式的 description。
• execute — 程式碼模式。參數：code（JavaScript 字串）。在 Cloudflare 沙箱中執行，提供全域 mcll.search(args) 與 mcll.get(args)。不開放網路存取、檔案系統、機密或寫入操作。使用 return 回傳 JSON 可序列化的結果； 頂層 await 可使用。最適合用於一次呼叫中比較、排名或計算多個物件。

execute 程式碼範例：

const { results } = await mcll.search({ type: "sale", city: "Bangkok", page: 1 });
const details = await Promise.all(
  results.slice(0, 2).map((r) =>
    mcll.get({ type: "sale", slug: r.url.split("/").pop(), locale: "en" }),
  ),
);

return details.map((d) => ({
  title: d.title,
  url: d.url,
  pricePerSqm: d.priceThb && d.areaSqm ? Math.round(d.priceThb / d.areaSqm) : null,
}));

2. REST API（無需 MCP 客戶端）

OpenAPI：https://mcllrealestate.com/api/openapi.json

• 搜尋 — GET /api/listings?type=sale|rent&locale=en 加上可選的篩選條件。請注意 這些篩選條件接受的是 id（UUID），而非名稱：city、area、propertyType、 bedrooms、bathrooms、priceMin、priceMax、sizeMin、sizeMax、furnished、 features、sort、page。回傳 { total, page, results }，每個結果的 公開投影欄位與 MCP 搜尋相同：絕對路徑 url、公開圖片 URL、價格 欄位、城市/區域名稱，且不包含管理員專用欄位。（如需以名稱篩選—— 例如「普吉島的公寓」——請使用 MCP 的 search_listings 工具，它會自動將名稱解析為 id。）
• 詳細資訊 — GET /api/listings/{type}/{slug}?locale=en → 以 JSON 格式回傳單一物件，並附帶 一則 Markdown 格式的 description。type 為 sale 或 rent；slug 來自物件 URL 的 最後一個路徑段落。

# 已知物件的詳細資訊（slug 來自其公開 URL）：
curl -s "https://mcllrealestate.com/api/listings/sale/kamala-cliff-villa?locale=en"

# 搜尋（買賣物件，第 1 頁）：
curl -s "https://mcllrealestate.com/api/listings?type=sale&locale=en"

3. Markdown 內容協商（任何頁面 → 純文字）

對任何物件、區域、新聞或開發資訊頁面發送 Accept: text/markdown，MCLL 就會 回傳 Markdown 格式的內容而非 HTML——所需 token 遠少於解析整個頁面。 首頁會回傳網站總覽。區域、新聞與開發資訊頁面僅能透過此方式存取—— 沒有對應的 MCP 工具或 REST 端點；您可以從網站地圖中找到它們的 URL。

curl -s -H "Accept: text/markdown" \
  "https://mcllrealestate.com/en/buy/villa/phuket/kamala/kamala-cliff-villa"

索引頁與靜態頁面沒有 Markdown 內容協商功能，會回傳 HTML——請對這些頁面使用搜尋 API。

典型工作流程

1. 當使用者要求跨多個物件進行比較、排名或衍生指標時，請使用 execute。
2. 否則請搜尋使用者想要的物件（search_listings 或 GET /api/listings）。
3. 閱讀結果清單；根據 title、area、priceThb 挑選相關物件。
4. 為所選物件取得詳細資訊（get_listing、詳細 REST 路徑，或直接在物件 url 上使用 Markdown 內容協商）。
5. 回覆使用者物件的實際資訊，並提供公開 url 的連結。

探索與慣例

• 網站地圖（每個語言的所有 URL）：https://mcllrealestate.com/sitemap.xml。
• API 目錄（機器索引）：https://mcllrealestate.com/.well-known/api-catalog。
• 代理人專用網站指南：https://mcllrealestate.com/llms-full.txt。
• 語言：en · fr · th · zh。未發布的語言會自動回退為英文。
• 價格以 泰銖 表示；若 priceOnRequest: true（或 priceThb: null）表示價格 未公開——請回覆「價格請洽詢」，切勿提供數字。
• 僅回傳已發布的物件；此處無需驗證，也沒有任何可寫入的內容。