核心功能与用法
中国农历黄历吉凶（Zhongguo Nongli Huangli Jixiong）是一款面向AI Agent的中国传统历法查询工具，支持公历转农历、黄历宜忌、吉凶神煞、冲煞等完整信息检索。工具提供三种查询模式：by-date单日查询、batch区间批量查询（支持筛选）、search关键词跨日期检索（如甲子日、搬家等）。
显著优点
- Agent自主认证：配置
HUANGLI_AUTO_AGENT=1后，Agent自动完成token获取，无需用户手动介入 - 多端兼容：支持Python 3.9+或bash+curl环境
- 灵活查询：单日、批量、关键词三种模式覆盖不同场景
- 中文语义友好：内置丰富触发词，自然语言即可激活
潜在局限
- 免费额度仅10个唯一日期/天，超额需手动重置
- 关键词检索为本地筛选，无服务端搜索接口
- 依赖外部API（api.nongli.skill.4glz.com），网络稳定性影响体验
- 需配置
HUANGLI_TOKEN环境变量，首次 setup 存在门槛
适用人群
传统习俗遵循者、择日决策人群（婚嫁、搬家、开业）、文化研究爱好者，以及需集成农历能力的AI Agent开发者。
常规风险
- 429限流时需手动重置，自动化流程可能中断
- 第三方API服务存在可用性依赖
- 黄历内容属传统文化参考，非科学决策依据