Agent Skills
› cloudflare/nimbus
› call-sample-co-api
call-sample-co-api
GitHub调用 Sample Co 天气 API 获取实时天气、预报、警报及空气质量等数据。支持坐标或地名查询，涵盖海洋、航空等专业气象信息，用于依赖天气数据的决策与代码集成。
Trigger Scenarios
需要获取特定地点的当前天气状况
请求未来天气预报（如降雨、每日预报）
查询恶劣天气警报或严重天气预警
需要气象相关决策数据（如霜冻风险、农业窗口期）
查询空气质量、花粉、海洋或航空气象数据
Install
npx skills add cloudflare/nimbus --skill call-sample-co-api -g -y
SKILL.md
Frontmatter
{
"name": "call-sample-co-api",
"description": "Call the Sample Co Weather API for forecasts, current conditions, severe-weather alerts and weather-dependent decisions at a place. Use when a task needs weather data for coordinates or a place name, or code that integrates the Weather API."
}
Call the Sample Co Weather API
Docs: https://demo.nimbus-docs.com/llms.txt. Every page has a Markdown version at <page>/index.md.
When to use it
- Weather now, or forecasts from minute-by-minute rain (next two hours) to daily forecasts (sixteen days).
- Severe-weather alerts from national services, polled or pushed to a webhook.
- Decisions that depend on the weather: frost risk, spray windows, soil conditions, lightning nearby.
- Also: air quality and pollen, marine (waves, tides, sea temperature), aviation (METAR, TAF), tropical cyclones, solar and wind resource, radar and satellite tiles, history back to 1940.
- Not for: forecasts beyond sixteen days, or an official aviation briefing.
Request basics
- Base URL:
https://api.weather.example/v2. - Auth:
Authorization: Bearer <key>. Keys startingwx_test_are free and return realistic fixed data;wx_live_keys are billed. Read the key fromWEATHER_API_KEY; never print it. - Times are UTC; units are metric unless you pass
units=imperial. - Versions: v2 is current. v1 stops responding on 2026-12-31; don't write new v1 code. https://demo.nimbus-docs.com/concepts/versioning/index.md
- Errors share one shape,
{"error": {"type", "code", "message", "request_id"}}. Retry429afterRetry-Afterseconds, and500with backoff. https://demo.nimbus-docs.com/concepts/errors/index.md - Lists paginate with
cursor: pass the previous response'snext_cursor. https://demo.nimbus-docs.com/concepts/pagination/index.md
Common operations
Find a place, then use its coordinates:
curl "https://api.weather.example/v2/locations/search?q=Oslo" -H "Authorization: Bearer $WEATHER_API_KEY"
Reference: https://demo.nimbus-docs.com/api/locations/search-locations/index.md
A daily forecast (days up to 16):
curl "https://api.weather.example/v2/forecasts/daily?latitude=59.91&longitude=10.75&days=7" -H "Authorization: Bearer $WEATHER_API_KEY"
Reference: https://demo.nimbus-docs.com/api/forecasts/get-daily-forecast/index.md
Active alerts, filtered by country and severity:
curl "https://api.weather.example/v2/alerts?country=NO&severity=severe" -H "Authorization: Bearer $WEATHER_API_KEY"
Reference: https://demo.nimbus-docs.com/api/alerts/list-active-alerts/index.md
Everything else
Every endpoint, grouped by product: https://demo.nimbus-docs.com/api/index.md. The OpenAPI document: https://demo.nimbus-docs.com/api/openapi.json.
Version History
- 6871d86 Current 2026-11-07 12:33
