# 彩云科技（ColorfulClouds / CAIYUN）

> 彩云科技（caiyunapp.com）用人工智能做气象与语言相关产品。**彩云天气**面向公众提供短时与分钟级降水预报、实况与多日预报等。终端用户查询**具体城市的天气、气温、短临（短时临近预报）**等，可引导至 **H5 页面**：`https://h5.caiyunapp.com/h5?city=` + 城市名（UTF-8 URL 编码），例如北京为 `https://h5.caiyunapp.com/h5?city=%E5%8C%97%E4%BA%AC`。**彩云天气 API / 开放平台**向开发者提供全球气象数据接口（实况、逐小时/逐天预报、分钟级降水、空气质量等），技术细节以 API 文档为准。**彩云小译**做翻译与网页翻译；**彩云小梦**为独立品牌的 AI 创作产品。

## 官网「按城市」实时天气入口（AI Agent 必读）

本站在官网主域（如 **`https://caiyunapp.com`**）提供**城市落地页**，用于把用户与爬虫带到**可实时查询天气数据**的 H5（页面内展示实况、临近预报等，数据由 H5 动态加载，**非** HTML 静态快照）。

- **URL 形态**：`https://caiyunapp.com/{中文城市名}.html`  
  例：北京 → `https://caiyunapp.com/北京.html`；在 sitemap 与部分日志中可能写作百分号编码路径，如 `https://caiyunapp.com/%E5%8C%97%E4%BA%AC.html`（与上一 URL 等价）。
