核心用法
该 skill 提供中国传统农历黄历查询与吉凶择日服务,支持三种调用模式:
1. 单日查询 (`by-date`)
- 输入公历日期(YYYY-MM-DD),返回当日完整黄历信息
- 包括:农历日期、干支纪年、宜忌事项、吉凶神煞、冲煞方位
2. 批量查询 (`batch`)
- 支持日期区间批量查询,可叠加筛选条件(如"搬家""结婚")
- 适用于比对多日、整周或整月的吉日选择
3. 关键词搜索 (`search`)
- 跨日期范围检索特定关键词(甲子日、摩羯座、初一、搬家等)
- 基于返回数据本地筛选,无服务端关键词搜索接口
显著优点
- 专业性强:覆盖传统黄历核心要素——宜忌、神煞、冲煞、择日,满足民俗需求
- 场景丰富:内置搬家、结婚、开业、开工等常见择日场景
- 批量高效:区间查询+筛选功能适合复杂日程规划
- 轻量接入:Python 3.9+/bash+curl 即可运行,仅需 HTTPS 出站
潜在局限
- 配额限制:每日仅10个唯一日期免费额度,超额需手动重置(429错误)
- 无服务端搜索:关键词检索依赖本地数据处理,大数据量时效率受限
- 传统属性:黄历吉凶基于民俗历法,无现代科学验证依据
- 依赖第三方 Token:需注册获取 HUANGLI_TOKEN,存在服务持续性风险
适合人群
- 需要传统择日参考的个人用户(婚嫁、搬家、开业等)
- 开发民俗/日历类应用的开发者
- 对中国传统文化感兴趣的研究者
常规风险
- 服务可用性:依赖 api.nongli.skill.4glz.com 单点服务
- Token 安全:Bearer token 需妥善保管,避免泄露
- 迷信误导:吉凶判断属传统文化范畴,不应作为重大决策的唯一依据