대만 일상 생활 조회를 위한 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를 참조하세요.
범위 설명:
- 크롤링 방지가 엄격한 서비스(Shopee, momo, 591, foodpanda 등)는 범위에 포함되지 않습니다.
- 외부 상태를 변경하지 않습니다: 예약, 구매, 게시물 작성 없이 조회와 계산만 수행합니다.
- 데이터는 각 공식 출처에서 공지된 원본 내용입니다. 중요한 판단(수령 기한, 수거 중단일, 태풍 경보 등)은 반드시 공식 웹사이트에서 확인하세요.
30일 계획
이 저장소는 '하루에 하나 스킬' 속도로 성장 중입니다. 다음은 후보 스킬 목록이며, 순서는 미정입니다. 완료되면 체크 표시됩니다:
- 공휴일 및 연휴 조회 (행정원 인사총국 근무일 달력)
- 중앙기상서 날씨 예보 (무료 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" = 보물섬, 대만의 애칭) 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.