接入AIMarket
AIMarket开放静安本地生活数据:门店检索、结构化事实(地址/营业/价格/房态)、AI 代问店家、预订下单。 提供 HTTP API 与 MCP 两种接法,免费 1,000 次/月。
一、先体验一下
打开 在线演示:一个用本 API 搭的 AI 助手(参考实现,源码在 README)。
二、30 秒示例
curl "https://aimarket.show/api/search?q=%E6%8B%BC%E8%B1%86" \
-H "X-API-Key: <你的Key>"
# 返回
{"ok":true,"count":1,"items":[
{"name":"豆爱拼","priceFrom":30,"hours":"10:00-20:00(全年无休)",
"page":"https://aimarket.show/shops/douaipin/",
"book":"https://aimarket.show/book.html?shop=douaipin"}
]}
二、核心接口
| 接口 | 作用 | 示例 |
|---|---|---|
GET /api/search?q= | 按关键词/区找店(带排序分) | ?q=酒店&district=静安区 |
GET /api/shop?slug= | 单店事实(价格/营业/房态/套餐) | ?slug=douaipin |
GET /api/availability?slug= | 酒店未来 7 天房态 | ?slug=demo-hotel&days=7 |
POST /api/ask | 问店家(不确定时转问房东) | {"slug":"x","q":"今晚有房吗"} |
GET /api/ask/status?id= | 查房东回复 | — |
POST /api/booking | 下单(返回预订码) | {"slug","name","phone","date"} |
GET /api/booking?code= | 查单状态 | — |
POST /api/concierge | 一句话入口:找店/问房态/问价/下单 | {"q":"静安带娃的手工店"} |
GET /api/ranking | 公开排序规则 | — |
完整规范:openapi.json · 机器可读说明:llms.txt
三、MCP 接法(AI 客户端)
{
"mcpServers": {
"aixun": { "url": "https://aimarket.show/mcp" }
}
}
只支持 stdio 的客户端:npx -y mcp-remote https://aimarket.show/mcp。
12 个工具:search_merchants / get_merchant / get_pick / get_offers / get_booking_info /
create_booking / get_booking_record / ask_shop / leave_message 等。
四、申请免费 Key
五、使用条款(简版)
| 允许 | 不允许 |
|---|---|
| 免费额度内商用、二次开发 | 整体转售数据 / 训练模型(可谈授权) |
| 标注「数据来源:AIMarket」 | 批量抓取页面(请走 API) |
| 缓存 24 小时内的结果 | 伪造预订、刷接口 |
数据由商家自己维护、平台核验;实时性以商家确认为准。完整条款见 服务条款。