ColorfulClouds website screenshot

ColorfulClouds

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.

ColorfulClouds publishes 6 APIs on the APIs.io network, including Air Quality API, Alerts API, Forecast API, and 3 more. Tagged areas include Weather, Forecasting, Air Quality, Precipitation, and Hyperlocal.

The ColorfulClouds catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

ColorfulClouds’ developer surface includes authentication, documentation, tooling, and 15 more developer resources.

🌐 Visit website 📡 Source on GitHub
48.9/100 developing ▼ -7.8 Agent 31/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
6 APIs
WeatherForecastingAir QualityPrecipitationHyperlocalGeospatialChina

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 48.9/100 · developing
Contract Quality 14.2 / 25
Developer Ergonomics 5.7 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 4.8 / 13
Governance 8.3 / 12
Discoverability 8.2 / 10
Agent readiness — 31/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/colorfulclouds: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 6

Individual APIs this provider publishes, each with its own machine-readable definition.

ColorfulClouds Air Quality API

Real-time pollutant readings and AQI values under CHN and USA standards.

ColorfulClouds Alerts API

Severe-weather alerts published by the China Meteorological Administration.

ColorfulClouds Forecast API

Minute-level, hourly, and daily forecast endpoints.

ColorfulClouds Precipitation Map API

Radar + nowcast precipitation map raster for live overlays.

ColorfulClouds Realtime API

Real-time weather conditions at the requested location.

ColorfulClouds Weather API

Combined weather envelope returning realtime, minutely, hourly, daily, and alerts in one call.

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Caiyun Weather API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Colorfulclouds Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Colorfulclouds Rate Limits

4 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Colorfulclouds Finops

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Colorfulclouds Context

36 classes · 87 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

ColorfulClouds API Rules

5 rules · 4 warnings 1 info

SPECTRAL

ColorfulClouds API Rules

39 rules · 12 errors 22 warnings 5 info

SPECTRAL

JSON Schema 44

Standalone JSON Schema definitions for this provider's data models.

AirQualityRealtimeResponse

0 properties

JSON SCHEMA

AirQualityRealtime

8 properties

JSON SCHEMA

AlertAdcode

2 properties

JSON SCHEMA

AlertContentItem

15 properties

JSON SCHEMA

AlertResponse

0 properties

JSON SCHEMA

Alert

3 properties

JSON SCHEMA

AQIDescDual

2 properties

JSON SCHEMA

AQIValueDual

2 properties

JSON SCHEMA

DailyAirQuality

2 properties

JSON SCHEMA

DailyAQIItem

4 properties

JSON SCHEMA

DailyAstroItem

3 properties

JSON SCHEMA

DailyAstroTime

1 properties

JSON SCHEMA

DailyLifeIndexEntry

3 properties

JSON SCHEMA

DailyLifeIndex

5 properties

JSON SCHEMA

DailyMinMaxAvgItem

4 properties

JSON SCHEMA

DailyPrecipitationItem

5 properties

JSON SCHEMA

DailyResponse

0 properties

JSON SCHEMA

Daily

21 properties

JSON SCHEMA

DailySkyconItem

2 properties

JSON SCHEMA

DailyWindItem

4 properties

JSON SCHEMA

DailyWindProperty

2 properties

JSON SCHEMA

DateTimeValuePair

2 properties

JSON SCHEMA

EnvelopeBase

9 properties

JSON SCHEMA

HourlyAirQuality

2 properties

JSON SCHEMA

HourlyAQIItem

2 properties

JSON SCHEMA

HourlyPM25Item

2 properties

JSON SCHEMA

HourlyPrecipitationItem

3 properties

JSON SCHEMA

HourlyResponse

0 properties

JSON SCHEMA

Hourly

13 properties

JSON SCHEMA

HourlySkyconItem

2 properties

JSON SCHEMA

HourlyWindItem

3 properties

JSON SCHEMA

LifeIndexItem

2 properties

JSON SCHEMA

MinutelyResponse

0 properties

JSON SCHEMA

Minutely

6 properties

JSON SCHEMA

PrecipitationLocal

3 properties

JSON SCHEMA

PrecipitationNearest

3 properties

JSON SCHEMA

Precipitation

2 properties

JSON SCHEMA

RealtimeLifeIndex

2 properties

JSON SCHEMA

RealtimeResponse

0 properties

JSON SCHEMA

Realtime

13 properties

JSON SCHEMA

Result

7 properties

JSON SCHEMA

SkyCon

0 properties

JSON SCHEMA

WeatherResponse

0 properties

