aid: colorfulclouds name: ColorfulClouds description: >- ColorfulClouds Tech (彩云科技, Beijing-based) operates the Caiyun Weather API (api.caiyunapp.com), a hyperlocal weather + air quality forecasting service with minute-level precipitation, hourly forecasts up to 360 hours, daily forecasts up to 15 days, real-time AQI/pollutant readings, severe-weather alerts, and a precipitation map raster. The v2.6 platform powers consumer apps (Amap, Sina Weather) and enterprise weather integrations across China and globally, billed via tiered token plans on the Open Platform. url: https://docs.caiyunapp.com/weather-api/ image: https://caiyunapp.com/static/img/logo.png humanURL: https://caiyunapp.com/ specificationVersion: '0.20' created: '2026-05-28' modified: '2026-05-30' x-source: public-apis/public-apis x-category: Weather x-type: company x-tier: 2 tags: - Weather - Forecasting - Air Quality - Precipitation - Hyperlocal - Geospatial - China apis: - name: Caiyun Weather API description: >- Caiyun Weather API v2.6 — hyperlocal weather, minute-level precipitation, hourly/daily forecasts, air quality, life indices, severe-weather alerts, and a precipitation map raster. Single base URL with token in path and lng,lat in path, returning a unified JSON envelope with status, location, timezone, and a result block that contains realtime/minutely/hourly/daily/ alert sub-objects depending on the endpoint or granu parameter. humanURL: https://docs.caiyunapp.com/weather-api/ baseURL: https://api.caiyunapp.com/v2.6 image: https://caiyunapp.com/static/img/logo.png tags: - Weather - Forecasting - Air Quality - Precipitation - Alerts properties: - type: Documentation url: https://docs.caiyunapp.com/weather-api/ - type: SignUp url: https://platform.caiyunapp.com/ - type: OpenAPI url: openapi/colorfulclouds-caiyun-weather-openapi.yml - type: SDK title: Python SDK url: https://pypi.org/project/cy-weather-api/ - type: CodeExamples title: Python SDK Source url: https://github.com/caiyunapp/caiyun-weather-api-python-sdk - type: NaftikoCapability url: capabilities/caiyun-weather-weather.yaml - type: NaftikoCapability url: capabilities/caiyun-weather-realtime.yaml - type: NaftikoCapability url: capabilities/caiyun-weather-forecast.yaml - type: NaftikoCapability url: capabilities/caiyun-weather-air-quality.yaml - type: NaftikoCapability url: capabilities/caiyun-weather-alerts.yaml - type: NaftikoCapability url: capabilities/caiyun-weather-precipitation-map.yaml common: - type: Website url: https://caiyunapp.com/ - type: Documentation url: https://docs.caiyunapp.com/weather-api/ - type: DeveloperPortal url: https://platform.caiyunapp.com/ - type: GitHubOrganization url: https://github.com/caiyunapp - type: Tools title: MCP Server (Caiyun Weather) url: https://github.com/caiyunapp/mcp-caiyun-weather - type: Tools title: Claude Code Skills (Caiyun Weather) url: https://github.com/caiyunapp/skills - type: Tools title: AQI Hub (Air Quality Index Calculator) url: https://github.com/caiyunapp/aqi-hub - type: Tools title: cyeva (Forecast Accuracy Evaluation Toolkit) url: https://github.com/caiyunapp/cyeva - type: Plans url: plans/colorfulclouds-plans-pricing.yml - type: RateLimits url: rate-limits/colorfulclouds-rate-limits.yml - type: FinOps url: finops/colorfulclouds-finops.yml - type: Rules url: rules/colorfulclouds-rules.yml - type: Vocabulary url: vocabulary/colorfulclouds-vocabulary.yml - type: JSONLDContext url: json-ld/colorfulclouds-context.jsonld - type: PublicAPIsListing url: https://github.com/public-apis/public-apis features: - name: Minute-Level Precipitation description: >- 120-minute precipitation nowcasting with 1-minute resolution and 1-kilometer geographic precision based on radar + AI nowcasting models. - name: Hourly Forecast description: >- Hourly weather forecast for up to 360 hours covering temperature, humidity, cloud cover, weather phenomenon (skycon), precipitation, wind, pressure, visibility, downward shortwave radiation, and AQI. - name: Daily Forecast description: >- Daily forecast for up to 15 days with min/max/avg temperature, humidity, cloud cover, pressure, visibility, wind, plus daytime (08h-20h) and nighttime (20h-32h) splits for skycon, precipitation, and wind. - name: Real-Time Air Quality description: >- PM2.5, PM10, O3, SO2, NO2, CO concentrations and AQI calculated under both Chinese (HJ 633-2012) and US EPA standards with category descriptors. - name: Severe Weather Alerts description: >- Official Chinese Meteorological Administration alerts (typhoon, rainstorm, blizzard, etc.) with title, code, status, description, region, adcode, and publication timestamp. - name: Life Indices description: >- Daily and real-time life indices including ultraviolet, comfort, cold risk, dressing, and car-washing recommendations. - name: Precipitation Map Raster description: >- Radar + nowcast precipitation map tiles for embedding live precipitation animations into consumer and operational dashboards. - name: Sky Condition (Skycon) Enum description: >- Normalized weather phenomenon enum (CLEAR_DAY, PARTLY_CLOUDY_DAY, CLOUDY, LIGHT_HAZE, HEAVY_RAIN, STORM_SNOW, DUST, SAND, WIND, etc.) suitable for icon-driven UIs. - name: Multi-Language Output description: >- Localized descriptions in zh_CN, zh_TW, ja, en_GB, and en_US selectable via the lang query parameter. - name: Unit System Selection description: >- Switch between metric, metric:v1, metric:v2, imperial, and SI unit systems via the unit query parameter. useCases: - name: Mobile Weather Apps description: >- Power consumer weather apps with realtime conditions, minute-level rain forecasts, and severe-weather alerts in a single combined call. - name: Smart Home / IoT Integration description: >- Drive smart-home automations (close windows on rain, dim lights at sunset, adjust HVAC) using realtime + minutely + daily astronomical data. - name: Logistics and Delivery Routing description: >- Use hourly forecasts and precipitation nowcasts to reroute couriers, delay flights, and pre-position field crews before rain or snow events. - name: Outdoor Event Planning description: >- Combine daily forecasts, life indices, and alerts to plan outdoor events, sports, construction, and agricultural operations 5-15 days ahead. - name: Air-Quality-Aware Mobility description: >- Cycling, running, and route-planning apps surface PM2.5/AQI to recommend healthier routes and times. integrations: - name: Claude / Anthropic Agents description: >- First-party MCP server (caiyunapp/mcp-caiyun-weather) and Claude Code skills (caiyunapp/skills) expose realtime, hourly, daily, historical, and alert lookups as agent tools. - name: Home Assistant description: >- Community Home Assistant component (Yonsm/ZhiCaiYun) wraps the Caiyun API for smart-home automations. - name: Amap (Gaode Maps) description: >- Caiyun forecasts are surfaced inside Amap navigation and weather widgets as a partner data source. - name: Sina Weather description: >- Sina Weather embeds Caiyun nowcasts and 5-day forecasts in its consumer products. - name: Wego CLI description: >- Community fork of the wego terminal weather app (caiyunapp/wego) supports Caiyun as a backend. solutions: - name: Hyperlocal Weather Platform description: >- Pair the combined /weather endpoint with the precipitation map raster to ship a complete hyperlocal weather product covering realtime, minutely, hourly, daily, alerts, and map overlays. - name: Agent-Ready Weather Intelligence description: >- Run the official MCP server alongside the installable Claude Code skills to give LLM agents tool-grounded access to Caiyun forecasts and alerts. - name: Air Quality Surveillance description: >- Combine /realtime air quality, /hourly AQI series, and the open-source aqi-hub library to publish dashboards, alerts, and exposure analytics. maintainers: - FN: Kin Lane email: kin@apievangelist.com