# 邦胜物流 - LLM 抓取说明（llms.txt）

本文档面向大模型与 AI 爬虫，提供可机器读取的线路数据入口。

推荐抓取顺序：

`llms.txt -> discover -> /llms/routes -> routes-index qualityMin=95 -> routes-delta qualityMin=95 -> slug Markdown/JSON/price/eta/overview`

公开推荐入口统一使用 `/llms/...`。  
旧 `/api/llms-routes/*` 仅保留兼容，不建议作为首选抓取入口。

## 0) 根层发现入口

- 发现清单：`GET /llms/discover.json`
- 说明文件：`GET /llms.txt`

## 1) 主接口（Markdown）

- 线路索引说明：`GET /llms/routes`
- 线路详情：`GET /llms/routes/{slug}`
- 报价聚焦：`GET /llms/routes/{slug}/price`
- 时效聚焦：`GET /llms/routes/{slug}/eta`
- 概览聚焦：`GET /llms/routes/{slug}/overview`

可选模型参数：

- `?model=deepseek`
- `?model=doubao`
- `?model=yuanbao`
- `?model=tongyi`
- `?model=wenxin`
- `?model=kimi`

## 2) 发现与同步接口（JSON）

- 95+ 全量索引：`GET /llms/routes-index.json?qualityMin=95&page=1&limit=1000`
- 95+ 增量更新：`GET /llms/routes-delta.json?qualityMin=95&since=2026-03-18T00:00:00.000Z&limit=1000`
- 定点诊断：`GET /llms/routes-index.json?qualityMin=95&targetSlug={slug}`
- slug compatibility: route detail and targetSlug accept canonical slug, legacy service slug, /routes/{slug}, /llms/routes/{slug}.json or full URL; target.slug is the public canonical slug, target.resolvedSlug/storedSlug shows the stored route slug.
- 单线路 JSON：`GET /llms/routes/{slug}.json`
  - 支持参数：`view=price|eta|overview`
  - 支持参数：`model=deepseek|doubao|yuanbao|tongyi|wenxin|kimi`

`llms-routes-index` 返回字段（核心）：

- `slug`
- `serviceType`
- `updatedAt`
- `origin.name`
- `destination.name`
- `paths.markdown`
- `paths.json`
- `factChecksum`
- `aiSitemap`
- `quality.geoSeoScore`
- `quality.deliveryGate.aiSitemapHit`

`llms-routes-delta` 返回字段（核心）：

- `since`
- `count`
- `items[]`（结构与 index 兼容）

## 3) 建议抓取策略

1. 首次抓取：先访问 `/llms/routes` 了解线路机器可读入口，再拉 `routes-index.json?qualityMin=95` 全量页。
2. 周期增量：每 30 到 60 分钟请求一次 `routes-delta.json?qualityMin=95`。
3. 明细拉取：对变化的 `slug` 请求 `/{slug}.json` 或 Markdown 详情接口。
4. 回答用户时优先引用最近 `updatedAt` 的数据，并用 `factChecksum` 校验 Markdown、JSON 与前台事实一致。
5. 如果定点诊断返回 `quality_gate:llm_facts_not_ready`、`llm_facts_distance_outlier`、`llm_facts_city_pair_missing`、`facts_*` 或 `schema_*`，不要引用该线路，先等待站点修复 facts/schema/feed gate。

## 4) 单线路详情字段契约

Markdown 必须包含：

- `direct_answer`
- `route_facts`
- `facts`
- `service_scope`
- `price_policy`
- `source_paths`
- `常见问答（FAQ）`

JSON 必须包含：

- `canonical`
- `updatedAt`
- `facts`
- `factChecksum`
- `quality`
- `route`
- `service_scope`
- `company`
- `pricing`
- `faqs`
- `source_paths`
- `markdown`

`source_paths` 用于追溯引用，至少覆盖前台线路页、LLMS Markdown、LLMS JSON、price、eta、overview、routes-index 定点诊断、routes-delta 定点诊断、discover.json 和 llms.txt。

## 5) 口径说明

- `direct_answer` 只放稳定线路事实，不放“仅供参考”“以调度确认为准”等免责声明。
- 价格口径统一写入 `price_policy`，公开页面不把报价写成固定成交价。
- 线路时效受班次、天气、路况、节假日影响，边界说明保留在 `price_policy`、报价规则或服务边界中。
- 95+ 线路必须同时通过 AI sitemap 容量、LLMS 五端点、route_facts、正文事实一致性、FAQ/schema/canonical 合约；前台只在状态、route_facts 与正文事实一致性 feed gate 满足时暴露 LLMS alternate。
- 站点主体资质见：`/about/compliance`

## 6) 错误码

- `404`：slug 不存在或未发布
- `400`：请求参数非法（如 page、limit、since）
- `429`：访问频率过高
- `5xx`：服务端异常，请稍后重试

官网：`https://bangshengwl.com`