# weather-api

> Claude/Codex skill by [@vaisala-xweather](https://omgskills.com/library/vaisala-xweather/index.md) · 5 stars · Updated 2026-10-19

Build and run Xweather Weather API request URLs for data.api.xweather.com from plain-language requirements. Use when a task mentions the Xweather or legacy Aeris API, weather endpoints such as observations, conditions, forecasts, alerts, lightning, air quality, tropical cyclones, tides, or road weather; asks for an API URL or query; needs help debugging an empty or failed request; asks about access costs, endpoint multipliers, rate limits, or allowance usage; or needs guidance for the hosted Xweather MCP server at mcp.api.xweather.com, including availability, connection, authentication, and tool scoping. Also covers Xweather's attribution requirement — the 'Powered by Vaisala Xweather' credit and logo rules that apply wherever Xweather data or imagery is displayed.

## Install

```sh
git clone https://github.com/vaisala-xweather/xweather-agent-skills /tmp/xweather-agent-skills && ln -s /tmp/xweather-agent-skills/plugins/xweather/skills/weather-api ~/.claude/skills/weather-api
```

## From README

Xweather Weather API URL builder Turn a description of wanted weather data into a correct data.api.xweather.com URL — and, when credentials are available, execute it and return the data alongside the URL. Request anatomy | Segment | Example | Notes | |---|---|---| | endpoint | observations, conditions/summary | What data. 59 of them — see references/endpoints.md. | | action | closest, within, search, route, contains, affects | How to look it up. Omitted entirely for :id and :all. | | :id | seattle,wa, 98109, 44.97,-93.26, KMSP | The place or record identifier. Goes in p= instead when an action occupies the path slot. | | params | filter=, query=, fields=, limit=, from=/to=, format= | Shape the result. | | credentials | clientid + clientsecret | Query params on every request; no header form exists. | api.aerisapi.com is the legacy host and still works — always emit data.api.xweather.com.

## Links

- HTML page: https://omgskills.com/library/vaisala-xweather/xweather-agent-skills/plugins/xweather/skills/weather-api/
- GitHub: https://github.com/vaisala-xweather/xweather-agent-skills
- Author: [@vaisala-xweather](https://omgskills.com/library/vaisala-xweather/index.md)

## More from this repo

- [mapsgl](https://omgskills.com/library/vaisala-xweather/xweather-agent-skills/plugins/xweather/skills/mapsgl/index.md) — This skill should be used when working with the Xweather MapsGL JavaScript SDK for the web (@xweather/mapsgl) — setting...
   - [@vaisala-xweather](https://omgskills.com/library/vaisala-xweather/index.md) · 5 stars
- [mapsgl-android](https://omgskills.com/library/vaisala-xweather/xweather-agent-skills/plugins/xweather/skills/mapsgl-android/index.md) — This skill should be used when working with the Xweather MapsGL Android SDK (mapsgl-android-sdk / com.xweather.mapsgl)...
   - [@vaisala-xweather](https://omgskills.com/library/vaisala-xweather/index.md) · 5 stars
- [mapsgl-apple](https://omgskills.com/library/vaisala-xweather/xweather-agent-skills/plugins/xweather/skills/mapsgl-apple/index.md) — This skill should be used when working with the Xweather MapsGL SDK for Apple platforms (the MapsGL...
   - [@vaisala-xweather](https://omgskills.com/library/vaisala-xweather/index.md) · 5 stars
