台湾の日常生活を問い合わせる AI エージェントスキル集(宝島 = 台湾の愛称)。 公式 API と公開データのみを使用:財政部電子発票統合サービスプラットフォーム、台北市データ大プラットフォーム、新北市データ開放プラットフォーム、台中市政府データ開放プラットフォーム、桃園市政府データ開放プラットフォーム、YouBike シェアサイクル公開データと公式地図リアルタイムフィード、Open-Meteo、中央気象署開放データプラットフォーム、国家災害防救科技中心(NCDR CAP)。ログイン不要、APIキー不要で安全に使えるクエリ型スキルが中心。一部のスキル(cwa-weather)は無料で即時発行される API キーを使用します。
Claude Code、Codex、OpenCode など、npx skills add をサポートするコーディングエージェントで利用できます。
インストール
# 全スキルをインストール
npx --yes skills add tahodev/baodao-skill --all -g
# 特定のスキルのみインストール
npx --yes skills add tahodev/baodao-skill --skill invoice-winning-numbers -g
Node.js 18 以上と npx が必要です。詳細はインストールガイドを参照。
機能
「ログイン」列は、ユーザー自身にアカウントやキーが必要かどうかを示します。
| 機能 | スキル名 | 説明 | ログイン | ドキュメント |
|---|---|---|---|---|
| 統一発票当選番号照会 | invoice-winning-numbers | 最新の当選番号、一括照会、クラウド発票専用賞(PDF リスト)、過去の期別案内 | 不要 | invoice-winning-numbers ガイド |
| YouBike ステーションリアルタイム照会 | youbike-realtime | 全国14サービスエリア(台北、新北、桃園、台中、台南、高雄など)のYouBike 2.0ステーションにおける貸出可能自転車数と返却可能スペース数のリアルタイム情報、電動アシスト自転車のフィルタリング対応 | 不要 | youbike-realtime ガイド |
| 台北・新北ごみ収集ルート | taiwan-garbage | 台北市(CSV)+新北市(JSON API)のごみ収集ポイントと停車時間。新北市は曜日スケジュール付きで、今日収集があるか判断可能 | 不要 | taiwan-garbage ガイド |
| 中央気象署天気予報 | cwa-weather | CWA 開放データAPIを使って各県市の36時間予報と郷鎮予報を照会(公式データ) | あり(無料即時発行) | cwa-weather ガイド |
| 台湾の天気照会 | taiwan-weather | Open-Meteo(キー不要)で天気を照会し、NCDR CAPフィード(キー不要)で台風・地震・津波などの災害警報を取得(cwa-weather のキーレス代替) | 不要 | taiwan-weather ガイド |
各スキルの正本は <スキル名>/SKILL.md です。docs/features/ のガイドは要約版です。詳細な手順、パラメータ、エラー処理は必ず SKILL.md を参照してください。
適用範囲について:
- スクレイピング対策が厳しいサービス(蝦皮、momo、591、foodpanda など)は対象外。
- 外部状態を変更しない:予約、購入、投稿は行わず、照会と計算のみ。
- データは各公式ソースが公開する原文のまま。重要な判断(受取期限、収集休止日、台風警報など)は必ず公式サイトで確認してください。
30日計画
このリポジトリは「1日1スキル」のペースで成長中です。以下は候補スキルです(順不同、完了したものはチェック済み):
- 国民の祝日と連休照会(行政院人事行政総処の勤務カレンダー)
- 中央気象署天気予報(無料APIキー)→
cwa-weather - クラウド発票専用賞当選番号 →
invoice-winning-numbers(PDFリスト解析、2026-09-09) - 他県市のごみ収集(新北→
taiwan-garbageで対応済み。桃園、台中、台南、高雄は未対応) - 高速鉄道時刻表と運賃(TDX、無料APIキー)
- 在来線時刻表(TDX、無料APIキー)
- バス動態照会(TDX)
- 空気品質指数 AQI
- 地震速報と台風動態 →
taiwan-weatherのNCDR CAP部分(2026-09-09) - 駐車場の空き状況
- 郵便番号照会
- 台電の電力需給情報
- ガソリン価格照会(台湾中油)
- 為替レート照会
- 休校・休業発表
- 農産品取引相場
- 総合所得税試算
- 統一編号と身分証番号の検証
- 病院・診療所照会
- 公共図書館蔵書照会
- 高速道路リアルタイム交通状況
- 紫外線指数
- 断水予告
- 二十四節気と旧暦換算
- 労健保料率計算
- 郵便料金計算
English
baodao-skill (寶島, "baodao" = treasure island, an affectionate name for Taiwan) is a collection of AI-agent skills for daily life in Taiwan. It focuses on read-only lookups built only on official APIs and public datasets: no login walls, no API keys, no scraping.
Works with any coding agent that supports npx skills add (Claude Code, Codex, OpenCode, ...).
Install
# Install every skill
npx --yes skills add tahodev/baodao-skill --all -g
# Install a single skill
npx --yes skills add tahodev/baodao-skill --skill invoice-winning-numbers -g
Node.js 18+ and npx are required. See the install guide for details.
What you can do
| What you can do | Skill | Description | Login | Docs |
|---|---|---|---|---|
| Check Taiwan uniform-invoice winning numbers | invoice-winning-numbers | Latest winning numbers, batch matching, cloud-invoice exclusive prizes (PDF lists), and history pointers from the Ministry of Finance's public pages | Not required | invoice-winning-numbers guide |
| Look up YouBike station availability | youbike-realtime | Real-time rentable bikes and return docks for YouBike 2.0 stations across 14 service areas nationwide (Taipei, New Taipei, Taoyuan, Taichung, Tainan, Kaohsiung, and more), incl. e-bike filtering | Not required | youbike-realtime guide |
| Look up garbage truck routes | taiwan-garbage | Collection stops and times for Taipei (CSV) and New Taipei (JSON API with weekday schedules) | Not required | taiwan-garbage guide |
| Look up official CWA forecasts | cwa-weather | 36-hour county and township forecasts from the CWA open-data API (official source) | Free instant API key | cwa-weather guide |
| Look up weather in Taiwan | taiwan-weather | Keyless Open-Meteo weather plus keyless disaster alerts (typhoon, earthquake, tsunami) via the NCDR CAP feeds (fallback for cwa-weather) | Not required | taiwan-weather guide |
The canonical source for each skill is its <skill>/SKILL.md. The guides under docs/features/ are summaries only - always refer to SKILL.md for full procedures, parameters, and error handling.
Scope notes:
- Services with heavy anti-scraping are out of scope.
- Nothing here changes state: no reservations, purchases, or posts. Lookups and calculations only.
- Data is quoted as-is from official sources. Confirm anything important (claim deadlines, collection holidays, typhoon warnings) on the official site.
This repo grows one skill per day - see the roadmap above.
