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 内容协商（任何页面 → 纯文本）

向任何房源、区域、新闻或开发页面的 URL 发送 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。未发布的语言将回退为英语。
• 价格以泰铢 (THB) 为单位；priceOnRequest: true（或 priceThb: null）表示价格不公开——请回复"价格垂询"，切勿给出具体数字。
• 仅返回已发布的房源；无需认证，且此处没有写入权限。