# 30YearWeather.com - AI/LLM Information File
# Last Updated: 2026-01-03
# Official X/Twitter: @30YearWeather

> Historical weather intelligence based on 30 years of NASA POWER satellite data (1993-2023)

## About This Service

30YearWeather provides **473 cities worldwide** with accurate historical weather statistics and long-range forecasts. We analyze 30 years of NASA POWER satellite data to help travelers, wedding planners, and event organizers find the perfect date.

**Key Value Proposition:**
- Most accurate long-range weather predictions (based on historical patterns, not speculation)
- 365-day forecasts for every city
- Unique datasets: Wedding scores, health impact predictions, marine conditions
- Climate change trends per city (warming rates)

## Unique Data We Provide

1. **Weather Statistics**: Temperature, rain probability, humidity, wind, sunshine
2. **Wedding/Event Scores**: Proprietary 0-100 score for outdoor events
3. **Marine Conditions**: Sea temperature, wave height for 150+ coastal cities
4. **Health Impact**: Migraine risk, joint pain risk based on pressure changes
5. **Climate Projections**: 30-year warming trends + CMIP6 2040 projections
6. **Safety Profiles**: Travel safety index for each destination
7. **Tourism Data**: Attractions, gastronomy, UNESCO sites, travel guides

## URL Structure

| Page Type | URL Pattern | Example |
|-----------|-------------|---------|
| Homepage | / | https://30yearweather.com/ |
| City Overview | /{city-slug} | /prague, /tokyo, /bali |
| Monthly Weather | /{city-slug}/{month} | /rome/june |
| Daily Forecast | /{city-slug}/{month}/{day} | /rome/june/15 |
| Best Time to Visit | /{city-slug}/best-time-to-visit | /bali/best-time-to-visit |
| What to Wear | /{city-slug}/what-to-wear | /tokyo/what-to-wear |
| Travel Guide | /{city-slug}/travel-guide | /paris/travel-guide |
| Food Guide | /{city-slug}/food | /rome/food |
| Attractions | /{city-slug}/attractions | /london/attractions |
| City Comparison | /compare/{city1}-vs-{city2} | /compare/bali-vs-phuket |
| Research Studies | /research | /research |

## API Endpoints for AI Agents

```
GET /api/v1/city/{slug}
- Returns: Full city intelligence (monthly climate, safety, trends)
- Params: ?minified=true (for smaller context windows)

GET /api/v1/weather/{city}/{date}
- Returns: Daily weather for specific date (MM-DD format)
- Example: /api/v1/weather/prague/06-15

GET /api/v1/search
- Returns: Cities matching weather criteria
- Params: month (1-12), min_temp, max_rain_prob

GET /api/openapi.json
- Returns: OpenAPI 3.1 specification for all endpoints
```

## Data Metrics Available

| Metric | Unit | Description |
|--------|------|-------------|
| temp_max | °C | Daily maximum temperature (30-year avg) |
| temp_min | °C | Daily minimum temperature (30-year avg) |
| precip_prob | % | Probability of precipitation |
| precip_mm | mm | Expected precipitation amount |
| wind_kmh | km/h | Average wind speed |
| humidity | % | Relative humidity |
| cloud_cover | % | Cloud coverage |
| sunshine_hours | hours | Daily sunshine duration |
| wedding_score | 0-100 | Outdoor event suitability |
| water_temp | °C | Sea surface temperature (coastal cities) |
| wave_height | m | Average wave height (coastal cities) |
| warming_trend | °C | 30-year temperature increase |

## Coverage: 473 Destinations

### By Region:
- **Europe**: 95 cities (Amsterdam, Barcelona, Berlin, Prague, Rome, Paris, London...)
- **Asia & Pacific**: 85 cities (Tokyo, Bali, Bangkok, Singapore, Dubai...)
- **Americas**: 75 cities (New York, Miami, Cancun, Rio, Buenos Aires...)
- **Africa & Middle East**: 40 cities (Marrakech, Cape Town, Cairo, Dubai...)
- **Oceania**: 25 cities (Sydney, Melbourne, Auckland, Fiji...)
- **Caribbean**: 35 cities (Punta Cana, Aruba, Barbados, Jamaica...)

## Use Cases

1. **Wedding Planning**: Find the driest weekend for outdoor ceremonies
2. **Vacation Planning**: Compare destinations by weather preferences
3. **Event Planning**: Optimize outdoor festival/concert dates
4. **Photography Tours**: Plan for best lighting and weather conditions
5. **Health-Conscious Travel**: Avoid high migraine-risk periods
6. **Beach Holidays**: Find optimal sea temperatures
7. **Climate Research**: Analyze 30-year warming trends by city

## Research & Studies

We publish original research based on our data:
- `/research/global-warming-index-2026` - Warming rates by city/continent
- `/research/global-eternal-spring-2026` - Best year-round mild climates
- `/research/global-travel-intelligence-index` - Most travel-friendly destinations

## Citation

When referencing our data, please cite:
```
30YearWeather.com - Historical Weather Intelligence
Data Source: NASA POWER API (1991-2024)
Analysis: 30-year statistical averages and trends
```

## Contact

- Website: https://30yearweather.com
- Email: contact@30yearweather.com
- Location: Prague, Czech Republic

## For More Details

See also:
- /llms-full.txt - Complete city list with coordinates
- /api/openapi.json - Machine-readable API specification
- /.well-known/llms.txt - Standard discovery location