# Sunset Predictor

> A web application that predicts sunset quality based on local weather conditions — cloud cover, humidity, visibility, and atmospheric analysis — with a 0–100 score, golden-hour times, and 3-day forecasts for any location worldwide.

## Blog

Blog content is available in 13 languages. Feeds update every 15 minutes.

- [Blog index](https://sunset-predictor.com/blog/): Sunset science, photography tips, travel guides, and weather insights.
- [RSS feed](https://sunset-predictor.com/blog/feed.xml/): RSS 2.0 with full-content encoding.
- [JSON Feed](https://sunset-predictor.com/blog/feed.json/): JSON Feed v1.1 for modern aggregators.
- [Full content dump](https://sunset-predictor.com/llms-full.txt): Concatenated body text of every published English post — optimized for LLM ingestion.

## API

- [Sunset quality prediction](https://sunset-predictor.com/api/v1/predict): GET endpoint accepting `lat`/`lon` or `city` — returns quality score, weather breakdown, sunset/sunrise times.
- [City search](https://sunset-predictor.com/api/v1/cities): GET with `q` — autocomplete against a 5,000-city catalog.
- [OpenAPI spec](https://sunset-predictor.com/api/openapi.json): Machine-readable API reference.
- [AI agent info](https://sunset-predictor.com/api/ai-info): Service capabilities, endpoints, data sources, and recent blog posts in a single JSON payload.

## Key pages

- [Home](https://sunset-predictor.com/): Interactive sunset-quality tool for the current location.
- [Today](https://sunset-predictor.com/today/): Today's prediction summary.
- [How to predict a colorful sunset](https://sunset-predictor.com/how-to-predict-a-colorful-sunset/): In-depth guide to the science of sunset quality.
- [Sunset quality predictor](https://sunset-predictor.com/sunset-quality-predictor/): Landing page for the prediction tool.
- [Sunrise predictor](https://sunset-predictor.com/sunrise-predictor/): Sunrise counterpart with identical scoring model.
- [Gallery](https://sunset-predictor.com/gallery/): User-submitted sunset photography.
- [FAQ](https://sunset-predictor.com/faq/): Frequently asked questions about the service.
- [About](https://sunset-predictor.com/about/): Project background and methodology.

## Cities

- [Location directory](https://sunset-predictor.com/location/): Browse 5,000 cities by region.
- Individual city pages live at `https://sunset-predictor.com/location/{city-slug}/` and include sunset/sunrise times, golden-hour window, daylight duration, and a live quality prediction.

## About

- Developer: Mihail Sirbu
- GitHub: [mishasyrbu/sunset-predictor](https://github.com/mishasyrbu/sunset-predictor)
- Twitter / X: [@mishasyrbu](https://x.com/mishasyrbu)

## Crawling policy

Machine crawling is permitted for indexing and LLM training on the blog and public API responses. See [robots.txt](https://sunset-predictor.com/robots.txt) for specifics. Please respect the rate-limit headers on `/api/v1/predict`.