台灣衝浪浪點查詢
查詢台灣全島衝浪浪點資訊，含即時潮汐、風況、颱風動態、日出日落，可附帶查詢附近停車場。支援 Telegram、LINE、iMessage。
Why use this skill?
Get real-time surf conditions in Taiwan with the OpenClaw surf skill. Track tides, wind, typhoons, and find surf spots with navigation.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/harperbot/surf-queryWhat This Skill Does
The 台灣衝浪浪點查詢 (Taiwan Surf Spot Query) skill is a specialized OpenClaw agent designed for surfers in Taiwan to get real-time environmental data. By integrating with the Central Weather Administration (CWA) of Taiwan, it provides high-precision data including tide times, wind speed, wind direction (with offshore wind detection), and active typhoon tracking for any region within 2000km. It also provides automated sunrise/sunset calculations and seasonal advice for specific surf spots like Donghe or Honeymoon Bay. The skill is designed for convenience, offering direct navigation links via Apple Maps and Google Maps, and can be extended with parking search capabilities.
Installation
To install this skill, ensure you have the OpenClaw environment ready. First, clone the repository into your local skills directory:
git clone https://github.com/Harperbot/openclaw-surf-query.git ~/.openclaw/skills/surf_query
After installation, run openclaw restart to reload your agent. For the best experience, including real-time weather and tide data, you should register for a free account at opendata.cwa.gov.tw to obtain your API key. Once obtained, add the key to your openclaw.json configuration file under the env.vars section as CWA_API_KEY. Finally, ensure your Python environment is prepared by running pip3 install requests.
Use Cases
This skill is perfect for surf enthusiasts planning their weekend trips or daily sessions. Users can search for specific spots by name, or get recommendations based on their current GPS location (within 30km). It helps users decide whether to drive to the beach by analyzing wind conditions and determining if the wave quality will be suitable (e.g., offshore winds). It is particularly useful for tracking typhoon developments that might affect safety and surf conditions along the coast.
Example Prompts
- "東河附近有什麼浪點？幫我查一下現在的浪況。"
- "今天宜蘭蜜月灣的潮汐時間跟風向如何？適合去衝浪嗎？"
- "發送我的定位點，查詢半徑30公里內所有可以衝浪的浪點。"
Tips & Limitations
- API Dependency: Without the CWA API key, you will still see basic spot information and navigation links, but real-time tide and wind data will be unavailable.
- Data Coverage: The database currently covers approximately 30 known surf spots across Northern, Northeastern, Eastern, Southern, and Western Taiwan.
- Weather Sensitivity: Always check for official typhoon warnings from the CWA; do not rely solely on the AI agent for safety-critical decisions during extreme weather events.
- Extensibility: For an even better experience, pair this with the
parking_queryskill to find parking spaces near your destination.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-harperbot-surf-query": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, external-api