← Back to Skills Marketplace
harperbot

Surf Query

by Harperbot · GitHub ↗ · v1.2.0
cross-platform ⚠ suspicious
342
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install surf-query
Description
查詢台灣全島衝浪浪點資訊,含即時潮汐、風況、颱風動態、日出日落,可附帶查詢附近停車場。支援 Telegram、LINE、iMessage。
Usage Guidance
This skill appears to implement the surf/tide/wind features it advertises, but take these precautions before installing: - Provide a CWA_API_KEY only if you need live tides/wind/typhoon data; the SKILL.md explains how to add it. Note the registry metadata omitted this requirement — that mismatch is just a documentation issue, not a showstopper, but be aware. - Inspect the code before enabling automatic updates: update.sh will curl raw files from a GitHub repo and overwrite the local skill. If you rely on this, consider locking updates to a specific commit or reviewing fetched files before replacing local code. - The code contains calls that disable TLS verification for CWA endpoints (verify=False + disable_warnings). This reduces security and could enable MITM attacks. If possible, ask the maintainer for a fix, or only run live queries on a trusted network. - If you plan to enable cron-based push notifications, confirm where messages will be sent and which channel bindings are configured in OpenClaw (Telegram/LINE/iMessage). These are expected features but can send notifications to external accounts. If you are comfortable reviewing the script yourself and either removing or accepting the verify=False workaround and the auto-update behavior, the skill is coherent with its purpose. If you cannot review code, consider running it in a constrained environment or asking the maintainer for a signed release or pinned update mechanism.
Capability Analysis
Type: OpenClaw Skill Name: surf-query Version: 1.2.0 The skill is classified as suspicious primarily due to two significant security vulnerabilities. First, the `update.sh` script performs an auto-update by directly downloading and overwriting `surf_query.py`, `skill.yml`, and `taiwan_surf_spots.json` from a GitHub repository (`https://github.com/Harperbot/openclaw-surf-query/raw/main/`). This introduces a supply chain risk, as a compromise of the GitHub repository could lead to the automatic execution of malicious code on the user's system (seen in `update.sh`, `SKILL.md`, `README.md`). Second, the `surf_query.py` script and example code in `README.md` disable SSL/TLS certificate verification (`verify=False`) when making requests to the CWA API, making these communications vulnerable to Man-in-the-Middle attacks. While the skill's stated purpose is benign and there's no direct evidence of intentional malice (e.g., data exfiltration to unauthorized endpoints, explicit prompt injection against the agent), these vulnerabilities present significant security risks.
Capability Assessment
Purpose & Capability
The skill's stated purpose (Taiwan surf spots, tides, wind, typhoon, sunrise, optional parking) matches the code and bundled JSON data. However the registry metadata lists no required env vars while SKILL.md and the code clearly expect an optional CWA_API_KEY for live data; this metadata omission is an inconsistency you should be aware of.
Instruction Scope
SKILL.md and README instruct using the CWA API and show example code that disables SSL verification (requests.get(..., verify=False) plus urllib3.disable_warnings) to work around a CWA cert issue. Disabling TLS verification weakens security (MITM risk). The docs also recommend cron-based push notifications via OpenClaw bindings — expected for push features but note the sample code will access environment variables and external APIs.
Install Mechanism
No formal install spec (instruction-only), which is low-risk, but the included update.sh will curl raw files from a GitHub repo and overwrite local skill files. Auto-updating by fetching raw scripts is convenient but increases supply-chain risk if the remote repo or account is compromised.
Credentials
Only one service credential is relevant: CWA_API_KEY for Central Weather Administration opendata. The code and docs expect it; nothing else is requested. The registry metadata failing to declare this env var is a proportionality/documentation mismatch that could confuse users.
Persistence & Privilege
The skill is not always-included and does not request elevated or cross-skill privileges. update.sh writes its own skill files (normal). Cron/push usage is optional and user-configured via OpenClaw; autonomous invocation is allowed but not unusual for skills.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install surf-query
  3. After installation, invoke the skill by name or use /surf-query
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.0
- 新增支援多平台查詢,包括 Telegram、LINE、iMessage。 - 強化浪點搜尋,可依名稱或地區查詢,並支援傳送定位點以搜尋 30km 內浪點。 - 附加即時潮汐、風況、颱風動態、日出日落等詳細資訊。 - 新增一鍵導航功能(Apple Maps、Google Maps 連結)。 - 選擇性串接附近停車場查詢(需搭配 parking_query skill)。 - 詳細列出 API 需求、安裝步驟與支援資料來源。
Metadata
Slug surf-query
Version 1.2.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Surf Query?

查詢台灣全島衝浪浪點資訊,含即時潮汐、風況、颱風動態、日出日落,可附帶查詢附近停車場。支援 Telegram、LINE、iMessage。 It is an AI Agent Skill for Claude Code / OpenClaw, with 342 downloads so far.

How do I install Surf Query?

Run "/install surf-query" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Surf Query free?

Yes, Surf Query is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Surf Query support?

Surf Query is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Surf Query?

It is built and maintained by Harperbot (@harperbot); the current version is v1.2.0.

💬 Comments