mcpField
C
calendar-api

calendar-api

github.com/wmy2981其他153 次安装5 周前更新
代码仓库

关于 calendar-api

calendar-api 是通过 接口盒子 API 查询指定日期传统黄历信息的技能。默认查询当天，并按类别展示返回字段，也可输出原始 JSON。

主要功能

  1. 01通过 接口盒子 API 查询黄历
  2. 02默认查询当天日期
  3. 03支持输入指定日期
  4. 04按类别显示非空字段
  5. 05支持输出原始 JSON

适用场景

  1. 01查询当天的传统历法信息
  2. 02查看指定日期的宜忌等内容
  3. 03以 JSON 检查 API 返回结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/wmy2981/skills --skill calendar-api

安装后在 Claude Code 中输入/calendar-api确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.claude-plugin/
plugin.json
references/
api_doc.md
scripts/
.env.example
getzdday.py

详细介绍

中国日历查询

查询接口盒子 API（API ID：278），获取任意日期的完整中国传统日历（黄历）信息。

执行规则

直接运行用户请求的命令，不要预先检查依赖、环境变量或配置。如果出现问题，脚本会报出清晰的错误——届时再检查并修复。

环境变量

变量说明
JKHZ_ID接口盒子 (apihz.cn) 用户 ID
JKHZ_KEY接口盒子 API 密钥

脚本会自动从 ~/.wmyskills/.env（所有技能共用）加载这些变量；如果脚本目录中存在 scripts/.env，则优先使用其中的变量。请以 scripts/.env.example 为模板，将变量添加到 ~/.wmyskills/.env，切勿覆盖已有文件。

要求

pip install python-dotenv tzdata

用法

脚本：scripts/getzdday.py

查询今天
python scripts/getzdday.py
查询指定日期
python scripts/getzdday.py 2025-06-05
输出原始 JSON（用于调试）
python scripts/getzdday.py 2025-06-05 --json

输出类别

脚本将返回的数据整理为以下类别：

类别字段
📆 公历年、月、日、星期、闰年
🌙 农历农历年、月、日
🎊 节日公历节日、农历节日
⭐ 星座与生肖星座、生肖、日生肖
📜 干支年／月／日干支、日纳音
🌿 节气与物候节气、说明、物候、数九、三伏
☯ 宜忌宜、忌、吉神、凶神
🧭 方位喜神、财神、福神、贵神方位
⚠️ 冲煞相冲、方向冲、天神、黄道／黑道
🔢 值星与神煞值星（12 值星）、12 神、六爻、月相
🌟 星宿28 星宿、动物、吉凶、七曜、四宫、四象
📖 彭祖与胎神彭祖百忌、胎神方位、太岁
📅 佛道历佛历、道历、伊斯兰历
📊 其他五行、儒略日、九星、季节

注意事项

  • 默认查询今天（Asia/Shanghai 时区）
  • API 支持的年份范围：1800 年至明年
  • 格式化输出适合直接显示；使用 --json 进行调试
  • API 可能会因日期不同而返回不同字段；脚本会动态显示所有非空字段
  • 匹配用户使用的语言。 输出语言必须与用户提问的语言一致。用户用中文提问时，所有类别标签和说明都必须使用中文；用英语提问时则使用英语。

评论

支持 Markdown