A comprehensive surfing intelligence tool providing real-time wave, tide, and meteorological data for all major surf spots across Taiwan.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install surf-query
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 surf-query 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 Taiwan Surf Point Query?
The Taiwan Surf Point Query is a specialized utility built for the Openclaw Skills ecosystem, designed to provide surfers with instant access to sea conditions. By integrating directly with Taiwan's Central Weather Administration (CWA) and curated surfing databases, it offers a one-stop solution for checking tides, wind quality, and seasonal suitability. This skill is optimized for mobile-first environments, supporting seamless interaction through messaging platforms like Telegram, LINE, and iMessage.
Beyond simple data retrieval, the skill provides technical analysis, such as determining if current wind directions are offshore (favorable for clean waves) and tracking typhoon movements within a 2000km radius. It transforms the Openclaw Skills experience into a vital companion for outdoor enthusiasts and professional surfers navigating the diverse coastlines of Yilan, Taitung, Kenting, and beyond.
Taiwan Surf Point Query Use Cases
- Searching for surf spots by name or administrative region such as Donghe or Yilan.
- Sending your current location to find all known surf points within a 30km radius.
- Checking high and low tide cycles to plan the optimal time for a session.
- Verifying if current wind conditions are offshore for improved wave quality.
- Monitoring active typhoon tracks to predict incoming swells or ensure safety.
- Accessing instant navigation links for Google Maps and Apple Maps to reach remote surf locations.
How Taiwan Surf Point Query Works
- The user initiates a request by naming a surf spot or providing geographic coordinates.
- The skill queries a curated database of over 30 Taiwan-specific surf locations to identify the target area.
- It connects to the CWA API using a secure authorization key to fetch real-time tidal and meteorological data.
- The system calculates astronomical data including sunrise and sunset based on the spot's exact coordinates.
- An analysis engine evaluates wind direction against the coastline orientation to judge wave surface quality.
- The compiled data is formatted into a concise report and delivered back to the user via their chosen Openclaw Skills interface.
Taiwan Surf Point Query Setup
To integrate this into your environment, ensure you have the necessary API credentials and dependencies.
- Register for a free API account at opendata.cwa.gov.tw to obtain an authorization code.
- Configure your
openclaw.jsonfile with the following environment variable:
{
"env": {
"vars": {
"CWA_API_KEY": "CWA-YOUR_CODE_HERE"
}
}
}
- Install the required Python library:
pip3 install requests
- Clone the repository into your skills directory and restart the agent:
git clone https://github.com/Harperbot/openclaw-surf-query.git ~/.openclaw/skills/surf_query
openclaw restart
Taiwan Surf Point Query Data Schema & Taxonomy
The skill organizes surfing intelligence using a multi-source data model to ensure accuracy within Openclaw Skills:
| Data Type | Source | Purpose |
|---|---|---|
| Surf Spot DB | Swelleye / Outdoorfun | Coordinates, difficulty, and wave types |
| Real-time Tides | CWA F-A0021-001 | Daily high/low tide levels and timing |
| Wind & Weather | CWA F-D0047-091 | Wind speed, direction, and sky conditions |
| Typhoon Tracking | CWA W-C0034-005 | Location and intensity of active storms |
| Astronomy | Calculated | Localized sunrise and sunset timings |
Taiwan Surf Point Query Advanced Features
- Intelligent offshore wind detection that automatically marks favorable conditions for surfing.
- Seasonal suitability indicators that notify users if the current month is the optimal season for a specific region.
- Cross-platform support for iMessage (via BlueBubbles), Telegram, and LINE.
- Deep integration with the parking_query skill to automatically find nearby parking spots for any surf point.
- One-click navigation generation for both Apple and Google Maps.
SKILL.md
Loading
Related Openclaw Skills
Taiwan Real-time Parking Query
An AI-powered skill for querying real-time parking availability and navigation across Taiwan's major cities using TDX data.
B2B Sales Prospecting & Lead Discovery Agent
An automated B2B lead generation tool that identifies high-intent prospects and verified contact data using the Explorium AgentSource API.
Lead & Contact Data Enrichment Agent
A high-performance agent for enriching B2B leads and company profiles with verified contact data, firmographics, and technographics via the Explorium API.
Company Research & Business Intelligence Agent
A high-performance intelligence agent for automated company profiling, competitive analysis, and investment due diligence.
Brain CMS
A neuroscience-inspired multi-layer memory architecture that replaces flat files with semantic schemas, vector search, and automated consolidation cycles.
Career Manager
An automated job search pipeline that tracks applications, tailors resumes to job descriptions, and provides deep research for interview preparation.
Featured*