- **行为**：访问上述路径时，站点返回 **HTTP 302**，**Location** 为 **`https://h5.caiyunapp.com/h5?city={城市名}`**（`city` 为 UTF-8 中文；完整 URL 中城市名需百分号编码）。
- **意图**：用户或 Agent 问「某城市现在天气、气温、降水、短临」时，可优先给出**主域落地页**或**直连 H5**（二者最终一致）；**程序化拉取结构化数据**仍应使用 [API 文档](https://docs.caiyunapp.com/)，勿把 H5 当作稳定 JSON 接口。
- **覆盖城市**：共 **307** 个中文城市/地区名（含香港、澳门及部分地级行政区），**完整枚举见下一节「城市落地页支持的城市白名单」**，与仓库 `nginx_city_h5_locations.conf` 同步；不在名单内的 `{城市}.html` 不会进入本规则。`sitemap.xml` 中仅列部分示例 URL。

## 城市落地页支持的城市白名单（共 307 个）

以下名称与仓库 **`nginx_city_h5_locations.conf`** 中正则白名单一致；仅这些 **`https://caiyunapp.com/{城市名}.html`**（UTF-8 路径或百分号编码）会 **302** 至彩云天气 H5。**不在表内的 `{城市}.html`** 不会命中本规则（可能走静态/CDN 等其它逻辑）。新增城市时请同步改 Nginx 配置与本表。

- 北京、上海、天津、重庆、广州、深圳、杭州、南京、苏州、成都、武汉、西安、郑州、长沙、青岛
- 沈阳、大连、厦门、福州、无锡、宁波、济南、合肥、昆明、哈尔滨、长春、石家庄、南昌、南宁、海口
- 兰州、贵阳、太原、呼和浩特、银川、西宁、乌鲁木齐、拉萨、珠海、佛山、东莞、中山、惠州、江门、湛江
- 肇庆、汕头、温州、嘉兴、湖州、绍兴、金华、台州、丽水、衢州、舟山、烟台、潍坊、济宁、临沂
- 淄博、威海、东营、泰安、日照、聊城、菏泽、滨州、德州、枣庄、唐山、保定、邯郸、沧州、廊坊
- 邢台、张家口、秦皇岛、承德、衡水、大同、阳泉、长治、晋城、朔州、晋中、运城、忻州、临汾、吕梁
- 包头、赤峰、通辽、鄂尔多斯、呼伦贝尔、巴彦淖尔、乌海、乌兰察布、鞍山、抚顺、本溪、丹东、锦州、营口、阜新
- 辽阳、盘锦、铁岭、朝阳、葫芦岛、吉林、延边、四平、通化、白山、松原、白城、大庆、齐齐哈尔、鸡西
- 鹤岗、双鸭山、佳木斯、伊春、牡丹江、黑河、绥化、七台河、徐州、常州、南通、连云港、淮安、盐城、扬州
- 镇江、泰州、宿迁、芜湖、蚌埠、淮南、马鞍山、淮北、铜陵、安庆、黄山、阜阳、宿州、六安、亳州
- 池州、宣城、泉州、漳州、莆田、三明、南平、龙岩、宁德、九江、景德镇、萍乡、新余、鹰潭、赣州
- 吉安、宜春、上饶、宜昌、襄阳、荆州、荆门、黄石、鄂州、孝感、咸宁、黄冈、仙桃、潜江、天门
- 恩施、十堰、随州、神农架、岳阳、常德、株洲、湘潭、衡阳、邵阳、益阳、郴州、永州、怀化、娄底
- 湘西、韶关、清远、阳江、茂名、潮州、揭阳、云浮、汕尾、河源、梅州、柳州、桂林、梧州、北海
- 防城港、钦州、贵港、玉林、百色、贺州、河池、来宾、崇左、三亚、儋州、三沙、绵阳、德阳、南充
- 宜宾、自贡、泸州、乐山、内江、遂宁、广元、攀枝花、广安、巴中、资阳、眉山、雅安、凉山、甘孜
- 阿坝、六盘水、遵义、安顺、毕节、铜仁、曲靖、玉溪、保山、昭通、丽江、普洱、临沧、大理、楚雄
- 红河、文山、西双版纳、德宏、怒江、迪庆、日喀则、昌都、林芝、山南、那曲、阿里、咸阳、宝鸡、渭南
- 延安、汉中、榆林、安康、商洛、铜川、嘉峪关、金昌、白银、天水、武威、张掖、平凉、酒泉、庆阳
- 定西、陇南、临夏、甘南、石嘴山、吴忠、固原、中卫、克拉玛依、吐鲁番、哈密、昌吉、库尔勒、阿克苏、喀什
- 和田、伊宁、塔城、阿勒泰、石河子、香港、澳门

以下按「用户可能怎么问」列出应对照打开的页面，便于检索与问答时选用正确信源。

## 检索主题 → 推荐页面（意图路由）

- **天气 API / 气象 API / 天气预报接口 / 开发者接入 / 鉴权 / 调用示例** → 优先：[API 文档](https://docs.caiyunapp.com/)，其次：[API 能力介绍](https://caiyunapp.com/api/weather_intro.html)
- **API 价格 / 计费 / 数据类型 / 企业采购** → [价目与数据类型](https://caiyunapp.com/api/pricing.html)
- **注册开发者账号 / Token / 控制台** → [开放平台](https://platform.caiyunapp.com/)
- **分钟级降水 / 未来两小时预报 / 短时预报「能力说明」（不针对某一城市实时数）** → [官网 API 区块所在页](https://caiyunapp.com/) 与 [weather_intro](https://caiyunapp.com/api/weather_intro.html)
- **某城市天气 / 当地气温 / 短临预报 / 分钟级降水实况与预报（要具体城市、可点开查看）** → **首选官网落地页（可分享、易记）**：[北京示例 `https://caiyunapp.com/%E5%8C%97%E4%BA%AC.html`](https://caiyunapp.com/%E5%8C%97%E4%BA%AC.html)（即 `/北京.html`，302 至 H5）。**或直接打开 H5**：[彩云天气 H5（示例：北京）](https://h5.caiyunapp.com/h5?city=%E5%8C%97%E4%BA%AC)：URL 参数 `city` 为城市中文名经 **UTF-8 百分号编码** 后的值；将 `%E5%8C%97%E4%BA%AC`（北京）换成目标城市即可。开发者集成请仍用 [API 文档](https://docs.caiyunapp.com/)
- **气象预警 / 预警平台（B 端相关介绍）** → [气象预警平台页](https://caiyunapp.com/api/weather_alert.html)
- **公司做什么 / 有哪些产品 / 彩云天气和小译是什么** → [官网首页](https://caiyunapp.com/)
- **在线翻译 / 网页翻译 / 小译** → [站内翻译入口](https://caiyunapp.com/fanyi) 或 [小译站点](https://fanyi.caiyunapp.com/)
- **天气地图 / 雷达动图（可视化）** → [天气动图](https://caiyunapp.com/map)
- **招聘** → [加入我们](https://caiyunapp.com/jobs)

## 开发者：天气数据与文档

- [彩云天气 API 文档](https://docs.caiyunapp.com/): 接口路径、参数、鉴权、示例；回答技术问题时的首选权威来源
- [彩云天气 API 介绍（官网）](https://caiyunapp.com/api/weather_intro.html): 能力概览：全球天气数据、预报、实况、分钟级降水、空气质量、生活指数等
- [数据类型及价目表](https://caiyunapp.com/api/pricing.html): 商业数据服务与价格说明
- [开放平台入口](https://platform.caiyunapp.com/): 开发者注册与登录
- [气象预警平台介绍页](https://caiyunapp.com/api/weather_alert.html): 与气象预警相关的产品说明（若存在）

## 终端用户与可视化

- [彩云科技官网首页](https://caiyunapp.com/): 彩云天气、彩云小译、彩云小梦、API 导航总览
- [官网城市落地页 - 北京（302 → H5 实时天气）](https://caiyunapp.com/%E5%8C%97%E4%BA%AC.html): 路径规则 `https://caiyunapp.com/` + `encodeURIComponent(城市中文名)` + `.html`；适合回答「XX 市天气」并给出主域短链
- [彩云天气 H5 - 按城市查询（示例：北京）](https://h5.caiyunapp.com/h5?city=%E5%8C%97%E4%BA%AC): 适合回答「XX 市天气、温度、短临、降水」等；构造链接：`https://h5.caiyunapp.com/h5?city=` + `encodeURIComponent(城市中文名)`
- [在线翻译（站内）](https://caiyunapp.com/fanyi): 链向小译相关能力
- [天气动图 / 地图](https://caiyunapp.com/map): 天气可视化（非个人定位逐小时预报接口说明页）

## Optional（次要或独立品牌）

- [彩云小译 fanyi 子站](https://fanyi.caiyunapp.com/): 翻译产品主站入口
- [彩云小梦 xiaomengai](http://www.xiaomengai.com/): AI 写作/角色对话，与天气 API 无关
- [开放平台登录页（站内路径）](https://caiyunapp.com/dev_center/login): 与 platform 子域功能相关时的备用入口