核心功能
本技能是面向中国农历/黄历/吉凶查询的全能工具，覆盖三大核心场景：
1. 农历查询
- 公历转农历：任意公历日期换算为中国农历年月日、生肖、干支
- 今日农历：实时查询当天农历日期
- 阴历换算：支持中国农历/阴历日期互转
2. 黄历查询（今日黄历/老黄历/宜忌）
- 单日查询：查询任意日期的黄历详情，含每日宜忌、吉神凶煞、冲煞
- 批量查询：支持日期区间批量检索，可按活动类型（搬家/结婚/开业/开工）筛选
- 择日功能：专项查询搬家吉日、结婚吉日、开业吉日、开工吉日
3. 吉凶查询
- 吉日凶日筛选与判断
- 黄历吉凶神煞解析
显著优点
- AI Agent 完全自主认证：无需人工干预，配置用户名密码即可自动完成注册/登录/获取token，全程无浏览器、无轮询
- 三重查询模式灵活：by-date单日查询、batch区间批量筛选、search关键词检索（甲子日/初一/吉凶等）
- 免费额度实用：每日10个唯一日期免费额度，超额429可手动重置且不限次数
- 双端兼容：支持 Python 3.9+ 或 bash + curl 环境
- 开源可信：MIT 许可证，GitHub 源码可审计
潜在局限与风险
- 依赖外部 API：核心功能依赖
api.nongli.skill.4glz.com，服务可用性受第三方影响 - 免费额度限制：高频查询场景（如整年吉日批量筛选）易触发429限流
- 玄学属性：黄历/吉凶判断基于传统历法与民俗信仰，无科学依据，不宜用于重大决策
- 地域文化局限：主要面向中文用户与中国传统历法，国际化适用性有限
- Token 安全风险：
HUANGLI_TOKEN需妥善保管，泄露可能导致配额被滥用
适合人群
- 需要查询农历/黄历/择日信息的普通用户
- 开发传统历法相关应用的开发者
- 对民俗文化感兴趣的研究者
- 计划婚嫁、搬家、开业等需"择吉日"的民俗习惯遵循者
常规风险提醒
- 黄历吉凶仅供参考，重大人生决策应结合实际条件理性判断
- 避免过度依赖"吉日"概念导致决策延误
- API 服务稳定性非100%保障，关键场景建议本地缓存备份