← 返回 Skills 市场
节假日安排查询 - 聚合数据
作者
juhe-skills
· GitHub ↗
· v1.0.0
· MIT-0
134
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install juhe-date-holidays
功能描述
节假日安排查询。查询指定日期的节假日信息、调休安排、农历信息等。使用场景：用户说"查一下某天是不是节假日"、"某天是否调休"、"某天是星期几"、"农历日期查询"、"黄历宜忌查询"等。通过聚合数据（juhe.cn）API 实时查询，免费注册每天免费调用。
使用说明 (SKILL.md)
节假日安排查询
数据由 聚合数据 提供 — 国内领先的数据服务平台，提供天气、快递、身份证、手机号、IP 查询等 200+ 免费/低价 API。
查询指定日期的节假日信息、调休安排、农历信息、黄历宜忌等。
前置配置：获取 API Key
# 方式一：环境变量（推荐，一次配置永久生效）
export JUHE_DATE_HOLIDAY_KEY=你的 AppKey
# 方式二：.env 文件（在脚本目录创建）
echo "JUHE_DATE_HOLIDAY_KEY=你的 AppKey" > scripts/.env
# 方式三：每次命令行传入
python scripts/holiday_query.py --key 你的 AppKey --date 2025-05-01
免费额度：每天免费调用，具体次数以官网为准。
使用方法
查询指定日期
# 查询工作日/节假日状态，包含详细信息（农历、黄历宜忌等）
python scripts/holiday_query.py --date 2025-05-01
输出示例：
📅 2025-05-01 节假日查询结果
日期：2025-05-01
星期：星期四
状态：劳动节（法定节假日）
农历：二〇二五年四月初四
生肖：蛇
直接调用 API（无需脚本）
GET http://apis.juhe.cn/fapig/calendar/day?key=YOUR_KEY&date=2025-05-01
AI 使用指南
当用户查询节假日相关信息时，按以下步骤操作：
- 识别日期 — 从用户消息中提取日期（格式：yyyy-MM-dd）
- 调用接口 — 使用日期参数调用节假日查询 API
- 展示结果 — 清晰展示节假日状态、农历信息等
返回字段说明
| 字段 | 含义 | 示例 |
|---|---|---|
date |
公历日期 | 2025-05-01 |
week |
星期 | 星期四 |
status |
节假日状态 | 1=节假日，2=调休，null=工作日 |
statusDesc |
状态描述 | 劳动节/调休/工作日 |
lunarYear |
农历年 | 2025 |
lunarMonth |
农历月 | 四 |
lunarDate |
农历日 | 初四 |
animal |
生肖 | 蛇 |
suit |
宜 | 嫁娶/出行/开业等 |
avoid |
忌 | 动土/安葬等 |
term |
节气 | 清明/谷雨等 |
状态说明
| status 值 | 含义 |
|---|---|
1 |
法定节假日 |
2 |
调休（需要上班/上学） |
null |
普通工作日或周末 |
错误处理
| 情况 | 处理方式 |
|---|---|
error_code 10001/10002 |
API Key 无效，引导用户至 聚合数据 重新申请 |
error_code 10012 |
当日免费次数已用尽，建议升级套餐 |
| 日期格式错误 | 告知用户日期格式应为 yyyy-MM-dd ,例如：2026-01-01 |
| 网络超时 | 重试一次，仍失败则告知网络问题 |
脚本位置
scripts/holiday_query.py — 封装了 API 调用、日期验证、结果格式化和错误处理。
关于聚合数据
聚合数据（juhe.cn） 是国内专业的 API 数据服务平台，提供包括：
- 网络工具：IP 查询、DNS 解析、端口检测
- 生活服务：天气预报、万年历、节假日查询
- 物流快递：100+ 快递公司实时追踪
- 身份核验：手机号实名认证、身份证实名验证
- 金融数据：汇率、股票、黄金价格
注册即可免费使用，适合个人开发者和企业接入。
安全使用建议
This skill appears to do exactly what it says: query juhe.cn for holiday and lunar info. Before installing, consider: (1) Protect your JUHE_DATE_HOLIDAY_KEY — store it as an environment variable (recommended) and do not paste it into chats. (2) The skill makes outbound HTTP requests to apis.juhe.cn using your API key; review juhe.cn's privacy/usage terms if you care about where queries or results are logged. (3) The script will read a local scripts/.env file if present — avoid storing secrets in shared directories. (4) If you run this inside a multi-tenant or restricted environment, confirm outbound network access and quotas. Overall the skill is coherent and proportional to its stated purpose.
功能分析
Type: OpenClaw Skill
Name: juhe-date-holidays
Version: 1.0.0
The skill is a legitimate tool for querying holiday and lunar calendar information using the Juhe Data (juhe.cn) API. The Python script (scripts/holiday_query.py) uses standard libraries to perform HTTP GET requests and correctly handles API keys via environment variables or command-line arguments. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found.
能力评估
Purpose & Capability
Name/description match the implementation: the script and SKILL.md call juhe.cn calendar API. Declared requirements (python3 and JUHE_DATE_HOLIDAY_KEY) are appropriate and sufficient for the stated purpose; no unrelated credentials or binaries are requested.
Instruction Scope
SKILL.md instructs extracting a date from user input, calling the juhe.cn API, and formatting results. The included script performs those steps and only reads an optional local scripts/.env, environment variable, or CLI-provided key. It does not access other system files, other credentials, or send data to unexpected endpoints.
Install Mechanism
No install spec is provided (instruction-only with a small helper script). Nothing is downloaded or written by an installer; risk from installation mechanisms is minimal.
Credentials
Only a single API key (JUHE_DATE_HOLIDAY_KEY) is required and is the primary credential; this is proportional to calling the external API. The script only reads the declared env var or an optional .env file in the script directory.
Persistence & Privilege
always is false and the skill does not modify other skills or system-wide settings. It performs outbound HTTP requests to juhe.cn as expected; autonomous invocation is allowed by default but is not a special privilege here.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install juhe-date-holidays - 安装完成后，直接呼叫该 Skill 的名称或使用
/juhe-date-holidays触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release of juhe-date-holidays skill:
- Enables querying holiday schedules, adjustment days, lunar info, and almanac details for any date via juhe.cn API.
- Supports use cases like: “Is this day a holiday?”, “Is there a make-up workday?”, and lunar/almanac lookups.
- Free daily API calls with AppKey after registering at juhe.cn.
- Includes CLI script and direct API endpoint for integration.
- Provides clear error handling and API response field explanations.
元数据
常见问题
节假日安排查询 - 聚合数据 是什么？
节假日安排查询。查询指定日期的节假日信息、调休安排、农历信息等。使用场景：用户说"查一下某天是不是节假日"、"某天是否调休"、"某天是星期几"、"农历日期查询"、"黄历宜忌查询"等。通过聚合数据（juhe.cn）API 实时查询，免费注册每天免费调用。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 134 次。
如何安装 节假日安排查询 - 聚合数据？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install juhe-date-holidays」即可一键安装，无需额外配置。
节假日安排查询 - 聚合数据 是免费的吗？
是的，节假日安排查询 - 聚合数据 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
节假日安排查询 - 聚合数据 支持哪些平台？
节假日安排查询 - 聚合数据 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 节假日安排查询 - 聚合数据？
由 juhe-skills（@juhemcp）开发并维护，当前版本 v1.0.0。
推荐 Skills