China Holiday

中国法定节假日查询，基于 timor.tech 免费 API。支持查询指定日期节假日信息、批量查询、下一节假日、下一工作日、全年节假日列表，以及语音播报。触发场景：问"今天上班吗"、"明天放假吗"、"2026年有哪些节假日"、"清明节放几天"、"调休怎么调"等节假日相关问题。依赖：Python 3，仅使用标准库（urllib, json, datetime）。

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalAdvisory

Multi-engine malware detections and file reputation.

Install

openclaw skills install china-holiday-decem

中国节假日查询

调用 timor.tech 免费节假日 API，数据覆盖 2013 年至今，支持节假日、调休、补班查询。

依赖

Python 3（仅标准库，无第三方依赖）
网络访问权限（调用 timor.tech API）

脚本

python3 skills/china-holiday/scripts/china_holiday.py <命令> [参数]

命令速查

命令	说明	示例
`info [日期]`	查询指定日期节假日	`info 2026-10-01` / `info`（今天）
`batch <日期...>`	批量查询	`batch 2026-05-01 2026-06-01`
`next [日期]`	下一节假日（含调休）	`next 2026-04-01`
`workday [日期]`	下一工作日	`workday`
`year [年份/月份]`	全年/全月节假日	`year 2026` / `year 2026-02`
`tts`	今日节假日播报	-
`tts-next`	下一节假日播报	-
`tts-tomorrow`	明日节假日播报	-

响应字段说明

日期类型 (type)：

0 = 工作日
1 = 周末
2 = 节日
3 = 调休/补班

holiday 字段（非节假日为 null）：

holiday: true/false — true=节日，false=调休
wage — 薪资倍数（2=双薪，3=三薪）
after: true/false — 假后/假前补班
target — 调休对应的节日名

注意事项

API 每日限额 10000 次/IP，免费足够个人使用
返回日期格式：YYYY-MM-DD
全年查询整年需加斜杠：year 2026 → 请求 /year/2026/

致谢

节假日数据来源于 提莫的神秘小站（timor.tech），由独立开发者利用业余时间维护，每年更新节假日数据，服务稳定且完全免费。深深感谢作者的无私奉献 🌿