AkashiDocs
Providers

OpenWeather

Current weather, a 5-day forecast and air quality anywhere on Earth, plus city → coordinates geocoding.

  • Provider id: openweather
  • Tools: 4, at $0.005 per call
  • Categories: Weather & Earth, Maps & Places
  • Homepage: openweathermap.org
  • Provider docs: openweathermap.org/api
  • Licence: CC BY-SA 4.0
  • Attribution: OpenWeather
ToolPriceWhat it does
openweather/air-quality$0.005Air quality now for a city or coordinates: 1–5 index with its level, plus PM2.5, PM10, O₃, NO₂ and more.
openweather/current$0.005Weather right now for a city or coordinates: temperature, feels-like, humidity, wind, rain, sunrise.
openweather/forecast$0.005Forecast for the next 5 days: the next 24 h in 3-hour steps, then a high/low summary per day.
openweather/geocode$0.005Turn a city or town name into latitude/longitude candidates with state and country.

Inputs are JSON bodies, and unknown fields are rejected with 422 invalid_input (not charged). POST /v1/inspect with a tool's id returns the same input schema, plus the output schema.

OpenWeather Air Quality

openweather/air-quality · $0.005 per call (standard) · Weather & Earth

Air quality now for a city or coordinates: 1–5 index with its level, plus PM2.5, PM10, O₃, NO₂ and more.

Current air pollution from OpenWeather's model: the 1–5 air quality index with its name (Good, Fair, Moderate, Poor, Very Poor) and concentrations of CO, NO, NO₂, O₃, SO₂, PM2.5, PM10 and NH₃ in μg/m³. Give lat + lon, or a city (looked up first with OpenWeather geocoding, taking the best match). The index is OpenWeather's European-style scale, not the US EPA AQI. No pollen data.

Related: openweather/current, openweather/geocode.

Input

FieldTypeRequiredDescription
citystringnoCity name, optionally with state and ISO country code: 'Lagos,NG', 'Springfield,IL,US', 'Paris,FR'. 2–100 characters.
latnumbernoLatitude, with lon (instead of city). From -90 to 90.
lonnumbernoLongitude, with lat. From -180 to 180.

Example

Input
{
  "city": "Delhi,IN"
}
Run it with the CLI
node akashi.mjs run openweather/air-quality --input '{"city":"Delhi,IN"}'

OpenWeather Current Weather

openweather/current · $0.005 per call (standard) · Weather & Earth

Weather right now for a city or coordinates: temperature, feels-like, humidity, wind, rain, sunrise.

Current conditions from OpenWeather's station and model blend, refreshed about every 10 minutes: description, temperature (with feels-like and the local min/max), humidity, pressure, wind, cloud cover, visibility, last-hour rain or snow, and local sunrise/sunset, all in the place's own time zone. Give a city ('Lagos,NG') or lat + lon. For the days ahead use openweather/forecast; for pollution use openweather/air-quality.

Related: openweather/forecast, openweather/air-quality, openweather/geocode.

Input

FieldTypeRequiredDescription
citystringnoCity name, optionally with state and ISO country code: 'Lagos,NG', 'Springfield,IL,US', 'Paris,FR'. 2–100 characters.
latnumbernoLatitude, with lon (instead of city). From -90 to 90.
lonnumbernoLongitude, with lat. From -180 to 180.
unitsstringnometric (°C, m/s), imperial (°F, mph) or standard (K). One of metric, imperial, standard. Default "metric".

Example

Input
{
  "city": "Lagos,NG",
  "units": "metric"
}
Run it with the CLI
node akashi.mjs run openweather/current --input '{"city":"Lagos,NG","units":"metric"}'

OpenWeather 5-Day Forecast

openweather/forecast · $0.005 per call (standard) · Weather & Earth

Forecast for the next 5 days: the next 24 h in 3-hour steps, then a high/low summary per day.

OpenWeather's 5-day / 3-hour forecast, condensed for an agent: the next 24 hours as 8 three-hourly points (temperature, feels-like, chance of precipitation, rain or snow, wind) and then one summary per local calendar day (most common conditions, low/high, highest precipitation chance, total rain and snow, strongest wind). Times are in the place's own time zone. Not hourly and not beyond 5 days. For conditions right now use openweather/current.

Related: openweather/current, openweather/geocode.

Input

FieldTypeRequiredDescription
citystringnoCity name, optionally with state and ISO country code: 'Lagos,NG', 'Springfield,IL,US', 'Paris,FR'. 2–100 characters.
latnumbernoLatitude, with lon (instead of city). From -90 to 90.
lonnumbernoLongitude, with lat. From -180 to 180.
unitsstringnometric (°C, m/s), imperial (°F, mph) or standard (K). One of metric, imperial, standard. Default "metric".

Example

Input
{
  "city": "London,GB",
  "units": "metric"
}
Run it with the CLI
node akashi.mjs run openweather/forecast --input '{"city":"London,GB","units":"metric"}'

OpenWeather Geocoding

openweather/geocode · $0.005 per call (standard) · Maps & Places

Turn a city or town name into latitude/longitude candidates with state and country.

Looks up populated places by name and returns up to 5 candidates with latitude, longitude, state and ISO country code, so you can disambiguate 'Springfield' before asking for weather. Cities, towns and districts only: not street addresses, businesses or landmarks (use serper/places for those). No match comes back as found: false.

Related: openweather/current, serper/places.

Input

FieldTypeRequiredDescription
querystringyesCity or town, optionally ',<state>,<country code>': 'Springfield', 'Springfield,IL,US', 'Lagos,NG'. 2–100 characters.
limitintegernoCandidates to return. From 1 to 5. Default 5.

Example

Input
{
  "query": "Springfield",
  "limit": 3
}
Run it with the CLI
node akashi.mjs run openweather/geocode --input '{"query":"Springfield","limit":3}'

On this page