中国农历黄历吉凶查询 · 每日吉凶择日
认证方式
方式一（Token 直接使用）
在控制台 https://nongli.skill.4glz.com/dashboard 获取 HUANGLI_TOKEN 后，配置到 AI 工具环境变量中，OpenClaw 自动注入，Agent 持有 token 即可调用 API。
export HUANGLI_TOKEN="your_token_here"
export HUANGLI_BASE="https://api.nongli.skill.4glz.com"
方式二（Agent 自动认证）
当以下环境变量已配置时，Agent 自动完成认证并获取 token：
export HUANGLI_USERNAME="your_username"
export HUANGLI_PASSWORD="your_password"
export HUANGLI_AUTO_AGENT=1
自动执行流程：
- 运行
python3 auth.py login完成身份验证 - 从输出中提取
HUANGLI_TOKEN（已包含在标准输出中） - 使用该 token 调用 toolkit.py 完成黄历查询
提示：auth.py 已包含在本技能包中，位于同一目录。Huangli API 凭证与其他账号体系无关。
用法（统一入口）
# 1) 单日查询
python3 toolkit.py by-date 2027-08-08
# 2) 区间批量查询（支持筛选）
python3 toolkit.py batch 2027-08-01 2027-08-31 --filter 搬家
# 3) 关键词搜索
python3 toolkit.py search 甲子日 --year 2027
何时用哪种模式
by-date：只问一个具体日期batch：比较多天、整周、整月search：关键词跨日期范围检索（甲子日/摩羯座/初一/搬家等）
触发词速查
| 用户说 | 激活原因 |
|---|---|
| 今天黄历/今天宜忌 | 黄历查询 |
| 明天适合搬家吗 | 搬家吉日 |
| 结婚选哪天好 | 结婚吉日 |
| 最近哪些是吉日 | 吉凶择日 |
| 农历黄历/老黄历 | 农历+黄历 |
| 查吉凶/吉凶查询/吉凶判断 | 吉凶 |
| 今天农历 | 农历查询 |
核心功能说明
吉凶查询：判断某日是吉日还是凶日，输出宜忌、神煞、冲煞，适用于搬家、结婚、开业、开工等重大决策的择日。
黄历查询：输入公历日期，返回当日农历日期、黄历宜忌、吉凶神煞、冲煞等完整信息。
农历查询：公历转农历，支持单日查询和批量区间查询。
配额说明
- 默认免费额度：10 个唯一日期/天
- 超额返回429，需登录控制台手动重置，不限重置次数
安装方式
# ClawHub 客户端
clawhub install zhongguo-nongli-huangli-jixiong
# 手动 GitHub 安装（推荐锁定版本）
git clone --depth 1 --filter=blob:none --sparse https://github.com/Leocdchina/huangli-agent-skills?ref=v1.7.0
cd huangli-agent-skills && git sparse-checkout set huangli-toolkit && mv huangli-toolkit zhongguo-nongli-huangli-jixiong