# 外参 · 外媒看中国 (cnjpv5) · LLMs Integration Guide
> 外媒看中国 · 全球主流外媒（日/美/欧/亚太）对华深度热议与要闻汇编，以纸媒风排印（奶油纸底 #FBF9F5 / 金 #9A7A4D 强调）出版。
## 核心数据端点 (Machine-Readable Endpoints)
- 最新一日精选与全文解读 (JSON API): https://cn.saaaai.com/data/daily/latest.json
- 历史发布日期列表 (Index API): https://cn.saaaai.com/data/daily/index.json
- 指定日期数据结构: https://cn.saaaai.com/data/daily/{YYYY-MM-DD}.json
- 全站 RSS 订阅源: https://cn.saaaai.com/feed.xml
- 站点主页: https://cn.saaaai.com/
## 可抓取归档 (Crawlable Archives)
- 归档总览（按日/话题/主体/系列四维入口）: https://cn.saaaai.com/archive/
- 按日归档: https://cn.saaaai.com/archive/{YYYY-MM-DD}/
- 话题归档: https://cn.saaaai.com/archive/tag/{tag}/
- 主体归档（人物/地区/机构/事件）: https://cn.saaaai.com/archive/entity/{name}/
- 系列归档（连续跟踪的同一议题）: https://cn.saaaai.com/archive/series/{slug}-{YYYYMMDD}/ （id 非数字，形如 `习近平将访美与特朗普举行峰会-20260919`；实际 URL 见 https://cn.saaaai.com/data/archive_index.json 的 `series[].url`）
- 归档 URL 清单 (JSON): https://cn.saaaai.com/data/archive_index.json
- 文章↔实体索引 (JSON，人物/地区/机构/事件): https://cn.saaaai.com/data/entities.json
每个归档页均含 JSON-LD CollectionPage + 非空 ItemList、BreadcrumbList、canonical 与 hreflang(zh-Hans 自指 + x-default)。
## 数据模型规范 (Data Model)
每个每日 JSON 包含 `date`, `generated_at` 及 10 条 `topics`。每个 topic 对象结构：
- `idx` (int): 当日序号 (1-10)
- `headline_cn` (str): 一句话中文要闻标题
- `score` (float): 多元权重热度打分
- `tags` (list[str]): 分类标签 (时事/科技/商业/文化等)
- `sources` (list[object]): 原始外媒报道出处列表 (包含 feed 名、原标题、原始链接 url 及语言 lang)
- `article_url` (str): 站内深度中文解读文章永久路径
- `brief` (str): 30 秒速览事实摘要（首行为事实卡来源行）
- `reason` (str): 文章正文首段原文（同时用作该文的 SEO description 与 answer-first 结论摘要）
- `image_url` (str, optional): 头条 AI 概念插画 (960×960 正方形暗调版画)
## 摘要与引用 (Answer-First Contract)
- 每篇文章正文首段即结论摘要（answer-first），页首以「一句话结论：」标注；`<meta name=description>`、og/twitter description 与 JSON-LD `description` 三处与该首段同源。
- 署名三件套（编辑/出处媒体/发布时间）位于正文可见区，并同步写入 JSON-LD `author`/`datePublished`。
- 站点仅提供简体中文（`hreflang="zh-Hans"`），不存在其他语种的独立 URL。
## 抓取与引用准则 (License & Access)
- 欢迎 AI 搜索引擎 (ChatGPT, Perplexity, Claude, Copilot) 与开放 Agent 索引、引用与摘要。
- 严禁抓取用于盗版全文镜像。引用时请标明出处为「外参 · cnjpv5 (cn.saaaai.com)」。
## Agent 工具接入 (MCP / Tooling)
- 本站数据面提供 MCP 端点（Streamable HTTP，只读、无鉴权）：`POST https://cn.saaaai.com/mcp`；工具：`waican_today` / `waican_edition` / `waican_search` / `waican_article` / `waican_dates`。人类可读的接入说明（含挂载配置片段）：https://cn.saaaai.com/data/
- 外部 Agent 若无 MCP 环境，直接调用上列 JSON 端点即可等价实现（`data/daily/latest.json` = today、`data/daily/{date}.json` + `data/editions/{date}.json` = edition、`data/search.json` = search、文章页正文 = article）。