国内应用接入
中国节假日 MCP 接入:查放假、周末与调休补班
这个连接不需要账号或 API Key。机器人可以判断某一天是法定假日、调休上班、普通周末还是工作日,也能列出某年的全部法定假日与补班日。
为什么普通日历不够用?
中国法定节假日常伴随周末调休:有些周六、周日需要上班,有些工作日则放假。只看星期几会让定时任务、客服排班和出行提醒产生错误,因此需要按每年公布的具体安排查询。
当前连接使用根据国务院办公厅节假日通知整理的公开数据,并区分法定假日、调休补班、普通周末和普通工作日。无需凭证;如果某一年还没有可靠数据,工具会明确报错,而不会把未知日期猜成工作日。
接入后可以做什么?
- 查询单日性质:按中国时区判断指定日期属于法定假日、调休补班、周末或普通工作日。
- 查看全年安排:列出指定年份的全部法定假日和调休补班日,适合排班与日程规划。
- 辅助定时任务:让机器人在安排提醒、日报或出行计划前先检查当天是否需要上班。
需要申请节假日 API Key 吗?
不需要。该连接读取公开节假日安排,没有账号、Token 或 API Key;在国内应用列表直接连接即可。
- 准备机器人 — 部署或打开一个 OpenClaw 或 Hermes 实例,确保它可以使用国内应用工具。
- 打开国内应用列表 — 进入国内应用页面,搜索“中国节假日”或“节假日”。
- 无需凭证直接连接 — 选择节假日连接并启用,不需要填写任何密钥。
- 用已知日期校验 — 先查询当年春节、国庆等已知日期,确认返回的假日名称和日期正确。
- 再查看全年补班 — 列出当年全部调休补班日,把结果用于提醒或排班前再人工复核。
连接后可以直接这样问
- “2026 年 10 月 1 日是什么类型的日期?需要上班吗?”
- “列出 2026 年全部法定节假日和调休补班日”
- “下周一发送日报前先判断是不是中国法定工作日”
使用前必须知道的限制
数据覆盖 2007–2100 的可用年份,但未来年份只有在官方安排发布并被数据源收录后才可靠;没有数据时工具会报错。它不包含各公司、学校、地区或行业的自定义放假,也不判断证券交易日。官方临时调整可能晚于缓存更新,缓存最长约 12 小时。
普通提醒和行程规划可以直接参考,但工资、考勤、合同期限、法定加班费等具有法律或财务影响的事项,应再次核对国务院办公厅最新通知和单位制度,不要只依赖机器人回答。
托管连接还是自己搭工具?
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接中国节假日的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 OpenClaw/Hermes 与兼容工具的开发者 | 自行维护国务院节假日数据的抓取、镜像与缓存,区分假日/补班/周末/工作日,处理未来年份缺失、临时调整和上游不可用。 |
自行部署是合理选择;托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3,续费 $6/月,支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人?前往国内应用一键接入查看连接状态;第一次部署可先阅读养龙虾入门指南。
中国节假日接入常见问题
查询节假日需要 API Key 吗?
不需要。该连接使用公开节假日安排,启用后即可查询。
能识别周末调休上班吗?
可以。结果会把调休补班和普通周末分开,不会只按星期几判断。
可以查询未来很多年的安排吗?
只有官方已发布并被数据源收录的年份才可靠;未来安排尚未公布时会报数据缺失,不会猜测。
能用于工资和加班费计算吗?
可作辅助参考,但应以国务院最新通知、当地规则和单位制度为准,不能把机器人结果当作法律结论。