Conjunto de habilidades para agentes de IA voltadas a consultas do dia a dia em Taiwan (Baodao = "ilha do tesouro", apelido carinhoso para Taiwan). Utiliza apenas APIs oficiais e dados públicos: plataforma integrada de notas fiscais eletrônicas do Ministério da Fazenda, Plataforma de Dados Abertos de Taipei, Plataforma de Dados Abertos de New Taipei, Plataforma de Dados Abertos de Taichung, Plataforma de Dados Abertos de Taoyuan, dados públicos do YouBike e feed oficial de mapas em tempo real, Open-Meteo, Plataforma de Dados Abertos da Agência Central de Meteorologia (CWA) e Centro Nacional de Ciência e Tecnologia para Prevenção de Desastres (NCDR CAP). O foco são habilidades de consulta seguras, que não exigem login nem chave de API; apenas uma habilidade (cwa-weather) utiliza uma chave de API gratuita fornecida instantaneamente.
Funciona com agentes de codificação que suportam npx skills add, como Claude Code, Codex e OpenCode.
Instalação
# Instalar todas as habilidades
npx --yes skills add tahodev/baodao-skill --all -g
# Instalar uma habilidade específica
npx --yes skills add tahodev/baodao-skill --skill invoice-winning-numbers -g
Requer Node.js 18+ e npx. Consulte o guia de instalação para detalhes.
Funcionalidades
A coluna "Login" indica se o usuário precisa de uma conta ou chave.
| Funcionalidade | Nome da Habilidade | Descrição | Login | Documentação |
|---|---|---|---|---|
| Verificar números da sorte de notas fiscais | invoice-winning-numbers | Números vencedores mais recentes, verificação em lote, prêmios exclusivos de nota fiscal eletrônica (lista PDF) e orientação para períodos anteriores | Não necessário | Guia invoice-winning-numbers |
| Consulta em tempo real de estações YouBike | youbike-realtime | Bicicletas disponíveis e vagas para devolução em tempo real para estações YouBike 2.0 em 14 áreas de serviço em todo Taiwan (Taipei, New Taipei, Taoyuan, Taichung, Tainan, Kaohsiung, etc.), incluindo filtro por bicicletas elétricas | Não necessário | Guia youbike-realtime |
| Rotas de caminhões de lixo de Taipei/New Taipei | taiwan-garbage | Pontos de coleta e horários para Taipei (CSV) e New Taipei (API JSON com horários por dia da semana); New Taipei inclui agendamento semanal, permitindo verificar se há coleta hoje | Não necessário | Guia taiwan-garbage |
| Previsão do tempo oficial da CWA | cwa-weather | Previsões de 36 horas para municípios e distritos via API de dados abertos da Agência Central de Meteorologia (fonte oficial) | Necessário (chave gratuita fornecida instantaneamente) | Guia cwa-weather |
| Consulta meteorológica em Taiwan | taiwan-weather | Previsão do tempo via Open-Meteo (sem chave) e alertas de desastres (tufão, terremoto, tsunami) via feeds NCDR CAP (sem chave) — alternativa sem chave para cwa-weather | Não necessário | Guia taiwan-weather |
A fonte oficial de cada habilidade é <nome-da-habilidade>/SKILL.md. Os guias em docs/features/ são versões resumidas; para procedimentos completos, parâmetros e tratamento de erros, consulte sempre o SKILL.md.
Escopo:
- Serviços com proteção anti-scraping rigorosa (Shopee, Momo, 591, Foodpanda, etc.) estão fora do escopo.
- Nenhuma habilidade altera o estado externo: sem reservas, compras ou postagens. Apenas consultas e cálculos.
- Os dados são reproduzidos conforme divulgados pelas fontes oficiais. Para decisões importantes (prazos de resgate, dias sem coleta de lixo, alertas de tufão, etc.), sempre confirme no site oficial.
Plano de 30 dias
Este repositório cresce no ritmo de "uma habilidade por dia". Abaixo estão as habilidades candidatas, em ordem indefinida; concluídas recebem um visto:
- Feriados nacionais e pontes (calendário de trabalho da Diretoria-Geral de Administração de Pessoal)
- Previsão do tempo oficial da CWA (chave de API gratuita) →
cwa-weather - Números vencedores de prêmios exclusivos de nota fiscal eletrônica →
invoice-winning-numbers(análise de lista PDF, 2026-09-09) - Caminhões de lixo de outros municípios (New Taipei →
taiwan-garbagejá suportado; Taoyuan, Taichung, Tainan, Kaohsiung pendentes) - Horários e tarifas do trem de alta velocidade (THSR) via TDX (chave de API gratuita)
- Horários do trem convencional (TRA) via TDX (chave de API gratuita)
- Consulta em tempo real de ônibus via TDX
- Índice de qualidade do ar (AQI)
- Alertas de terremoto e dinâmica de tufão → seção NCDR CAP do
taiwan-weather(2026-09-09) - Vagas restantes em estacionamentos
- Consulta de CEP
- Informações de oferta e demanda de energia elétrica (Taipower)
- Consulta de preços de combustível (CPC Taiwan)
- Consulta de taxas de câmbio
- Avisos de suspensão de trabalho e aulas
- Cotações de produtos agrícolas
- Simulação de imposto de renda
- Verificação de CNPJ e número de identidade
- Consulta de hospitais e clínicas
- Consulta de acervo de bibliotecas públicas
- Condições de trânsito em tempo real em rodovias
- Índice de radiação ultravioleta
- Avisos de interrupção de abastecimento de água
- Conversão de datas no calendário lunar e estações do ano
- Cálculo de taxas de previdência social e seguro saúde
- Cálculo de tarifas postais
English
baodao-skill (寶島, "baodao" = ilha do tesouro, nome carinhoso para Taiwan) é uma coleção de habilidades de agente de IA para o cotidiano em Taiwan. Foca em consultas somente leitura baseadas exclusivamente em APIs oficiais e conjuntos de dados públicos: sem barreiras de login, sem chaves de API, sem scraping.
Funciona com qualquer agente de codificação que suporte npx skills add (Claude Code, Codex, OpenCode, ...).
Instalação
# Instalar todas as habilidades
npx --yes skills add tahodev/baodao-skill --all -g
# Instalar uma habilidade específica
npx --yes skills add tahodev/baodao-skill --skill invoice-winning-numbers -g
Requer Node.js 18+ e npx. Consulte o guia de instalação para detalhes.
O que você pode fazer
| Funcionalidade | Habilidade | Descrição | Login | Documentação |
|---|---|---|---|---|
| Verificar números da sorte de notas fiscais unificadas de Taiwan | invoice-winning-numbers | Números vencedores mais recentes, verificação em lote, prêmios exclusivos de nota fiscal eletrônica (listas PDF) e orientação para períodos anteriores a partir das páginas públicas do Ministério da Fazenda | Não necessário | Guia invoice-winning-numbers |
| Consultar disponibilidade de estações YouBike | youbike-realtime | Bicicletas disponíveis e vagas para devolução em tempo real para estações YouBike 2.0 em 14 áreas de serviço em todo o país (Taipei, New Taipei, Taoyuan, Taichung, Tainan, Kaohsiung, etc.), incluindo filtro por bicicletas elétricas | Não necessário | Guia youbike-realtime |
| Consultar rotas de caminhões de lixo | taiwan-garbage | Pontos de coleta e horários para Taipei (CSV) e New Taipei (API JSON com horários por dia da semana) | Não necessário | Guia taiwan-garbage |
| Consultar previsões oficiais da CWA | cwa-weather | Previsões de 36 horas para municípios e distritos via API de dados abertos da CWA (fonte oficial) | Chave de API gratuita fornecida instantaneamente | Guia cwa-weather |
| Consultar clima em Taiwan | taiwan-weather | Clima via Open-Meteo (sem chave) mais alertas de desastres (tufão, terremoto, tsunami) via feeds NCDR CAP (sem chave) — backup sem chave para cwa-weather | Não necessário | Guia taiwan-weather |
A fonte oficial de cada habilidade é <habilidade>/SKILL.md. Os guias em docs/features/ são resumos apenas - consulte sempre o SKILL.md para procedimentos completos, parâmetros e tratamento de erros.
Notas de escopo:
- Serviços com forte proteção anti-scraping estão fora do escopo.
- Nada aqui altera o estado: sem reservas, compras ou postagens. Apenas consultas e cálculos.
- Os dados são reproduzidos conforme divulgados pelas fontes oficiais. Confirme qualquer informação importante (prazos de resgate, feriados de coleta, avisos de tufão) no site oficial.
Este repositório cresce uma habilidade por dia - veja o roteiro acima.