这是一个给 AI 用的生活服务平台
人能用,AI 更能用。平台是开放的:数据随便读,门店随便开(审核制),接口不需要商务对接。
一、用户自己的 AI 怎么用
用户问"附近有什么能带娃待两小时的地方""这家店周日下午有位吗"——AI 直接调下面的接口就能回答,不用让用户自己去翻 App。
| 接口 | 用途 | 鉴权 |
|---|---|---|
/directory.txt | 一行一店的极简目录(slug|名称|品类|城市区|人均|营业|一句话)—— 浏览筛选首选,最省 token(几十家店也只有几 KB) | 无 |
/api/search?q=拼豆&format=tsv&fields=min | 只返回命中的行,行式输出;参数 q/category/city/limit/fields/format | 无 |
/api/shop?slug=xxx&format=card | 单店精简(约 60 token):人均、营业、地址、电话、主打、预约方式;format=text 再加套餐与 FAQ | 无 |
/merchants.json | 全量结构化数据(最大,只在批量比对或导入时读) | 无 |
/shops/<slug>/card.html | 给用户看的门店卡:手机上打开一屏看完,带一键拨号、导航、复制地址 | 无 |
/openapi.json | 接口规范(含阶段 3 的占位/确认预约) | 无 |
预约是两步的:AI 先占位(15 分钟有效)→ 必须由主人本人确认(手机验证码)才算真单。 这样既让 AI 能干活,又不会出现"被 AI 乱下单"。
# 例:让 AI 搜"上海 拼豆 亲子"
curl -s "https://aimarket.show/api/search?q=拼豆&city=上海"
# 例:取单店数据
curl -s "https://aimarket.show/api/shop?slug=douaipin"
# 例:AI 占位(阶段 3)
curl -s -X POST "https://aimarket.show/api/hold" \
-H "Content-Type: application/json" \
-d '{"slug":"douaipin","date":"2026-10-20","slot":"15:00-17:00","party_size":2,"agent":"ChatGPT"}'
二、门店的 AI 怎么占位开店、长期运营
这些位置是专留给还没入驻的门店的。门店自己的 AI 助手可以直接调用平台的入驻接口占下位置,审核通过后,这个位置就变成它的门店页。
POST
/api/apply 提交门店名称、品类、城市、地址、简介。返回 slug 和一个 claimCode。PUT
/api/merchant?slug=xxx,请求头带 x-claim-code。照片、产品与价格、营业时间、可预约时段、常见问题一次交齐。入驻与更新都是审核制:平台方在 1–2 个工作日内处理,审核通过即生成门店页上线;已上线门店的更新同样走复核。
门店页地址
/shops/<slug>/。之后随时 PUT 更新价格、换照片、加产品——提交即复核,通过即生效。# 第 1 步:申请入驻(任何 AI 都能替门店调)
curl -s -X POST "https://aimarket.show/api/apply" \
-H "Content-Type: application/json" \
-d '{
"name": "某某咖啡",
"category": ["餐饮", "咖啡"],
"city": "上海",
"district": "静安区",
"address": "XX路 100 号 1 层",
"phone": "021-0000-0000",
"intro": "街角小店,手冲和可颂,早上 7 点开门。",
"agent": "ChatGPT",
"contact": "店主微信 xxx"
}'
# 第 2 步:用返回的 claimCode 提交店铺资料
curl -s -X PUT "https://aimarket.show/api/merchant?slug=mou-mou-coffee" \
-H "Content-Type: application/json" \
-H "x-claim-code: claim_xxxxxxxx" \
-d '{
"name": "某某咖啡",
"category": ["餐饮","咖啡"],
"city": "上海",
"address": "XX路 100 号 1 层",
"hours": "07:00-19:00,周一休",
"intro": "街角小店,手冲和可颂。",
"priceFrom": 25,
"tags": ["咖啡","早餐","可颂","安静"],
"cover": "https://你的图床/cover.jpg",
"gallery": [{"file":"https://你的图床/1.jpg","title":"店内","alt":"靠窗座位与手冲台","wide":true}],
"products": [
{"name":"手冲单品","cat":"drink","price":32,"time":"约 10 分钟","desc":"当日豆单任选"},
{"name":"可颂","cat":"bakery","price":18,"time":"随时"}
],
"booking": {"required": false, "horizonDays": 7, "slots": ["07:00-09:00","09:00-11:00"]}
}'
# 第 3 步:查状态(审核通过后门店页自动上线)
curl -s "https://aimarket.show/api/merchant?slug=mou-mou-coffee" \
-H "x-claim-code: claim_xxxxxxxx"
claimCode 是这家店在平台上的唯一写入凭证——只返回一次,请让店主保存好,不要放在公开页面里。 凭证丢了走下面的联系方式找平台重置。
三、资料已经在点评/抖音上了,怎么搬进来
平台**不抓取**大众点评/抖音的页面——那些平台禁止爬取,抓了有法律风险,而且反爬、抓到也残缺。
正确做法是"人机协作":由门店自己、店员,或 AI 助手把资料整理成 JSON,从平台的写入端一次灌进来。灌进来之后,所有 AI 都能从 /merchants.json 读到,不用再一家家翻平台。
| 谁在搬 | 走哪个口 | 鉴权 |
|---|---|---|
| 门店的 AI(自助开店、长期维护) | POST /api/apply → PUT /api/merchant | x-claim-code |
| 平台运营者 / 你的 AI(批量搬运,一次多家) | POST /api/import | token=ADMIN_TOKEN |
| 离线(没有公网也能干) | python sync_merchants.py --from-file 店.json | 本地命令 |
# 你的 AI 按点评截图整理好 JSON 之后,一次灌进来(可多家)
curl -s -X POST "https://aimarket.show/api/import?token=ADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"mode": "merge",
"source": "ChatGPT 按大众点评截图整理 2026-10-16",
"merchants": [ { "slug":"douaipin", "name":"豆爱拼", "category":["手工DIY","拼豆"],
"city":"上海", "address":"…", "hours":"10:00-20:00", "intro":"…",
"products":[{"name":"【单人拼豆】工作日不限时","short":"单人 · 工作日 · 不限时",
"slot":"工作日","time":"不限时","price":52.9,"listPrice":396}] } ]
}'
# 灌完立刻能被所有 AI 读到
curl -s "https://aimarket.show/merchants.json" | head -c 400
curl -s "https://aimarket.show/api/search?q=拼豆"
合并规则默认 merge:只补空缺,不覆盖门店自己维护过的字段;要整体覆盖用 "mode":"replace"。
四、硬性规则(会被直接拒绝的)
- 文案里出现抽奖、奖池、保底、中奖、虚拟币等玩法词 —— 直接拒绝
- 广告法绝对化用语:最好、第一、绝对、保证、唯一、顶级 等
- 图片不是自己拍的、或用了未授权的动漫/游戏 IP 图案
- 地址电话不真实、门店查不到、联系方式打不通
- 平台不代收款项;不要在这里做资金归集、预售卡或充值
- 价格可以暂时缺失(页面会标"价格待确认"),但会明显影响转化
四、数据使用许可
允许 AI 助手与搜索引擎抓取、缓存、引用本站公开数据,需注明来源为平台与门店页地址;不得伪造门店信息、不得二次倒卖原始数据、不得用于电话营销或骚扰。
适用对象:AI 助手、搜索引擎、聚合工具、研究者。需要更高频率或批量同步,走下面的联系方式谈,不要硬刷接口。
五、AI 还不会调接口怎么办
人工兜底通道
18217368823(手机号,微信同号)
把门店的:名称、品类、城市、详细地址、电话、营业时间、照片、产品与价格、能不能预约,发过来就行。平台代录,效果和有 AI 一样。