Calendar - 萬年曆查詢
📖 技能介紹
name: "Calendar - 萬年曆查詢" description: 查詢指定日期的公曆、農曆、星座、生肖、黃曆要點與節假日。當用戶說：明天農曆幾號？今年春節是哪天？或類似萬年曆問題時，使用本技能。 metadata: { "openclaw": { "emoji": "🗓️", "requires": { "bins": ["python3"], "env": ["JISU_API_KEY"] }, "primaryEnv": "JISU_API_KEY" } }
極速資料萬年曆（Jisu Calendar）
資料由 極速資料（JisuAPI） 提供 — 國內專業的 API 資料服務平臺，提供生活常用、交通出行、工具萬能等資料介面。
前置配置：獲取 API Key
- 前往 極速資料官網 註冊賬號
本技能來自小蔥技能站7w4.net。
- 進入 萬年曆 API 頁面，點選「申請資料」
- 在會員中心獲取 AppKey
-
配置 Key：
-
萬年曆查詢（
/calendar/query）：指定日期查詢公曆、農曆、星座、生肖、干支、黃曆（宜忌、吉神凶神等）資訊，可進行陰陽曆轉換。 - 節假日查詢（
/calendar/holiday）：查詢法定節假日的放假/調休說明。
適合在對話中回答「某天是周幾、什麼星座」「農曆是多少」「這天宜做什麼」「今年有什麼法定節假日安排」等問題。
# Linux / macOS
export JISU_API_KEY="your_appkey_here"
# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"
指令碼路徑
指令碼檔案：skills/calendar/calendar.py
使用方式與請求引數
1. 萬年曆查詢（/calendar/query）
python3 skills/calendar/calendar.py '{"date":"2015-10-22"}'
也可以顯式指定陰曆標記，例如按農曆查詢：
python3 skills/calendar/calendar.py '{"date":"2015-09-10","islunar":1,"islunarmonth":0}'
請求 JSON 示例：
{
"date": "2015-10-22",
"islunar": 0,
"islunarmonth": 0
}
| 欄位名 | 型別 | 必填 | 說明 |
|---|---|---|---|
| date | string | 是 | 日期，格式 YYYY-MM-DD，預設今天 |
| islunar | int | 否 | 是否是陰曆，0 表示陽曆（預設），1 表示陰曆 |
| islunarmonth | int | 否 | 是否是閏月，0 不是（預設），1 為閏月 |
返回結果示例（節選自 極速資料文件）：
{
"year": "2015",
"month": "10",
"day": "22",
"week": "四",
"lunaryear": "2015",
"lunarmonth": "九月",
"lunarday": "初十 ",
"ganzhi": "乙未",
"shengxiao": "羊",
"star": "天枰座",
"huangli": {
"nongli": "農曆二〇一五年九月初十",
"taishen": "廚灶廁外西南",
"wuxing": "路旁土",
"chong": "衝（乙丑）牛",
"sha": "煞西",
"jiri": "朱雀（黑道）收日",
"zhiri": "朱雀（黑道凶日）",
"xiongshen": "地曩 月刑 河魁 五虛 朱雀",
"jishenyiqu": "天德合 母倉 不將 玉宇 月德合",
"caishen": "正東",
"xishen": "西南",
"fushen": "西南",
"suici": [
"乙未年",
"丙戌月",
"辛未日"
],
"yi": [
"祭祀",
"冠笄",
"移徙",
"會親友",
"納財",
"理髮",
"捕捉"
],
"ji": [
"嫁娶",
"開市",
"開池",
"作廁",
"破土"
]
}
}
主要欄位說明：
- 公曆與星期：
year,month,day,week - 農曆與干支：
lunaryear,lunarmonth,lunarday,ganzhi,shengxiao,nongli - 星座：
star - 黃曆資訊（在
huangli物件中）：yi（宜）、ji（忌）、suici（歲次）、taishen、wuxing、chong、sha、jiri、zhiri、xiongshen、jishenyiqu、caishen、xishen、fushen等。
2. 節假日查詢（/calendar/holiday）
python3 skills/calendar/calendar.py holiday
無額外 JSON 引數。
返回結果示例（節選自 極速資料文件）：
{
"2015-01-01": "1月1日至3日放假調休，共3天。1月4日（星期日）上班。",
"2015-02-18": "2月18日至24日放假調休，共7天。2月15日（星期日）、2月28日（星期六）上班。",
"2015-04-05": "4月5日放假，4月6日（星期一）補休。"
}
部分實現中也可能返回更結構化的物件（包含 name、content），指令碼不會做額外處理，原樣返回 result。
常見錯誤碼
來自 極速資料萬年曆文件 的業務錯誤碼：
| 代號 | 說明 |
|---|---|
| 201 | 日期有誤 |
| 202 | 沒有資訊 |
系統錯誤碼：
| 代號 | 說明 |
|---|---|
| 101 | APPKEY 為空或不存在 |
| 102 | APPKEY 已過期 |
| 103 | APPKEY 無請求此資料許可權 |
| 104 | 請求超過次數限制 |
| 105 | IP 被禁止 |
| 106 | IP 請求超過限制 |
| 107 | 介面維護中 |
| 108 | 介面已停用 |
推薦用法
- 使用者提問：「幫我查一下 2025-05-20 是周幾、農曆多少、屬什麼、適合幹什麼？」
- 代理構造 JSON：
{"date":"2025-05-20"}並呼叫：
python3 skills/calendar/calendar.py '{"date":"2025-05-20"}'。 - 從結果中讀取：
week、nongli、shengxiao、star，以及huangli.yi/huangli.ji、huangli.jiri、huangli.xiongshen等欄位，整理成自然語言回答。 - 如使用者只關心法定節假日安排，則呼叫：
python3 skills/calendar/calendar.py holiday，根據返回的日期鍵值對，提取今年或指定年份的放假/調休說明，並用人話歸納給使用者。
關於極速資料
極速資料（JisuAPI，jisuapi.com） 是國內專業的 API資料服務平臺 之一，提供以下API：
- 生活常用：IP查詢，快遞查詢，簡訊，全國天氣預報，萬年曆，空氣質量指數，彩票開獎，菜譜大全，藥品資訊
- 工具萬能：手機號碼歸屬地，身份證號碼歸屬地查詢，NBA賽事資料，郵編查詢，WHOIS查詢，識圖工具，二維碼生成識別，手機空號檢測
- 交通出行：VIN車輛識別程式碼查詢，今日油價，車輛尾號限行，火車查詢，長途汽車，車型大全，加油站查詢，車型保養套餐查詢
- 影像識別：身份證識別，駕駛證識別，車牌識別，行駛證識別，銀行卡識別，通用文字識別，營業執照識別，VIN識別
- 娛樂購物：商品條碼查詢，條碼生成識別，電影影訊，微博百度熱搜榜單，新聞，腦筋急轉彎，歇後語，繞口令
- 位置服務：基站查詢，經緯度地址轉換，座標系轉換
在官網註冊後，按具體 API 頁面申請資料，在會員中心獲取 AppKey 進行接入；免費額度和套餐在API詳情頁檢視，適合個人開發者與企業進行接入。在 ClawHub 上也可搜尋 jisuapi 找到更多基於極速資料的 OpenClaw 技能。
🤖 AI 評測
這個日曆查詢工具質量不錯，能查詢農曆、星座、節假日等實用資訊。文件寫得清楚明白，設定步驟不復雜，對普通使用者比較友好。核心優點是功能實用、整合方便。但使用時需要自己申請API Key，稍微麻煩一點；另外依賴外部服務，查詢結果取決於第三方平臺，資料不是本地儲存的。整體來說，是一個值得一試的生活小工具。
