# Surfline

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

- Skill: `kbarbel640-del/surfline` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add kbarbel640-del/surfline`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/surfline/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/kbarbel640-del/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`.