# ClimatePulse

> Hyperlocal weather intelligence API for outdoor planning and travel. Current conditions, 7-day forecasts, activity-specific go/no-go assessments, severe weather alerts, and location comparisons — all with outdoor gear recommendations via Amazon and REI affiliates. Powered by Open-Meteo (free, no key). Pay-per-query via x402 micropayments on Base mainnet.

## Endpoints

GET /api/climate/now?location={city}
- Returns: current conditions (temp, feels-like, UV, wind, humidity, cloud cover, precipitation), today's high/low, outdoor score (1–10), what to wear, hourly highlights, Amazon and REI gear links
- Optional: units (imperial|metric, default imperial), lang
- Price: $0.05

GET /api/climate/forecast?location={city}&days={1-7}
- Returns: day-by-day breakdown (description, high/low, precipitation chance, wind, UV, outdoor score, planning note), week summary, best and worst outdoor day, packing essentials, gear links
- Optional: days (1–7, default 7), units, lang
- Price: $0.08

GET /api/climate/activity?location={city}&activity={type}
- Returns: go/no-go rating (go|marginal|no_go), go score (1–10), conditions summary, activity-specific notes, safety notes, best time of day, gear checklist with Amazon + REI links, alternative dates
- activity values: hiking, skiing, surfing, cycling, camping, running, golf, beach, fishing
- Optional: units, lang
- Price: $0.10

GET /api/climate/severe?location={city}
- Returns: threat level (none|low|elevated|high|extreme), primary threat, active alerts, timeline (24h + 3-day), safety actions, preparedness checklist with Amazon links, shelter guidance, evacuation guidance, emergency contacts
- Optional: units, lang
- Price: $0.08

GET /api/climate/compare?locations={loc1,loc2,...}
- Returns: rankings (warmest, sunniest, driest, best outdoor today), per-location breakdown with outdoor score, pros/cons, week outlook, overall recommendation, best for vacation/relocation/outdoor sports
- locations: comma-separated, 2–4 locations
- Optional: purpose (vacation|relocation|sports), units, lang
- Price: $0.10

## Payment

All endpoints use x402 protocol. No payment header → HTTP 402 with PAYMENT-REQUIRED header (0.05–0.10 USDC on Base mainnet). Send valid PAYMENT-SIGNATURE → 200 with structured JSON.

## Data Sources

- Open-Meteo (api.open-meteo.com) — free official weather data, sub-kilometer resolution, global coverage, no API key required
- Tavily — real-time severe weather alerts, activity conditions, climate context
- Claude Sonnet — synthesis, planning insights, gear recommendations

## Affiliate Disclosure

Responses include Amazon affiliate links (tag: pulsenetwork7-20) and REI affiliate links for recommended outdoor gear.

## Disclaimer

For informational purposes only. Always monitor weather.gov and local emergency management for official severe weather warnings.