给 AI 机器人员工用的入口

不是「给网站加个聊天框」,而是同一份数据修一条独立的机器高速路:发现 → 读 → 写 → 交易 → 治理

场景验收(北极星):一个从未见过本站的 AI 员工,只拿到 /llms.txt,应能在 5 分钟内自己发现 OpenAPI / MCP 入口,完成「按参数检索 → 口径一致地比较 → 取三家带时间戳的认证报价 → 生成一张不越权的询价单」。本页为静态演示,接口样例数据见 /api/products.json。

五层开放架构

P0 只读全开、写能力收紧;agents.txt 多提案竞争,只观望不落地

L1 发现层 MVP 必须

/robots.txt(RFC 9309)、/sitemap.xml、/llms.txt(v2 + 同 URL .md)、/openapi.json。P1 加 /.well-known/agent-card.json(A2A v1.0 规范路径,兼容旧 agent.json)。

L2 内容层 MVP 必须

产品页内嵌 Product + Offer/AggregateOffer + Brand + Review 的 JSON-LD;参数用 additionalProperty + PropertyValue 带 propertyID / unitCode / measurementTechnique;语义化 HTML;.md 干净视图。

L3 能力层 MVP 必须 · 读写分离

只读 OpenAPI 3.2:/products、/products/{id}/specs、/offers、/compare;MCP Server(Streamable HTTP)resources 暴露产品/参数/报价,tools 仅 search_products / get_product / compare_specs / list_offers / request_quote。读工具与写工具分域名、分 OAuth scope、分 token audience(RFC 8707)。

L4 交易层 MVP 只到询价

request_quote 只创建带 TTL 的询价单,不自动下单;下单 / 支付 / 改地址必须用户显式确认;服务端按 quote_id 重算金额,绝不信任智能体回传价格。

L5 治理层 MVP 必须 · 横切全部

OAuth 2.1 + PKCE + resource 参数;按 agent 身份分级限流配额(服务端独立执行);全量审计;响应强制 source_url / as_of / stale / confidence / seller.license_status;智能体视图字段白名单,商家自由文本标 untrusted。

契约样例

给 AI 员工看的,不是给人看的营销文案
/llms.txt(节选)text/markdown
# 红门资讯
> AI 产业产品数据库;所有报价带 as_of 与 valid_until。

## 产品目录
- [硬件分类](https://www.1p2p3p.com/products.html)
- [每日报价](https://www.1p2p3p.com/offers.html)

## 机器接口
- [OpenAPI 3.2](https://www.1p2p3p.com/openapi.json)
- [MCP Server](https://www.1p2p3p.com/mcp)
- [字段与口径说明](https://www.1p2p3p.com/agent.html)

## Optional
- [AI 编辑团队](https://www.1p2p3p.com/editors.html)
MCP tools(只读 + 单写)Streamable HTTP
resources
  product://{pid}
  product://{pid}/specs
  product://{pid}/offers

tools  # 只读 scope: catalog.read
  search_products(filter, spec, sort)
  get_product(pid)
  compare_specs(ids[], fields[])
  list_offers(pid, fresh_within, verified_only)

tools  # 写 scope: quote.write(独立域名/token)
  request_quote(pid, seller_id, qty, ttl)
  # 无 place_order / 无 pay
API 响应(强制可信字段)/api/v1/offers
{
  "quote_id": "q_demo_001",
  "pid": "HW-GPU-000137",
  "amount": null,          // 演示占位
  "currency": "CNY", "price_unit": "per_unit",
  "tax_included": true, "moq": 1,
  "lead_time": "in_stock_3d", "warranty": "3y",
  "seller": { "id": "s_demo_0081", "license_status": "verified" },
  "as_of": "2026-11-10T09:12:00+08:00",
  "valid_until": "2026-11-11T09:12:00+08:00",
  "source_url": "https://www.1p2p3p.com/offers.html",
  "stale": false, "confidence": "verified"
}

一次完整的调用链路

查与比无条件开放,写与买层层收紧
01
发现
读 /llms.txt 找到 API 与 MCP
02
鉴权
OAuth 2.1 + PKCE,只读 token
03
检索
显存 ≥80GB、FP8 稠密口径
04
比较
口径不一致直接拒答
05
取价
24h 内 / 认证 / 未过期
06
询价
切换写 scope,创建带 TTL 的 Quote

机器可读文件清单

静态原型已附样例,生产版由 Express 服务层提供
数据开放策略(老板已批):P0 全站只读公开 + 免费 API Key 限流,先把生态做起来;按次计费 / Content-Signal / x402 等商业化能力放 P2。标准状态提醒:llms.txt 是社区约定而非正式标准;agents.txt/agents.json 目前是多套竞争草案且 IANA 未注册,本站只观望;可押注的是 JSON-LD、OpenAPI、MCP、A2A 与 RFC 9309。