CN Calendar Skill

Servidor MCP de calendário chinês — feriados, conversão lunar/solar, 24 termos solares, cálculo de dias úteis, 13 endpoints, zero dependência de API

GitHub

Documentação

cn-calendar-skill

Kit completo de calendário chinês — verificação de dias úteis · cálculo de feriados · conversão do calendário lunar · consulta de termos solares

Instalação em uma frase

npx skills add demo112/cn-calendar-skill

Depois de instalar, basta dizer ao Claude Code / Codex / Cursor / Hermes: «Quantos dias úteis tem junho?» «Como tirar 2 dias de folga e emendar o máximo possível?»

Totalmente offline · Zero API Key · Zero requisições de rede · Dados oficiais do Conselho de Estado

Que problemas isso resolve?

Todo desenvolvedor chinês já enfrentou estas situações:

# ❌ 硬编码节假日 — 每年更新，调休补班容易漏
if date in ['2026-01-01', '2026-01-02', ...]:
    ...

# ❌ 调外部 API — 被限频/掉线/收费
requests.get('https://some-api.com/holiday?date=2026-06-19')

# ✅ 用 cn-calendar-skill — 一句话搞定
"今天开票，合同写30个工作日付款，到期日是哪天？"

O SKILL.md incorpora o código Python completo + dados de compensação de feriados do Conselho de Estado (2004-2026), pronto para usar após a instalação.

13 endpoints

📅 Camada de calendário

Endpoint	Uso	Exemplo
`is_workday_cn(date)`	Verificação de dia útil (incluindo compensações)	2026-09-28 domingo compensado → True
`next_holiday(date)`	Próximo feriado oficial + datas de início e fim	→ Dia Nacional 10/1-10/7
`cn_date_info(date)`	Consulta abrangente (retorna tudo de uma vez)	→ Dia útil + calendário lunar + termos solares + signo

💼 Camada de dias úteis

Endpoint	Uso	Cenário
`add_workdays(start, n)`	Enésimo dia útil	Ciclo de faturamento / prazo logístico
`count_workdays(start, end)`	Número de dias úteis no intervalo	Ponto/agendamento de RH
`find_bridge_leaves(date, n)`	Tirar N dias de folga emendando X dias	Classificação de melhor custo-benefício de folga

🌙 Camada do calendário lunar

Endpoint	Uso
`solar_to_lunar(date)`	Gregoriano → Lunar
`lunar_to_solar(year, month, day)`	Lunar → Gregoriano
`get_solar_term(date)`	Termo solar atual/próximo
`get_zodiac(year)` / `get_zodiac_strict(date)`	Signo do zodíaco chinês (gregoriano/lunar)
`get_constellation(date)`	12 signos do zodíaco

Exemplos reais de conversa

👤 "6月份有多少工作日，端午是几号到几号？"
🤖 6月有 20 个工作日。端午节 5/31-6/2 放假 3 天。

👤 "请2天假，怎么请最划算？"
🤖 推荐方案：6/26(五) + 6/29(一) 请假 2 天，连出 5 天假期(6/26-6/30)。

👤 "客户合同写'开票后 30 个工作日付款'，今天开票，到期日？"
🤖 30 个工作日后是 2026-07-13（周一）。

👤 "我妈生日农历八月初八，今年公历哪天？"
🤖 农历八月初八 → 2026-09-18（周五）。

Detalhes técnicos

Fontes de dados:

Feriados oficiais: chinese-calendar (Aviso oficial do Gabinete Geral do Conselho de Estado, 2004-2026)
Calendário lunar: zhdate (1900-2100)
Termos solares: fórmula astronômica, precisão do século XXI ±1 dia

Instalação de dependências:

pip install chinese-calendar zhdate

Agentes compatíveis: Claude Code · Codex · Cursor · Hermes · Cline · OpenCode · Windsurf · Qualquer agente que suporte SKILL.md

Quem está usando?

Equipes de RH — agendamento automático / estatísticas de ponto
Operações de e-commerce — planejamento de datas promocionais (Festival do Meio do Outono / Dia Nacional / 11.11)
Departamentos financeiros — cálculo de ciclos de faturamento de contratos (base de dias úteis)
Empresas de logística — promessas de prazo (base de dias úteis)
Desenvolvedores individuais — planejamento de folgas / lembretes de aniversário lunar

Suporte

Quer um novo endpoint? Abra uma Issue
Encontrou dados incorretos? Envie um Bug
Achou útil? Dê uma ⭐ Star

Donate

Se ajudou no seu fluxo de trabalho:

ETH/USDT (ERC-20): 0xddD9f45e14c92846f47C1c1A4431aC2b41D87273