← Back to Skills Marketplace
114
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install china-holiday-decem
Description
中国法定节假日查询，基于 timor.tech 免费 API。支持查询指定日期节假日信息、批量查询、下一节假日、下一工作日、全年节假日列表，以及语音播报。触发场景：问"今天上班吗"、"明天放假吗"、"2026年有哪些节假日"、"清明节放几天"、"调休怎么调"等节假日相关问题。依赖：Python 3，仅使用标准库（...
README (SKILL.md)
中国节假日查询
调用 timor.tech 免费节假日 API，数据覆盖 2013 年至今，支持节假日、调休、补班查询。
依赖
- Python 3（仅标准库，无第三方依赖）
- 网络访问权限（调用 timor.tech API）
脚本
python3 skills/china-holiday/scripts/china_holiday.py \x3C命令> [参数]
命令速查
| 命令 | 说明 | 示例 |
|---|---|---|
info [日期] |
查询指定日期节假日 | info 2026-10-01 / info（今天） |
batch \x3C日期...> |
批量查询 | 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），由独立开发者利用业余时间维护，每年更新节假日数据，服务稳定且完全免费。深深感谢作者的无私奉献 🌿
Usage Guidance
This skill is a small, self-contained Python script that makes HTTPS calls to the public timor.tech API and prints results. Before installing, be aware that: (1) it requires network access and will query timor.tech for each lookup (no credentials are sent); (2) availability or accuracy depends on timor.tech; (3) the TTS commands return text from the API (no audio is synthesized locally); (4) you can safely inspect the included scripts (they are short and use only urllib/json/datetime) before enabling the skill. If you need offline operation or stronger guarantees about data retention, do not enable it or run the script in a restricted environment.
Capability Analysis
Type: OpenClaw Skill
Name: china-holiday-decem
Version: 1.0.1
The skill is a legitimate tool for querying Chinese statutory holidays using the public timor.tech API. The Python script (china_holiday.py) uses only standard libraries and performs no suspicious actions such as data exfiltration, local file access, or arbitrary command execution. All network requests are directed to the stated API endpoint.
Capability Assessment
Purpose & Capability
Name/description (China holiday lookup via timor.tech) match the included script and runtime instructions. The script only uses Python standard library and makes HTTPS requests to timor.tech, which is appropriate for the stated purpose.
Instruction Scope
SKILL.md limits actions to running the included Python script and calling timor.tech. It does not read files, env vars, or external endpoints beyond timor.tech. Minor inconsistency: SKILL.md shows an example path 'skills/china-holiday/scripts/china_holiday.py' while the package contains 'scripts/china_holiday.py' — a path mismatch but not a security issue.
Install Mechanism
No install spec or external downloads; the skill is instruction-only with one small Python script. Nothing is written to disk or fetched at install time beyond the usual agent-managed files.
Credentials
The skill requests no environment variables, credentials, or config paths. Its network access to timor.tech is proportional to its function; no sensitive system secrets are requested.
Persistence & Privilege
always is false and the skill does not request persistent or elevated privileges, nor does it modify other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install china-holiday-decem - After installation, invoke the skill by name or use
/china-holiday-decem - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- 明确声明依赖为 Python 3 并且仅使用标准库，无需第三方依赖。
- 新增“依赖”与“致谢”章节，感谢 timor.tech API 提供者。
- 优化描述，强调对网络访问权限的需求。
- 其余功能与用法无变动，仅文档内容补充与说明更完善。
v1.0.0
- Initial release of China Holiday skill (china-holiday-decem v1.0.0).
- Provides quick queries for Chinese statutory holidays, compensatory workdays, and year/period holiday lists via timor.tech free API.
- Supports multiple commands (e.g., today’s holiday, tomorrow's status, next holiday/workday, whole year/month overview).
- Offers both text and voice (TTS) responses for holiday information.
- Easy command-line interface for both single and batch date queries.
- Clear documentation of API fields, usage instructions, and limitations.
Metadata
Frequently Asked Questions
What is China Holiday?
中国法定节假日查询，基于 timor.tech 免费 API。支持查询指定日期节假日信息、批量查询、下一节假日、下一工作日、全年节假日列表，以及语音播报。触发场景：问"今天上班吗"、"明天放假吗"、"2026年有哪些节假日"、"清明节放几天"、"调休怎么调"等节假日相关问题。依赖：Python 3，仅使用标准库（... It is an AI Agent Skill for Claude Code / OpenClaw, with 114 downloads so far.
How do I install China Holiday?
Run "/install china-holiday-decem" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is China Holiday free?
Yes, China Holiday is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does China Holiday support?
China Holiday is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created China Holiday?
It is built and maintained by Decem (@decemjiang); the current version is v1.0.1.
More Skills