CN Calendar Skill

Servidor MCP del calendario chino: festivos, conversión lunar/solar, 24 términos solares, cálculo de días laborables, 13 endpoints, sin dependencia de API.

GitHub

Prueba este MCPPatrocinado

Documentación

cn-calendar-skill

Kit completo de calendario chino — días laborables · festivos · conversión de calendario lunar · consulta de términos solares

Instalación en una frase

npx skills add demo112/cn-calendar-skill

Después de instalarlo, dile directamente a Claude Code / Codex / Cursor / Hermes: «¿Cuántos días laborables tiene junio?» «¿Cómo encadeno 2 días de vacaciones para tener el descanso más largo?»

100% offline · Cero API Key · Cero peticiones de red · Datos oficiales del Consejo de Estado

¿Qué problemas resuelve?

Todo desarrollador chino se ha encontrado con estas situaciones:

# ❌ 硬编码节假日 — 每年更新，调休补班容易漏
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个工作日付款，到期日是哪天？"

SKILL.md incluye el código Python completo + los datos de ajuste de días festivos del Consejo de Estado (2004-2026), listo para usar tras la instalación.

13 endpoints

📅 Capa de calendario

Endpoint	Uso	Ejemplo
`is_workday_cn(date)`	Determinación de día laborable (incluye días de compensación)	2026-09-28 domingo de compensación → True
`next_holiday(date)`	Siguiente festivo oficial + fechas de inicio y fin	→ Día Nacional 10/1-10/7
`cn_date_info(date)`	Consulta integral (devuelve todo de una vez)	→ Día laborable + calendario lunar + término solar + signo zodiacal

💼 Capa de días laborables

Endpoint	Uso	Escenario
`add_workdays(start, n)`	El N-ésimo día laborable	Períodos de facturación / tiempos logísticos
`count_workdays(start, end)`	Número de días laborables en un rango	Asistencia RR.HH. / planificación de turnos
`find_bridge_leaves(date, n)`	Tomar N días de vacaciones para encadenar X días	Clasificación por rentabilidad de las vacaciones

🌙 Capa de calendario lunar

Endpoint	Uso
`solar_to_lunar(date)`	Calendario gregoriano → Calendario lunar
`lunar_to_solar(year, month, day)`	Calendario lunar → Calendario gregoriano
`get_solar_term(date)`	Término solar actual / siguiente
`get_zodiac(year)` / `get_zodiac_strict(date)`	Signo zodiacal chino (gregoriano/lunar)
`get_constellation(date)`	12 signos del zodiaco

Ejemplo de conversación real

👤 "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（周五）。

Detalles técnicos

Fuente de datos:

Festivos oficiales: chinese-calendar (Aviso oficial de la Oficina General del Consejo de Estado, 2004-2026)
Calendario lunar: zhdate (1900-2100)
Términos solares: fórmula astronómica, precisión del siglo XXI ±1 día

Instalación de dependencias:

pip install chinese-calendar zhdate

Agentes compatibles: Claude Code · Codex · Cursor · Hermes · Cline · OpenCode · Windsurf · cualquier agente compatible con SKILL.md

¿Quién lo usa?

Equipos de RR.HH. — planificación automática de turnos / estadísticas de asistencia
Operaciones de e-commerce — planificación de fechas de grandes promociones (Festival del Medio Otoño / Día Nacional / 11.11)
Departamentos financieros — cálculo de períodos de facturación de contratos (según días laborables)
Empresas de logística — promesas de tiempo de entrega (según días laborables)
Desarrolladores individuales — planificación de vacaciones / recordatorios de cumpleaños lunares

Soporte

¿Quieres un nuevo endpoint? Abrir Issue
¿Has encontrado un error en los datos? Enviar Bug
¿Te resulta útil? Dale una ⭐ Star

Donate

Si te ha ayudado en tu flujo de trabajo:

ETH/USDT (ERC-20): 0xddD9f45e14c92846f47C1c1A4431aC2b41D87273