surfline

# Surfline (public, no login) This skill uses Surfline **public endpoints** (no account, no cookies). ## Quick start 1) Find a spot id: ```bash python3 scripts/surfline_search.py "Cardiff Reef" python3 scripts/surfline_search.py "D Street" ``` 2) Get a report for a spot id (prints text + JSON by default): ```bash python3 scripts/surfline_report.py <spotId> # or only one format: python3 scripts/surfline_report.py <spotId> --text python3 scripts/surfline_report.py <spotId> --json ``` 3) Favorites summary (multiple spots) (prints text + JSON by default): Create `~/.config/surfline/favorites.json` (see `references/favorites.json.example`). ```bash python3 scripts/surfline_favorites.py ``` ## Notes - Keep requests gentle: don’t hammer endpoints. Scripts include basic caching. - Spot IDs are stable; store them once. - If Surfline changes endpoints/fields, update `scripts/surfline_client.py`.