name: weather-api description: Reference documentation for the Open-Meteo free weather API. Use this skill to learn how to fetch weather forecasts using curl. The API requires latitude/longitude coordinates and returns JSON data. No API key required.

Open-Meteo Weather API Reference

Open-Meteo is a free, open-source weather API. No API key, registration, or credit card required for non-commercial use.

Base URL

https://api.open-meteo.com/v1/forecast

Required Parameters

Parameter	Type	Description
`latitude`	float	WGS84 latitude coordinate (e.g., 40.7128 for New York)
`longitude`	float	WGS84 longitude coordinate (e.g., -74.0060 for New York)

Common US City Coordinates

City	Latitude	Longitude
New York, NY	40.7128	-74.0060
Los Angeles, CA	34.0522	-118.2437
Chicago, IL	41.8781	-87.6298
Houston, TX	29.7604	-95.3698
Phoenix, AZ	33.4484	-112.0740
Seattle, WA	47.6062	-122.3321
Denver, CO	39.7392	-104.9903
Miami, FL	25.7617	-80.1918

Useful Optional Parameters

Parameter	Values	Description
`hourly`	comma-separated list	Hourly weather variables to return
`daily`	comma-separated list	Daily weather variables to return
`temperature_unit`	`celsius` (default), `fahrenheit`	Temperature unit
`wind_speed_unit`	`kmh` (default), `ms`, `mph`, `kn`	Wind speed unit
`precipitation_unit`	`mm` (default), `inch`	Precipitation unit
`timezone`	`auto`, `America/New_York`, etc.	Timezone for timestamps
`forecast_days`	1-16	Number of forecast days (default: 7)

Hourly Variables

Common hourly variables for hourly= parameter:

temperature_2m - Air temperature at 2m height
relative_humidity_2m - Relative humidity at 2m
apparent_temperature - Feels-like temperature
precipitation - Total precipitation (rain + snow)
rain - Rain only
snowfall - Snowfall
weather_code - WMO weather condition code
cloud_cover - Total cloud cover percentage
wind_speed_10m - Wind speed at 10m height
wind_direction_10m - Wind direction at 10m
wind_gusts_10m - Wind gusts at 10m
visibility - Visibility in meters
uv_index - UV index

Daily Variables

Common daily variables for daily= parameter:

temperature_2m_max - Maximum daily temperature
temperature_2m_min - Minimum daily temperature
apparent_temperature_max - Maximum feels-like temperature
apparent_temperature_min - Minimum feels-like temperature
precipitation_sum - Total daily precipitation
precipitation_probability_max - Maximum precipitation probability
weather_code - WMO weather condition code
sunrise - Sunrise time
sunset - Sunset time
wind_speed_10m_max - Maximum wind speed
uv_index_max - Maximum UV index

WMO Weather Codes

Code	Description
0	Clear sky
1, 2, 3	Mainly clear, partly cloudy, overcast
45, 48	Fog
51, 53, 55	Drizzle (light, moderate, dense)
61, 63, 65	Rain (slight, moderate, heavy)
71, 73, 75	Snow fall (slight, moderate, heavy)
80, 81, 82	Rain showers (slight, moderate, violent)
95	Thunderstorm
96, 99	Thunderstorm with hail

Example CURL Commands

Basic 7-Day Forecast (Daily High/Low)

curl "https://api.open-meteo.com/v1/forecast?latitude=40.7128&longitude=-74.0060&daily=temperature_2m_max,temperature_2m_min,weather_code&temperature_unit=fahrenheit&timezone=America/New_York"

7-Day Forecast with Precipitation

curl "https://api.open-meteo.com/v1/forecast?latitude=40.7128&longitude=-74.0060&daily=temperature_2m_max,temperature_2m_min,precipitation_sum,precipitation_probability_max,weather_code&temperature_unit=fahrenheit&precipitation_unit=inch&timezone=America/New_York"

Hourly Forecast for Next 24 Hours

curl "https://api.open-meteo.com/v1/forecast?latitude=40.7128&longitude=-74.0060&hourly=temperature_2m,precipitation,weather_code&temperature_unit=fahrenheit&timezone=America/New_York&forecast_days=1"

Complete Daily Forecast

curl "https://api.open-meteo.com/v1/forecast?latitude=40.7128&longitude=-74.0060&daily=temperature_2m_max,temperature_2m_min,apparent_temperature_max,apparent_temperature_min,precipitation_sum,precipitation_probability_max,weather_code,sunrise,sunset,wind_speed_10m_max,uv_index_max&temperature_unit=fahrenheit&wind_speed_unit=mph&precipitation_unit=inch&timezone=America/New_York"

Current Conditions (Use hourly with forecast_days=1)

curl "https://api.open-meteo.com/v1/forecast?latitude=40.7128&longitude=-74.0060&hourly=temperature_2m,relative_humidity_2m,apparent_temperature,weather_code,wind_speed_10m,wind_direction_10m&temperature_unit=fahrenheit&wind_speed_unit=mph&timezone=America/New_York&forecast_days=1"

Example JSON Response Structure

{
  "latitude": 40.71,
  "longitude": -74.0,
  "timezone": "America/New_York",
  "daily": {
    "time": ["2024-01-15", "2024-01-16", "2024-01-17", ...],
    "temperature_2m_max": [42.5, 38.2, 35.1, ...],
    "temperature_2m_min": [32.1, 28.4, 25.0, ...],
    "weather_code": [3, 61, 71, ...]
  },
  "daily_units": {
    "temperature_2m_max": "°F",
    "temperature_2m_min": "°F",
    "weather_code": "wmo code"
  }
}

Tips

Always use timezone=auto or specify a timezone to get local times
Use temperature_unit=fahrenheit for US users
Use wind_speed_unit=mph and precipitation_unit=inch for US units
Parse the time array to match up with weather values at the same index
Use jq to parse JSON responses in bash scripts

Name	weather-api
Description	Reference documentation for the Open-Meteo free weather API. Use this skill to learn how to fetch weather forecasts using curl. The API requires latitude/longitude coordinates and returns JSON data. No API key required.

weather-api

SKILL.md