openweathermap-api-integrationlisted
Install: claude install-skill rajedev/AIWeatherApp
# OpenWeatherMap API Integration
## Free-tier endpoints — the only ones this skill uses
No card, no subscription activation required for any of these:
| Endpoint | Gives you |
|---|---|
| `api.openweathermap.org/data/2.5/weather` | Current conditions |
| `api.openweathermap.org/data/2.5/forecast` | 5 days, 3-hour steps (40 points) |
| `api.openweathermap.org/geo/1.0/direct` | Name → lat/lon (forward geocoding) |
| `api.openweathermap.org/geo/1.0/reverse` | Lat/lon → name (reverse geocoding) |
These four endpoints fully cover current + short-range forecast + city
resolution.
## Deprecated: city name / city ID directly on weather endpoints
```
# Deprecated — still works, but no further bug fixes or updates:
GET /data/2.5/weather?q={city name}&appid={key}
GET /data/2.5/forecast?id={city id}&appid={key}
```
Don't build new integrations on `q=`/`id=` against the weather/forecast endpoints. Use the dedicated Geocoding API to resolve a name to coordinates first, then call weather/forecast with `lat`/`lon` only — that's the supported, maintained path.
## Geocoding — forward (search) and reverse (resolve-from-coordinates)
```
GET /geo/1.0/direct?q={city name},{state code},{country code}&limit=5&appid={key}
GET /geo/1.0/reverse?lat={lat}&lon={lon}&limit=5&appid={key}
```
- `limit` matters on the forward call: same-named places are common (London, UK vs. London, US) — always request `limit>1` and let the user disambiguate rather than silently taking the first result.
- State c