台灣即時停車查詢

傳送定位點或 Google Maps 網址，查詢附近台灣停車場即時空位，附 Apple Maps / Google Maps 一鍵導航連結。支援 Telegram、LINE、iMessage。

Security Scan

The skill's code, instructions, and requested secrets match its stated purpose (querying TDX parking data) and nothing requested looks disproportionate, though it does include an optional auto-update script that fetches code from GitHub which you should trust before enabling automated updates.

Purpose & Capability

The skill queries TDX (Transport Data eXchange) for static car-park data and availability and therefore legitimately asks for TDX_CLIENT_ID and TDX_CLIENT_SECRET. The behavior (parsing Google Maps URLs, calling TDX APIs, returning map links) matches the name/description.

Instruction Scope

SKILL.md restricts runtime actions to: set TDX credentials, install requests, copy the skill into the OpenClaw skills directory, and run the included Python script. The Python code only reads the provided coordinates or resolves a Google Maps URL, calls TDX endpoints, caches a token under ~/.openclaw/, and prints results. It does not attempt to read unrelated system files or exfiltrate other environment variables.

Install Mechanism

There is no formal install spec (instruction-only), which minimizes automatic disk actions. The repo includes update.sh that downloads parking_query.py and skill.yml from a GitHub URL (https://github.com/Harperbot/openclaw-parking-query/raw/main/...). Pulling code from GitHub raw is common but still an external fetch — if you enable automated updates or run update.sh, you should trust that remote repository. requirements.txt only lists requests (standard).

Credentials

The only required secrets are TDX_CLIENT_ID and TDX_CLIENT_SECRET, which are necessary for the TDX API. No other credentials, system config paths, or unrelated environment variables are requested. The token cache is stored under ~/.openclaw/.tdx_token_cache (within OpenClaw path) — expected for caching.

Persistence & Privilege

The skill is not always-enabled and does not request elevated privileges. It writes a token cache under ~/.openclaw/ (its own area) and contains an update helper that can overwrite its own files if run — that is normal for self-updating skills but worth noting before enabling automated cron updates.

Assessment

This skill is internally consistent: it needs only TDX credentials to call the official TDX APIs and the code matches the documentation. Before installing, do these quick checks: (1) Only supply TDX_CLIENT_ID and TDX_CLIENT_SECRET (do not reuse other secrets). (2) Inspect and trust the GitHub repo referenced by update.sh (https://github.com/Harperbot/openclaw-parking-query) before running update.sh or enabling any automated update cron jobs — the script will download and overwrite the skill files. (3) Note that resolving Google short URLs performs an HTTP HEAD with redirects (normal for expanding short map links), so if you pass unfamiliar external URLs be aware the skill will follow redirects to whatever upstream target is returned. If you are comfortable trusting the GitHub source and the TDX service, the skill appears safe to use.

parking_query

透過 Telegram 或 iMessage 傳送定位點或 Google Maps 網址，即可查詢附近台灣停車場的即時空位，並附上一鍵導航連結。

功能

• 即時查詢：顯示附近有空位的停車場 + 即時格位數 + Apple Maps / Google Maps 導航連結
• 未來查詢（訊息含「明天」、「下午」等時間詞）：顯示附近停車場位置 + 導航連結
• 搜尋半徑：500 公尺，無結果自動擴展至 1 公里
• 最多回傳 5 筆，依距離排序
• 覆蓋範圍：全台主要縣市（TDX 有提供資料者）

使用情境

用戶傳送：[定位點]
回覆：
🅿️ 附近 500 公尺 有空位的停車場（Taipei）

1. 信義廣場地下停車場
   空位：41 個　距離：103 公尺
   信義路5段11號地下
   🍎 Apple Maps → https://maps.apple.com/?daddr=...
   🗺 Google Maps → https://www.google.com/maps/dir/...

適用頻道：Telegram、LINE、iMessage（BlueBubbles）、及其他 OpenClaw 支援的頻道

支援輸入格式：

• Telegram / LINE 定位點（直接取座標）
• Google Maps 短網址：maps.app.goo.gl/xxx
• Google Maps 完整網址：google.com/maps/@lat,lon,...

前置需求

1. 申請 TDX 帳號（免費）

前往 https://tdx.transportdata.tw 註冊，取得：

• Client ID
• Client Secret

免費方案每月有 API 呼叫次數限制，一般個人使用綽綽有餘。

2. 設定環境變數

在 OpenClaw 的 openclaw.json 中加入：

{
  "env": {
    "vars": {
      "TDX_CLIENT_ID": "your-client-id",
      "TDX_CLIENT_SECRET": "your-client-secret"
    }
  }
}

3. 安裝 Python 套件

pip3 install requests

安裝

# 複製到 OpenClaw skills 目錄
cp -r parking_query ~/.openclaw/skills/

# 重啟 gateway 讓 skill 生效
openclaw restart

使用方式

Agent 會自動判斷模式並呼叫此 skill。也可直接執行：

# 即時查詢（現在要停車）
python3 ~/.openclaw/skills/parking_query/parking_query.py \
  --lat 25.033 --lon 121.565 --mode realtime

# 未來查詢（明天要去的地點）
python3 ~/.openclaw/skills/parking_query/parking_query.py \
  --lat 25.033 --lon 121.565 --mode future

# Google Maps 短網址
python3 ~/.openclaw/skills/parking_query/parking_query.py \
  --url "https://maps.app.goo.gl/xxx" --mode realtime

資料來源

用途	API	Tier
停車場位置（靜態）	TDX /api/advanced/v1/Parking/OffStreet/CarPark/NearBy	Advanced
即時空位（動態）	TDX /api/basic/v1/Parking/OffStreet/ParkingAvailability/City/{City}	Basic

快取策略：停車場靜態資料快取 24 小時（減少 API 呼叫），即時空位每次查詢都打 API。

覆蓋縣市

基隆、台北、新北、桃園、新竹市、新竹縣、苗栗、台中、彰化、南投、雲林、嘉義市、嘉義縣、台南、高雄、屏東、宜蘭、花蓮、台東

實際空位資料以 TDX 各縣市介接狀況為準，部分縣市可能無即時資料。