JSON SCHEMA

Wind

2 properties

JSON SCHEMA

Scroll for all 44

JSON Structure 44

JSON Structure definitions describing this provider's data shapes.

Caiyun Weather Air Quality Realtime Response Structure

0 properties

JSON STRUCTURE

Caiyun Weather Air Quality Realtime Structure

8 properties

JSON STRUCTURE

Caiyun Weather Alert Adcode Structure

2 properties

JSON STRUCTURE

Caiyun Weather Alert Content Item Structure

15 properties

JSON STRUCTURE

Caiyun Weather Alert Response Structure

0 properties

JSON STRUCTURE

Caiyun Weather Alert Structure

3 properties

JSON STRUCTURE

Caiyun Weather Aqi Desc Dual Structure

2 properties

JSON STRUCTURE

Caiyun Weather Aqi Value Dual Structure

2 properties

JSON STRUCTURE

Caiyun Weather Daily Air Quality Structure

2 properties

JSON STRUCTURE

Caiyun Weather Daily Aqi Item Structure

4 properties

JSON STRUCTURE

Caiyun Weather Daily Astro Item Structure

3 properties

JSON STRUCTURE

Caiyun Weather Daily Astro Time Structure

1 properties

JSON STRUCTURE

Caiyun Weather Daily Life Index Entry Structure

3 properties

JSON STRUCTURE

Caiyun Weather Daily Life Index Structure

5 properties

JSON STRUCTURE

Caiyun Weather Daily Min Max Avg Item Structure

4 properties

JSON STRUCTURE

Caiyun Weather Daily Precipitation Item Structure

5 properties

JSON STRUCTURE

Caiyun Weather Daily Response Structure

0 properties

JSON STRUCTURE

Caiyun Weather Daily Skycon Item Structure

2 properties

JSON STRUCTURE

Caiyun Weather Daily Structure

21 properties

JSON STRUCTURE

Caiyun Weather Daily Wind Item Structure

4 properties

JSON STRUCTURE

Caiyun Weather Daily Wind Property Structure

2 properties

JSON STRUCTURE

Caiyun Weather Date Time Value Pair Structure

2 properties

JSON STRUCTURE

Caiyun Weather Envelope Base Structure

9 properties

JSON STRUCTURE

Caiyun Weather Hourly Air Quality Structure

2 properties

JSON STRUCTURE

Caiyun Weather Hourly Aqi Item Structure

2 properties

JSON STRUCTURE

Caiyun Weather Hourly Pm25 Item Structure

2 properties

JSON STRUCTURE

Caiyun Weather Hourly Precipitation Item Structure

3 properties

JSON STRUCTURE

Caiyun Weather Hourly Response Structure

0 properties

JSON STRUCTURE

Caiyun Weather Hourly Skycon Item Structure

2 properties

JSON STRUCTURE

Caiyun Weather Hourly Structure

13 properties

JSON STRUCTURE

Caiyun Weather Hourly Wind Item Structure

3 properties

JSON STRUCTURE

Caiyun Weather Life Index Item Structure

2 properties

JSON STRUCTURE

Caiyun Weather Minutely Response Structure

0 properties

JSON STRUCTURE

Caiyun Weather Minutely Structure

6 properties

JSON STRUCTURE

Caiyun Weather Precipitation Local Structure

3 properties

JSON STRUCTURE

Caiyun Weather Precipitation Nearest Structure

3 properties

JSON STRUCTURE

Caiyun Weather Precipitation Structure

2 properties

JSON STRUCTURE

Caiyun Weather Realtime Life Index Structure

2 properties

JSON STRUCTURE

Caiyun Weather Realtime Response Structure

0 properties

JSON STRUCTURE

Caiyun Weather Realtime Structure

13 properties

JSON STRUCTURE

Caiyun Weather Result Structure

7 properties

JSON STRUCTURE

Caiyun Weather Sky Con Structure

0 properties

JSON STRUCTURE

Caiyun Weather Weather Response Structure

0 properties

JSON STRUCTURE

Caiyun Weather Wind Structure

2 properties

JSON STRUCTURE

Scroll for all 44

Examples 43

Example request and response payloads for these APIs.

Caiyun Weather Air Quality Realtime Example

8 fields

EXAMPLE

Caiyun Weather Air Quality Realtime Response Example

10 fields

EXAMPLE

Caiyun Weather Alert Adcode Example

2 fields

EXAMPLE

Caiyun Weather Alert Content Item Example

15 fields

EXAMPLE

Caiyun Weather Alert Example

3 fields

