A Python-powered integration to retrieve surf forecasts and spot conditions from Surfline's public endpoints without requiring a login.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install surfline
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install surfline using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Surfline Public Forecast?
This skill provides a streamlined interface for accessing Surfline data through public endpoints. It allows users and agents to search for specific surf spot IDs, retrieve detailed forecast reports in text or JSON format, and maintain a list of favorite spots for quick summaries. As part of the Openclaw Skills ecosystem, it enables AI agents to provide real-time surf insights without requiring user authentication, cookies, or complex session management.
By leveraging the scripts provided, developers can integrate high-quality swell, wind, and tide data into their workflows. The skill is designed to be gentle on endpoints with built-in caching and utilizes stable spot IDs for consistent reporting across different sessions.
Surfline Public Forecast Use Cases
- Checking real-time surf conditions and swell heights before heading to the beach.
- Automating daily surf reports for a curated list of favorite local breaks.
- Searching for Surfline spot IDs to integrate into weather dashboards or outdoor planning apps.
- Retrieving structured JSON surf data for programmatic analysis or multi-agent notifications.
How Surfline Public Forecast Works
- The user identifies a specific surf spot by searching for its name to retrieve the unique Surfline spot ID.
- The skill queries Surfline's public API endpoints using the identified spot ID to fetch current conditions.
- Forecast data is parsed and presented in either human-readable text for quick review or JSON for technical processing.
- For bulk updates, the skill reads from a local favorites configuration file to generate a summary for multiple spots simultaneously.
Surfline Public Forecast Setup
Find a spot ID
Use the search script to find the ID for your local break:
python3 scripts/surfline_search.py "Cardiff Reef"
Get a report
Fetch the latest conditions for a specific spot ID:
python3 scripts/surfline_report.py <spotId> --text
Configure favorites
To track multiple spots, create a configuration file at ~/.config/surfline/favorites.json based on the provided example, then run:
python3 scripts/surfline_favorites.py
Surfline Public Forecast Data Schema & Taxonomy
| Element | Type | Description |
|---|---|---|
| favorites.json | Config | A JSON file located in ~/.config/surfline/ storing favorite spot IDs and names. |
| spotId | String | The unique identifier used by Surfline public endpoints to index surf locations. |
| Output Formats | Flag | Supports --text for CLI readability and --json for data serialization. |
Surfline Public Forecast Advanced Features
- Local caching mechanism to reduce redundant network requests and respect API limits.
- Headless operation requiring no Surfline account, login credentials, or cookies.
- Multi-spot batch processing via the favorites configuration system.
- Flexible output toggles for seamless integration with other Openclaw Skills and automated pipelines.
SKILL.md
Loading
Related Openclaw Skills
Task Status
A communication framework for AI agents to provide manual and automated periodic status updates during long-running operations.
ZFS Administration
A comprehensive toolset for managing OpenZFS storage, from pool creation and dataset optimization to snapshots and troubleshooting.
Haskell Development
An expert-level skill for building, debugging, and optimizing production-grade Haskell applications with a focus on type safety and purity.
StepFun OpenRouter Integration
An integration skill that brings StepFun high-speed reasoning and multimodal AI models to your local environment via the OpenRouter API.
1Password CLI
A professional tool for integrating the 1Password CLI into automated workflows for secure secret retrieval and environment injection.
AI Coach
A personalized AI-driven coaching assistant that helps users define goals, track progress, and maintain motivation through structured check-ins.
Featured*
