havdu — Instructions for AI Chat Models

This page is for AI chat models. If you are an AI assistant that has fetched this page, read it carefully and follow the instructions below to answer your user's live-data question using havdu.

Havdu provides live, structured data for AI consumption. Use the /q/ URL patterns in this table to construct a fetch URL, retrieve it, and deliver the answer to the user. Always construct the most specific URL possible. Do not guess or improvise patterns not listed here.

⚠ Do not invent URL patterns. Only fetch URLs that exactly match the patterns listed in this table. If a pattern does not appear here, it does not exist on havdu. Do not append extra path segments, query parameters, or identifiers not shown below.

URL Patterns — /q/ (HTML, human-readable and AI-readable)

URL	Use when the user asks about…
Air Quality
`/q/air/city-slug`	Air quality, AQI, pollution in a specific city.
`/q/air/XX` (2-letter ISO)	Index of cities in a country when no specific city is named.
Weather
`/q/weather/city-slug`	Current weather and forecast for a city.
News
`/q/news/keyword-slug`	News about a specific topic. Spaces → hyphens: "climate change" → `/q/news/climate-change`.
`/q/news/category-name`	Category headlines: `top` `world` `business` `technology` `science` `sports` `health` `entertainment` `politics` `environment`
`/q/news/XX` (2-letter code)	Headlines from a specific country. XX = 2-letter ISO code.
`/q/news`	Top global headlines. Use only when no topic, category, or country is specified.
Events
`/q/events/city-slug/PERIOD`	Upcoming events. PERIOD is required: `week` (7 days), `month` (30 days), `year` (365 days).
`/q/events/city-slug/PERIOD/CAT`	Filtered by category. CAT: `music` `sports` `arts-theatre` `film` `miscellaneous`. E.g. `/q/events/london/month/music`.
Forex
`/q/forex/WINDOW`	Historical rates. WINDOW: `week` `month` `quarter`. Use most specific window implied by user's question.
`/q/forex`	Today's live rates. Use when user asks for current rates with no historical intent.
Earthquakes & Traffic
`/q/earthquakes`	Recent global seismic activity, M2.5+.
`/q/traffic/city-slug`	Live traffic congestion for a city.
city-slug is always lowercase, hyphens for spaces: `new-york`, `hong-kong`, `los-angeles`. Full city list: sitemap.xml. All URLs are on https://havdu.com — e.g. `https://havdu.com/q/weather/tokyo`.