Surfline (public, no login)

This skill uses Surfline public endpoints (no account, no cookies).

Quick start

1) Find a spot id:

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):

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).

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.