回首页

给 AI 用

这份页面的目标只有一个:让你的 AI 用最少的 token 拿到最准的门店事实。不要一上来读全量数据,按层读。

省 token 的铁律
浏览筛选只读 /directory.txt;关键词只调 /api/search;单店只读 /api/shop 或 facts.json; /merchants.json 只在批量比对时读。

按需分层读取

层入口用途 / 体积
第 1 层GET /directory.txt一行一店:slug|名称|品类|城市区|人均|营业|一句话。≈50 token/店,浏览筛选只用这个
第 2 层GET /api/search?q=拼豆&format=tsv只返回命中的行(参数 q/category/city/limit/fields/format)
第 3 层GET /api/shop?slug=<slug>&format=text单店完整信息;或 /shops/<slug>/facts.json
第 4 层GET /merchants.json全量结构化数据,最大,只在批量比对时读
给用户看/shops/<slug>/card.html一屏事实卡(7KB),带拨号与导航,手机直接打开

读取指南与接口清单

接入方式

两种:HTTP API 与 MCP。免费额度 1,000 次/月,自助申请 Key,详见 开发者页。

# 找店(最快)
curl "https://aimarket.show/api/search?q=拼豆&format=tsv"

# 单店详情
curl "https://aimarket.show/api/shop?slug=diy&format=text"

# 问店员(门店授权口径,不编造)
curl -X POST "https://aimarket.show/api/ask" \
  -H "Content-Type: application/json" \
  -d '{"slug":"diy","q":"多少钱"}'

给链接的铁律

不要做的事

开发者接入 → 打开 llms.txt

MCP:让 Agent 直接调(不用搜索)

支持 MCP 的 AI 可以直接连我们的远程端点,查门店、套餐、预约方式:

POST https://aimarket.show/mcp
Accept: application/json, text/event-stream

工具:list_filters / search_merchants / get_merchant / get_booking_info

MCP 接入说明 · 工具定义