- name
- jike-calendar-lunar-query
- description
- 老黄历查询。输入阳历日期和时间，查询农历日期、黄历宜忌、黄黑道、吉神凶煞、生肖、星座、节气、喜神福神财神方位等信息。适用场景：用户说“查一下 2024-02-02 的老黄历”“今天宜忌是什么”“某天适合结婚搬家吗”等。数据由即刻数据（jikeapi.cn）开放接口提供。
- homepage
- https://www.jikeapi.cn/
- metadata
- {"openclaw":{"emoji":"📅","requires":{"bins":["python3"],"env":["JIKE_CALENDAR_LUNAR_QUERY_KEY"]},"primaryEnv":"JIKE_CALENDAR_LUNAR_QUERY_KEY"}}
老黄历查询 - 即刻数据
数据由 即刻数据 提供，帮助 AI 客户端快速接入可靠数据服务。
输入阳历日期和时间，查询：农历日期、黄历宜忌、黄黑道、吉神凶煞、生肖、星座、节气、喜神/福神/财神方位。
前置配置
export JIKE_CALENDAR_LUNAR_QUERY_KEY=你的AppKey
# 或使用通用 Key
export JIKE_APPKEY=你的AppKey使用方法
python3 scripts/calendar_lunar_query.py --date 2024-02-02
python3 scripts/calendar_lunar_query.py --date 2024-02-02 --time 10:30:00
python3 scripts/calendar_lunar_query.py --date 2024-02-02 --time 10:30:00 --json直接调用 API：
GET https://api.jikeapi.cn/v1/calendar/lunar/detail?date=2024-02-02&time=10:30:00&appkey=YOUR_APPKEYAI 使用步骤
- 从用户消息中提取阳历日期，格式化为
YYYY-MM-DD。 - 如果用户提供时间，格式化为
HH:MM:SS；未提供时默认00:00:00。 - 执行
python3 scripts/calendar_lunar_query.py --date <日期> [--time <时间>]。 - 返回农历、宜忌、黄黑道、节气、神位和节日信息。
返回字段
| 字段 | 含义 |
|---|---|
solar_date | 公历日期时间 |
solar_full_string | 公历完整描述 |
lunar_string | 农历日期 |
lunar_full_string | 农历完整描述 |
lunar_day_yi | 当日宜 |
lunar_day_ji | 当日忌 |
lunar_day_tian_shen_type | 黄道/黑道 |
lunar_day_tian_shen_luck | 吉凶 |
lunar_day_position_xi | 喜神方位 |
lunar_day_position_fu | 福神方位 |
lunar_day_position_cai | 财神方位 |
脚本位置
scripts/calendar_lunar_query.py