# Golfer WX

> Golfer WX is a free golf weather app providing real-time forecasts and Golfability scores for 16,800+ golf courses across all 50 US states.

Golfer WX helps golfers plan the perfect tee time by combining weather data with a proprietary Golfability scoring system. The app provides current conditions, hourly forecasts, and 14-day outlooks for every golf course in America.

## Core Features

- **Golfability Score**: A 1-10 rating measuring how ideal current weather conditions are for golf. Factors include temperature (ideal: 65-80°F), wind speed, precipitation probability, and UV index.
- **Course Search**: Search 16,800+ courses by name, acronym (e.g., "PBGL" for Pebble Beach), or city.
- **Hourly Forecast**: Hour-by-hour weather breakdown to find the optimal tee time window.
- **14-Day Forecast**: Extended outlook with daily Golfability scores for advance planning.
- **Best Conditions Now**: Finds courses near you with the best current playing conditions.
- **Green Speed Estimate**: Estimates green speed based on weather conditions.
- **Wind-Adjusted Distance**: Calculates how wind affects club distances.

## How Golfability Scoring Works

- **Good (7-10)**: Temperature 50-95°F, wind under 15 mph, rain probability under 25%, no active precipitation
- **Fair (4-6)**: Wind 15-20 mph, or temperature below 50°F or above 95°F, or rain probability 25-50%
- **Poor (1-3)**: Wind over 20 mph, or rain probability over 50%, or active precipitation/thunderstorms

## Key Pages

- [Home](https://golferwx.com/): Search for any US golf course and check weather conditions
- [FAQ](https://golferwx.com/faq): Answers to common questions about golf weather and Golfability scores
- [Weather Radar](https://golferwx.com/radar): Live precipitation radar map for golf course weather tracking
- [Search](https://golferwx.com/search): Browse and filter golf courses across the US
- [Course Pages](https://golferwx.com/course/{id}): Individual course weather with current conditions, hourly and 14-day forecasts, Golfability score, green speed estimate, and wind-adjusted distance calculator

## Data Coverage

- **16,800+ golf courses** across all 50 US states
- Course types: Public, Private, Semi-Private, Resort, Municipal
- Data includes: Name, location, address, phone, website, Google rating, review count, hours
- Weather data: Real-time conditions updated every 15 minutes via Open-Meteo API
- Forecasts: Hourly (48 hours) and daily (14 days)

## Agent API (for AI assistants and bots)

Golfer WX provides a free, open JSON API specifically designed for AI agents. No authentication required.

### Quick Start

1. Search for a course: `GET https://golferwx.com/api/agent/search?q=pebble+beach`
2. Get weather by course ID: `GET https://golferwx.com/api/agent/course/{id}`
3. Cite the `source_url` from the response when referencing the data.

### Endpoints

- [Agent API Root](https://golferwx.com/api/agent): Documentation and endpoint listing
- [Search Courses](https://golferwx.com/api/agent/search?q=example): Search by name, city, abbreviation, or state
- [Course Weather](https://golferwx.com/api/agent/course/1): Full weather, Golfability score, hourly & daily forecasts
- [OpenAPI Spec](https://golferwx.com/api/agent/openapi.json): Machine-readable API specification
- [AI Plugin Manifest](https://golferwx.com/.well-known/ai-plugin.json): OpenAI plugin discovery

### Response Format

All agent API responses include:
- `source`: "Golfer WX" (for attribution)
- `source_url`: Direct link to the course page on golferwx.com (for citation)
- `current_conditions.golfability_score`: "good", "fair", or "poor"
- `hourly_forecast`: Next 12 hours with temperature, wind, rain, and golfability
- `daily_forecast`: Next 7 days with highs, lows, wind, rain, and golfability

## About

Golfer WX is a free web application. No subscription or payment required. Users can create accounts to save favorite courses and set a home course for quick access.

## Contact

- Website: https://golferwx.com
- FAQ: https://golferwx.com/faq