AgentSkillsCN

surfline

从Surfline公共端点获取冲浪预报和当前状况（无需登录）。用于查找Surfline地点ID，获取特定地点的预报/状况，并汇总多个喜爱地点。

SKILL.md
--- frontmatter
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:
bash
python3 scripts/surfline_search.py "Cardiff Reef"
python3 scripts/surfline_search.py "D Street"
  1. •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
  1. •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.