calendar-api

中国暦クエリー

接口盒子 API（API ID：278）に問い合わせて、任意の日付の中国伝統暦（黄暦）に関する詳細な情報を取得します。

実行ルール

依存関係、環境変数、設定を事前に確認せず、ユーザーが要求したコマンドを直接実行してください。問題がある場合は、スクリプトが明確なエラーを出力します。その場合に限り、確認して修正してください。

環境変数

変数	説明
JKHZ_ID	接口盒子（apihz.cn）のユーザー ID
JKHZ_KEY	接口盒子 API キー

スクリプトはこれらの値を ~/.wmyskills/.env（スキル間で共有）から自動的に読み込みます。スクリプトディレクトリに scripts/.env がある場合は、そちらが優先されます。テンプレートとして scripts/.env.example を使用し、既存ファイルを上書きせずに ~/.wmyskills/.env に変数を追加してください。

要件

pip install python-dotenv tzdata

使用方法

スクリプト：scripts/getzdday.py

今日の日付を問い合わせる

python scripts/getzdday.py

特定の日付を問い合わせる

python scripts/getzdday.py 2025-06-05

生の JSON を出力する（デバッグ用）

python scripts/getzdday.py 2025-06-05 --json

出力カテゴリ

スクリプトは、取得したデータを次のカテゴリに分類します。

カテゴリ	フィールド
📆 グレゴリオ暦（公历）	年、月、日、曜日、閏年
🌙 太陰暦（农历）	太陰暦の年、月、日
🎊 祭日（节日）	太陽暦の祭日、太陰暦の祭日
⭐ 星座と十二支（星座与生肖）	星座、中国の十二支、日ごとの十二支
📜 十干十二支（干支）	年・月・日の干支、日の納音
🌿 節気と物候（节气与物候）	節気、説明、物候、数九、三伏
☯ 吉凶（宜忌）	宜、忌、吉神・凶神
🧭 方角（方位）	喜神、財神、福神、貴神の方角
⚠️ 衝と煞（冲煞）	相冲、方角の衝、天神、黄道・黒道
🔢 星と神煞（值星与神煞）	値星（十二値星）、十二神、六曜、月相
🌟 二十八宿（星宿）	二十八宿、動物、吉凶、七曜、四宮、四象
📖 彭祖と胎神（彭祖与胎神）	彭祖百忌、胎神の方角、太歳
📅 仏教・道教暦（佛道历）	仏教暦、道教暦、イスラム暦
📊 その他（其他）	五行（五元素）、ユリウス日、九星、季節

注意事項

• 日付を指定しない場合は今日の日付（Asia/Shanghai タイムゾーン）を使用します
• API の対応年範囲：1800 年から翌年まで
• 整形済みの出力はそのまま表示できます。デバッグには --json を使用してください
• API が返すフィールドは日付によって異なる場合があります。スクリプトは空でないフィールドをすべて動的に表示します
• ユーザーの言語に合わせてください。 出力言語は、ユーザーの質問の言語と必ず一致させてください。ユーザーが中国語で質問した場合は、カテゴリ名と説明をすべて中国語で出力します。英語で質問した場合は、英語で出力します。