EXAMPLE

Caiyun Weather Alert Response Example

10 fields

EXAMPLE

Caiyun Weather Aqi Desc Dual Example

2 fields

EXAMPLE

Caiyun Weather Aqi Value Dual Example

2 fields

EXAMPLE

Caiyun Weather Daily Air Quality Example

2 fields

EXAMPLE

Caiyun Weather Daily Aqi Item Example

4 fields

EXAMPLE

Caiyun Weather Daily Astro Item Example

3 fields

EXAMPLE

Caiyun Weather Daily Astro Time Example

1 fields

EXAMPLE

Caiyun Weather Daily Example

21 fields

EXAMPLE

Caiyun Weather Daily Life Index Entry Example

3 fields

EXAMPLE

Caiyun Weather Daily Life Index Example

5 fields

EXAMPLE

Caiyun Weather Daily Min Max Avg Item Example

4 fields

EXAMPLE

Caiyun Weather Daily Precipitation Item Example

5 fields

EXAMPLE

Caiyun Weather Daily Response Example

10 fields

EXAMPLE

Caiyun Weather Daily Skycon Item Example

2 fields

EXAMPLE

Caiyun Weather Daily Wind Item Example

4 fields

EXAMPLE

Caiyun Weather Daily Wind Property Example

2 fields

EXAMPLE

Caiyun Weather Date Time Value Pair Example

2 fields

EXAMPLE

Caiyun Weather Envelope Base Example

9 fields

EXAMPLE

Caiyun Weather Hourly Air Quality Example

2 fields

EXAMPLE

Caiyun Weather Hourly Aqi Item Example

2 fields

EXAMPLE

Caiyun Weather Hourly Example

13 fields

EXAMPLE

Caiyun Weather Hourly Pm25 Item Example

2 fields

EXAMPLE

Caiyun Weather Hourly Precipitation Item Example

3 fields

EXAMPLE

Caiyun Weather Hourly Response Example

10 fields

EXAMPLE

Caiyun Weather Hourly Skycon Item Example

2 fields

EXAMPLE

Caiyun Weather Hourly Wind Item Example

3 fields

EXAMPLE

Caiyun Weather Life Index Item Example

2 fields

EXAMPLE

Caiyun Weather Minutely Example

6 fields

EXAMPLE

Caiyun Weather Minutely Response Example

10 fields

EXAMPLE

Caiyun Weather Precipitation Example

2 fields

EXAMPLE

Caiyun Weather Precipitation Local Example

3 fields

EXAMPLE

Caiyun Weather Precipitation Nearest Example

3 fields

EXAMPLE

Caiyun Weather Realtime Example

13 fields

EXAMPLE

Caiyun Weather Realtime Life Index Example

2 fields

EXAMPLE

Caiyun Weather Realtime Response Example

10 fields

EXAMPLE

Caiyun Weather Result Example

7 fields

EXAMPLE

Caiyun Weather Weather Response Example

10 fields

EXAMPLE

Caiyun Weather Wind Example

2 fields

EXAMPLE

Scroll for all 43

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Colorfulclouds Authentication

apiKey · 1 scheme

SECURITY

Colorfulclouds Domain Security

TLSv1.3

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Colorfulclouds Agentic Access

8 operations

8 operations · 0 acting

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

DeveloperPortal
DeveloperPortal

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

Rules
Rules
 Vocabulary
Vocabulary
 JSONLDContext
JSONLDContext

Build 5

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization
 MCP Server (Caiyun Weather)
Tools
 Claude Code Skills (Caiyun Weather)
Tools
 AQI Hub (Air Quality Index Calculator)
Tools
 cyeva (Forecast Accuracy Evaluation Toolkit)
Tools

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication

Operate 1

Status, limits, changes, and where to get help

RateLimits
RateLimits

Commercial 2

Pricing, plans, and the legal terms of use

Plans
Plans
 FinOps
FinOps

Company 1

The organization behind the API

Website
Website

Other 1

Properties that don't map to a standard resource type

PublicAPIsListing
PublicAPIsListing

Source (apis.yml)

apis.yml Raw ↑ 
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/
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
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:
- aid: colorfulclouds:colorfulclouds-air-quality-api
  name: ColorfulClouds Air Quality API
  description: Real-time pollutant readings and AQI values under CHN and USA standards.
  humanURL: https://docs.caiyunapp.com/weather-api/
  baseURL: https://api.caiyunapp.com/v2.6
  tags:
  - Air Quality
  properties:
  - type: OpenAPI
    url: openapi/colorfulclouds-air-quality-api-openapi.yml
  - type: Documentation
    url: https://docs.caiyunapp.com/weather-api/
  - type: Signup
    url: https://platform.caiyunapp.com/
  - type: SDKs
    url: https://pypi.org/project/cy-weather-api/
  - type: CodeExamples
    url: https://github.com/caiyunapp/caiyun-weather-api-python-sdk
