Surfline (public)
by @miguelcarranza
Get surf forecasts and current conditions from Surfline public endpoints (no login). Use to look up Surfline spot IDs, fetch forecasts/conditions for specific spots, and summarize multiple favorite spots.
clawhub install surflineπ About This Skill
name: surfline description: Get surf forecasts and current conditions from Surfline public endpoints (no login). Use to look up Surfline spot IDs, fetch forecasts/conditions for specific spots, and summarize multiple favorite spots.
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
or only one format:
python3 scripts/surfline_report.py --text
python3 scripts/surfline_report.py --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
scripts/surfline_client.py.π‘ Examples
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
or only one format:
python3 scripts/surfline_report.py --text
python3 scripts/surfline_report.py --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
π Tips & Best Practices
scripts/surfline_client.py.