islamic-companion

Islamic Companion Skill

礼拝時刻、断食スケジュール、ザカート計算のための統合ツールです。

このスキルは、イスラム教関連のユーティリティを、共通設定と効率的なキャッシュ機能を備えた単一の CLI にまとめています。

機能

• 礼拝時刻： 1日の礼拝時刻（Fajr、Dhuhr、Asr、Maghrib、Isha）を取得します。
• 断食： 断食のためのImsakとMaghribの時刻を確認します。
• ザカート： 現在の市場価格に基づいて、金と銀のニサブ基準額を計算します。
• クルアーン： キーワードで節を検索するか、翻訳付きで特定のスーラ／アーヤを取得します。
• カレンダー： 任意の都市について、月単位の礼拝スケジュールを生成します。
• 引用文： ランダムなイスラム教の引用文を取得して表示するか、毎日の自動実行を設定します。
• スケジューラー： 毎日の礼拝リマインダーをスケジュールするOpenClawのcronコマンドを生成します。
• キャッシュ： 取得した日ごとの結果をローカルにキャッシュし、API呼び出しを最小限に抑えます。

使い方

bashスクリプトを使ってCLIを実行します。

# Get today's prayer times for Jakarta (explicit timezone override)
./bin/islamic-companion prayer --today --lat -6.2088 --long 106.8456 --tz Asia/Jakarta

# Setup daily quote automation for specific location
./bin/islamic-companion prayer --sync --lat -6.2088 --long 106.8456 --timezone Asia/Jakarta

# Get a random quote
./bin/islamic-companion quotes --random

# Get monthly calendar (Example: Serang, Banten)
./bin/islamic-companion calendar --city "Serang" --month 2 --year 2026

# Sync prayer schedule to cron (generates commands)
./bin/islamic-companion prayer --sync --lat -6.2088 --long 106.8456 --tz Asia/Jakarta

# Check fasting times (Imsak/Maghrib)
./bin/islamic-companion fasting --today --lat -6.2088 --long 106.8456

# Check Zakat Nisab values
./bin/islamic-companion zakat --nisab

# Search Quran for keyword
./bin/islamic-companion quran --search "sabar"

# Get specific Surah (e.g., Al-Fatihah)
./bin/islamic-companion quran --surah 1

# Get specific Ayah (e.g., Al-Baqarah:255)
./bin/islamic-companion quran --surah 2 --ayah 255

設定

config.jsonを編集して、計算方法とザカートの設定を指定します。場所はCLI引数で指定します。タイムゾーンを指定しない場合、デフォルトはUTCです。

{
  "calculation": {
    "method": 20,
    "school": 0
  },
  "zakat": {
    "currency": "IDR",
    "gold_gram_threshold": 85,
    "api_key": ""
  },
  "timezone": "Asia/Jakarta",
  "quran_language": "id"
}

計算方法

• Method 20： Kemenag RI（インドネシア）
• School 0： 標準（シャーフィイー、マーリキー、ハンバリー）
• School 1： ハナフィー

ユーザーの意図	実行するコマンド
「礼拝時刻を取得」	./bin/islamic-companion prayer --today --lat [LAT] --long [LONG]
「[City]のカレンダーを表示」	./bin/islamic-companion calendar --city [City]
「毎日のイスラム教の引用文を設定」	./bin/islamic-companion quotes --setup
「ランダムなイスラム教の引用文を教えて」	./bin/islamic-companion quotes --random
「礼拝スケジュールを同期」	./bin/islamic-companion prayer --sync
「Imsakは何時？」	./bin/islamic-companion fasting --today
「ザカートのニサブを確認」	./bin/islamic-companion zakat --nisab
「クルアーンから[keyword]を検索」	./bin/islamic-companion quran --search "[keyword]"
「スーラ[Name/Number]を読む」	./bin/islamic-companion quran --surah [Number]
「スーラ[Number]のアーヤ[Number]を読む」	./bin/islamic-companion quran --surah [Number] --ayah [Number]

依存関係

• システム： bash、curl、jq（クルアーン機能に必須。速度向上のため推奨）
• Python（代替実装）： python3、requests（src/main.pyを直接使用する場合のみ必要）

セキュリティとプライバシー

警告

APIキー： ザカート機能ではAPIキーを使用します。config.jsonに保存することも（安全性は低下します）、環境変数ZAKAT_API_KEYとしてエクスポートすることもできます（推奨）。

重要

自動化： --syncおよび--setupコマンドはcronスケジュールを生成します。システムのcrontabに追加する前に、必ず出力を確認してください。

cronツールを使用する場合、CRON_ADD:の出力からJSON文字列を解析し、JSONオブジェクトにする必要があります。文字列をそのまま渡さないでください。

インストール

1. リポジトリをクローンするか、スキルをダウンロードします。
2. Pythonの依存関係をインストールします。

   pip install -r requirements.txt
   

3. curlがインストールされていることを確認します。JSONの解析速度と信頼性を高めるため、jqの使用を推奨します。

設定の読み込みと環境のセットアップを行うbashスクリプトラッパーを使ってCLIを実行します。場所は実行時に指定する必要があります。

今日の礼拝時刻を取得（HTTPSを使用）

./bin/islamic-companion prayer --today --lat -6.2088 --long 106.8456

## Tools

When installing this skill for openclaw, the agent should update `TOOLS.md` to insert these lines:

- Get today's prayer times for Jakarta (explicit timezone override)
    ```
    ~/.openclaw/skills/islamic-companion/bin/islamic-companion prayer --today --lat -6.2088 --long 106.8456 --tz Asia/Jakarta
    ```
- Setup daily quote automation for specific location
    ```
    ~/.openclaw/skills/islamic-companion/bin/islamic-companion prayer --sync --lat -6.2088 --long 106.8456 --timezone Asia/Jakarta
    ```
- Get a random quote
    ```
    ~/.openclaw/skills/islamic-companion/bin/islamic-companion quotes --random
    ```
- Get monthly calendar (Example: Serang, Banten)
    ```
    ~/.openclaw/skills/islamic-companion/bin/islamic-companion calendar --city "Serang" --month 2 --year 2026
    ```
- Sync prayer schedule to cron (generates commands)
    ```
    ~/.openclaw/skills/islamic-companion/bin/islamic-companion prayer --sync --lat -6.2088 --long 106.8456 --tz Asia/Jakarta
    ```
- Check fasting times (Imsak/Maghrib)
    ```
    ~/.openclaw/skills/islamic-companion/bin/islamic-companion fasting --today --lat -6.2088 --long 106.8456
    ```
- Check Zakat Nisab values
    ```
    ~/.openclaw/skills/islamic-companion/bin/islamic-companion zakat --nisab
    ```
- Search Quran for keyword
    ```
    ~/.openclaw/skills/islamic-companion/bin/islamic-companion quran --search "sabar"
    ```
- Get specific Surah (e.g., Al-Fatihah)
    ```
    ~/.openclaw/skills/islamic-companion/bin/islamic-companion quran --surah 1
    ```
- Get specific Ayah (e.g., Al-Baqarah:255)
    ```
    ~/.openclaw/skills/islamic-companion/bin/islamic-companion quran --surah 2 --ayah 255
    ```