- aid: colorfulclouds:colorfulclouds-alerts-api
  name: ColorfulClouds Alerts API
  description: Severe-weather alerts published by the China Meteorological Administration.
  humanURL: https://docs.caiyunapp.com/weather-api/
  baseURL: https://api.caiyunapp.com/v2.6
  tags:
  - Alerts
  properties:
  - type: OpenAPI
    url: openapi/colorfulclouds-alerts-api-openapi.yml
  - type: Documentation
    url: https://docs.caiyunapp.com/weather-api/
  - type: Signup
    url: https://platform.caiyunapp.com/
  - type: SDKs
    url: https://pypi.org/project/cy-weather-api/
  - type: CodeExamples
    url: https://github.com/caiyunapp/caiyun-weather-api-python-sdk
- aid: colorfulclouds:colorfulclouds-forecast-api
  name: ColorfulClouds Forecast API
  description: Minute-level, hourly, and daily forecast endpoints.
  humanURL: https://docs.caiyunapp.com/weather-api/
  baseURL: https://api.caiyunapp.com/v2.6
  tags:
  - Forecast
  properties:
  - type: OpenAPI
    url: openapi/colorfulclouds-forecast-api-openapi.yml
  - type: Documentation
    url: https://docs.caiyunapp.com/weather-api/
  - type: Signup
    url: https://platform.caiyunapp.com/
  - type: SDKs
    url: https://pypi.org/project/cy-weather-api/
  - type: CodeExamples
    url: https://github.com/caiyunapp/caiyun-weather-api-python-sdk
- aid: colorfulclouds:colorfulclouds-precipitation-map-api
  name: ColorfulClouds Precipitation Map API
  description: Radar + nowcast precipitation map raster for live overlays.
  humanURL: https://docs.caiyunapp.com/weather-api/
  baseURL: https://api.caiyunapp.com/v2.6
  tags:
  - Precipitation Map
  properties:
  - type: OpenAPI
    url: openapi/colorfulclouds-precipitation-map-api-openapi.yml
  - type: Documentation
    url: https://docs.caiyunapp.com/weather-api/
  - type: Signup
    url: https://platform.caiyunapp.com/
  - type: SDKs
    url: https://pypi.org/project/cy-weather-api/
  - type: CodeExamples
    url: https://github.com/caiyunapp/caiyun-weather-api-python-sdk
- aid: colorfulclouds:colorfulclouds-realtime-api
  name: ColorfulClouds Realtime API
  description: Real-time weather conditions at the requested location.
  humanURL: https://docs.caiyunapp.com/weather-api/
  baseURL: https://api.caiyunapp.com/v2.6
  tags:
  - Realtime
  properties:
  - type: OpenAPI
    url: openapi/colorfulclouds-realtime-api-openapi.yml
  - type: Documentation
    url: https://docs.caiyunapp.com/weather-api/
  - type: Signup
    url: https://platform.caiyunapp.com/
  - type: SDKs
    url: https://pypi.org/project/cy-weather-api/
  - type: CodeExamples
    url: https://github.com/caiyunapp/caiyun-weather-api-python-sdk
- aid: colorfulclouds:colorfulclouds-weather-api
  name: ColorfulClouds Weather API
  description: Combined weather envelope returning realtime, minutely, hourly, daily, and alerts in one call.
  humanURL: https://docs.caiyunapp.com/weather-api/
  baseURL: https://api.caiyunapp.com/v2.6
  tags:
  - Weather
  properties:
  - type: OpenAPI
    url: openapi/colorfulclouds-weather-api-openapi.yml
  - type: Documentation
    url: https://docs.caiyunapp.com/weather-api/
  - type: Signup
    url: https://platform.caiyunapp.com/
  - type: SDKs
    url: https://pypi.org/project/cy-weather-api/
  - type: CodeExamples
    url: https://github.com/caiyunapp/caiyun-weather-api-python-sdk
common:
- type: AgenticAccess
  url: agentic-access/colorfulclouds-agentic-access.yml
- type: DomainSecurity
  url: security/colorfulclouds-domain-security.yml
- type: Authentication
  url: authentication/colorfulclouds-authentication.yml
- 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