Faro
Tools/weather
Weather

Weather

Active

Your agent has no live weather; this returns current conditions and a multi-day forecast for any place.

3 tools

Current conditions and multi-day forecasts by location, plus a place-name to coordinates lookup so a city name is enough to get the weather.

Maps & Weatherweatherforecastclimateconditions

Tools (3)

▶current

Current weather conditions for a coordinate (temperature, wind, humidity, conditions).

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

  • “What's the weather in Tokyo right now?”
  • “Current temperature at these coordinates”
  • “Is it raining in London at the moment?”

Parameters

latnumberrequired

Latitude in decimal degrees.

lonnumberrequired

Longitude in decimal degrees.

langstringoptional

Language code for weather descriptions (e.g. "en").

unitsstringoptionaldefault: "metric"

Temperature and wind units. metric=Celsius, imperial=Fahrenheit.

API Usage

curl -X POST "https://skill.askfaro.com/skills/weather/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "What's the weather in Tokyo right now?"
  }
}'

CLI Usage

askfaro describe weather/current

Install pip install askfaro-cli, then askfaro auth login.

▶forecast

Weather forecast for a coordinate at a chosen resolution (15-minute, hourly, or daily).

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

  • “Will it rain in London tomorrow?”
  • “Give me the daily forecast for these coordinates”
  • “Hourly forecast for Tokyo this weekend”
  • “Is rain coming in the next hour here?”

Parameters

latnumberrequired

Latitude in decimal degrees.

lonnumberrequired

Longitude in decimal degrees.

langstringoptional

Language code for weather descriptions (e.g. "en").

unitsstringoptionaldefault: "metric"

Temperature and wind units. metric=Celsius, imperial=Fahrenheit.

timelinestringrequireddefault: "1day"

Forecast resolution: 1day (multi-day), 1h (hourly), or 15min (next-hour precipitation).

API Usage

curl -X POST "https://skill.askfaro.com/skills/weather/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Will it rain in London tomorrow?"
  }
}'

CLI Usage

askfaro describe weather/forecast

Install pip install askfaro-cli, then askfaro auth login.

▶geocode

Resolve a city or place name into coordinates to feed the forecast tool.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

  • “Get coordinates for Paris, France”
  • “Find the latitude and longitude of Springfield”
  • “Look up coordinates for Tokyo”

Parameters

qstringrequired

Place name, optionally as "City,state,country" (state is US-only), e.g. "London,GB".

limitintegeroptionaldefault: 5

Number of candidate matches (1-5).

API Usage

curl -X POST "https://skill.askfaro.com/skills/weather/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Get coordinates for Paris, France"
  }
}'

CLI Usage

askfaro describe weather/geocode

Install pip install askfaro-cli, then askfaro auth login.