shekel-currency-converter

シェケル通貨コンバーター

手順

ステップ 1：換算リクエストを確認する

ユーザーのリクエストを解析して、以下を確認します。

• 換算元通貨と換算先通貨（少なくとも一方は NIS/ILS）
• 換算する金額
• 日付（現在の日付または特定の過去の日付。税務上の換算では重要です）
• 目的（一般情報か、税務上の代表レートか）

一般的な通貨コード：

コード	通貨	ヘブライ語
ILS	イスラエル新シェケル	shekel chadash
USD	米ドル	dolar
EUR	ユーロ	euro
GBP	英ポンド	lira sterling
JPY	日本円	yen
CHF	スイスフラン	frank shveitzi

ステップ 2：為替レートを取得する

現在のレート（ライブ JSON エンドポイント）： 従来の XML フィード currency.xml は廃止されました（現在は JSON API にリダイレクトされます）。そのため、XML は解析せず、JSON エンドポイントを取得して exchangeRates 配列を読み取ってください。

Fetch: https://www.boi.org.il/PublicApi/GetExchangeRates
Parse JSON: response.exchangeRates is an array of objects.
Each object: key (currency code), currentExchangeRate (NIS per "unit"),
             unit (1, 10, or 100), currentChange (percent move vs. previous
             publication), lastUpdate (ISO timestamp).

オブジェクトの例：{"key":"USD","currentExchangeRate":2.972,"unit":1,"currentChange":-0.47,"lastUpdate":"2026-08-26T12:22:04Z"}。ここで currentChange は日次変動率（パーセンテージ）であり、NIS の絶対変動額ではありません。また、換算計算には使用しません。

レートの日付は必ず lastUpdate から取得し、システム時計から取得しないでください。「直近に公表されたレート」は「今日のレート」と同じではありません。次の公表分が配信されるまでは、エンドポイントは前回公表されたレートを返すため、その日の公表前に呼び出すと、前営業日のレートが返されます。税務上、シャアール・ヤツィグには日付が紐づいているため、今日の日付を付けると、使用したレートの日付を誤って示すことになります。これは税務換算で絶対に避けなければならない誤りです。レスポンスに lastUpdate がない場合は、日付を一切報告せず、公表日を確認できなかったと伝えてください。

過去の日付／税務上の日付のレート（SDMX シリーズ）： JSON エンドポイントの ?date= パラメーターは無視され、常に直近に公表されたレートが返されます。特定の過去の日付（税務上重要なレート）については、代わりにイスラエル銀行の SDMX EXR シリーズを使用してください。

Fetch: https://edge.boi.gov.il/FusionEdgeServer/sdmx/v2/data/dataflow/BOI.STATISTICS/EXR/1.0/RER_<CUR>_ILS?startPeriod=YYYY-MM-DD&endPeriod=YYYY-MM-DD&format=csv
Replace <CUR> with the currency code (e.g., RER_USD_ILS, RER_EUR_ILS).
Parse CSV: read OBS_VALUE keyed by TIME_PERIOD.

このシリーズには、公表されない日（土曜日、日曜日、祝日）は含まれません。指定日に該当する行がない場合は、その日以前で最も直近に公表された日まで遡り、使用したレートの日付をユーザーに伝えてください。

ステップ 3：換算を計算する

If converting FROM NIS:
  result = amount / rate * unit

If converting TO NIS:
  result = amount * rate / unit

If converting between two foreign currencies:
  nis_amount = amount * rate_source / unit_source
  result = nis_amount / rate_target * unit_target

**2 種類の外貨間の換算は、派生値であり、公表レートではありません。**イスラエル銀行が公表するのは通貨ごとのシェケルレートのみで、それ以外のレートは公表していません。そのため、2 つのシェケルレートを割って求めた USD/EUR レートは、イスラエル銀行によって設定、公表、日付付与されたことはありません。派生値であることを明記し、シャアール・ヤツィグとは決して呼ばないでください。また、税務上の金額については、外貨間で換算するのではなく、それぞれの外貨額を個別の代表レートでシェケルに換算してください。日付指定の外貨間換算で、2 つの換算に異なる公表日のレートを使うことになる場合は、単一の日付を付けず、それぞれの換算を個別に示してください。

一部の低額通貨は、非常に粗い精度で公表されます。レバノンポンドは 10 単位あたり 0.0003 と、有効数字 1 桁で公表されているため、換算額にはおよそプラスマイナス 17％の誤差が生じます。この公表値は公式の代表レートなので、使用しても誤りではありませんが、換算額をアゴラ単位まで正確なものとして示さないでください。

注：イスラエル銀行のレートは、外貨 1 単位（または複数単位）あたりの NIS 額を示します。 例（説明用。最新または日付指定のレートを取得してください）：USD レートが約 2.97、単位が 1 の場合、USD 1 は約 2.97 NIS です。 例（説明用）：JPY レートが約 1.87、単位が 100 の場合、JPY 100 は約 1.87 NIS です。 小額通貨では精度に注意してください。レバノンポンドは小数第 4 位まで表示すると 0.0000 NIS になりますが、換算額自体は正しいため、レートをゼロと報告せず、表示精度を上げてください。

ステップ 4：結果を提示する

結果には、次の情報を含めてください。

• 換算額（NIS は小数点以下 2 桁、その他の通貨は適切な精度）
• 使用した為替レートとその公開日（lastUpdate または SDMX の TIME_PERIOD を参照）。問い合わせ日ではありません。ユーザーが今日のレートを求めていて、今日のレートがまだ公開されていない場合は、前回公開されたレートを今日のレートとして提示せず、まだ公開されていないことを明記してください。
• このスキルは取引向けのレートフィードではなく、銀行やクレジットカードの換算レートでもなく、暗号通貨には対応していません。参考および報告用の代表レートは、営業日に 1 日 1 回公開されます。
• 出典：「イスラエル銀行の代表レート（shaar yatzig）」
• 注意書き：「参考用の代表レートです。実際の銀行レートは異なる場合があります。」

どの日付のレートが適用されるか（税務）

• **外国所得：**所得の発生日／受取日の代表レート。
• **外国経費：**支払日の代表レート。
• **年末再評価：**貸借対照表項目には 12 月 31 日の代表レートを適用します。これは帳簿上の扱いです。帳簿の作成義務がない個人は異なる税制の対象となるため、この基準に基づいて個人の外貨預金の為替差益を申告するよう勧めないでください。
• **外国証券またはその他の外国資産のキャピタルゲイン：**1 つではなく、2 つの異なる日付を使用します。取得日の代表レートで取得費用を換算し、売却日のレートで売却代金を換算してから、2 つのシェケル額を使ってシェケル建ての利益を計算します。外貨建ての純利益を 1 日のレートで換算する方法は別の計算になり、通常は過少な金額となるため、この分野で最もよくある誤りです。
• **外貨建てローン：**残高を年末に一度換算するのではなく、各取引（借入実行、各返済）をその取引日のレートで換算します。事業用ローンの為替差損益は資金調達項目であり、年間の一括調整ではありません。
• 輸入 VAT（商品かサービスかによって異なるため注意）：
  • 輸入品が輸入申告書（rashimon）で通関される場合、課税価格には税関レート（shaar hamekhes）が使われます。これはイスラエル税務当局が毎週公表するもので、代表レートそのものではありません。**算出するのではなく、該当週の公表済み税関レートを税務当局から確認してください。**代表レートへの上乗せ率は一般に 0.5% とされていますが、イスラエル税務当局の為替レートサービスはボットをブロックしており、このスキルでは機械的に検証できません。そのため、上乗せ率から算出した値は未確認として扱い、代わりに公表済みのレートを提示してください。輸入品の VAT レートとして、通常の shaar yatzig を提示してはいけません。
  • 輸入サービス（外国の SaaS や海外の請負業者など、リバースチャージ方式の VAT）の場合、VAT は該当日の通常の BOI 代表レートで計算され、税関による上乗せはありません。税関レートが適用されるのは、rashimon に記載された輸入品のみです。

例

例 1：USD から NIS への簡易換算

ユーザー：「1,000 ドルをシェケルに換算して」 結果：「1,000 USD = X NIS（イスラエル銀行の最新の代表レートを適用。金額を提示する前に、日付が明記されたレートを取得してください）。」

例 2：過去の為替レート

ユーザー：「2026 年 1 月 1 日のドルのレートはいくらでしたか？」 結果：SDMX の RER_USD_ILS 系列を取得します。2026 年 1 月 1 日は非公開日です。その日以前で直近の公開日（最初の 2026 年の観測日は 2026 年 1 月 2 日）を報告し、使用した日付を明記してください。

例 3：税務に関係するレート

ユーザー：「2025 年 12 月の VAT 申告用に EUR のレートが必要です」 結果：SDMX 系列から該当する取引日の代表レートを提示し、税務上の公式レートであることを説明します。輸入 VAT については、週次の税関レートを確認するよう案内してください。

同梱リソース

スクリプト

• scripts/fetch_rates.py - イスラエル銀行の公式代表為替レート（シャアール・ヤツィーグ）を取得し、NIS との通貨換算を行います。現在のレートにはライブ JSON エンドポイントを、過去の日付の検索には SDMX EXR 系列を使用します（公開日の遡及確認を含みます）。取得に失敗した場合はエラーを表示してゼロ以外の終了コードで終了し、実際の換算にサンプルレートを代用することはありません。例示用のサンプル出力は、明示的に --demo フラグを指定した場合のみ利用できます。実行方法：python scripts/fetch_rates.py --help

参考資料

• references/boi-api-guide.md - イスラエル銀行の為替レート API ドキュメントです。ライブ JSON エンドポイントとそのフィールド、SDMX EXR の過去データ系列、更新スケジュール、輸入 VAT の税関レートに関する注意事項が記載されています。API 呼び出しのトラブルシューティングや、レートの公開時期を確認する際に参照してください。
• references/currency-codes.md - 対応する通貨コード、ヘブライ語名、一般的な NIS レートの範囲、単位値を記載しています（JPY など複数単位の通貨では重要です）。ユーザーの通貨指定を解析する場合や、単位ベースの換算を扱う場合に参照してください。

参考リンク

リソース	URL
イスラエル銀行の為替レートページ	https://www.boi.org.il/en/economic-roles/financial-markets/exchange-rates/
ライブ JSON レートエンドポイント	https://www.boi.org.il/PublicApi/GetExchangeRates
イスラエル銀行 SDMX EXR 過去データ系列	https://edge.boi.gov.il/FusionEdgeServer/sdmx/v2/data/dataflow/BOI.STATISTICS/EXR/1.0/RER_USD_ILS

推奨 MCP サーバー

ライブ為替レートデータを利用するには、このスキルと次のサーバーを組み合わせてください。

MCP サーバー	提供内容	インストール
boi-exchange	公開済み通貨のイスラエル銀行公式日次代表レート（シャアール・ヤツィーグ）、過去のレート系列、レート変動の計算、BOI SDMX API による直接の通貨換算を提供します。API キーは不要です。	boi-exchange をインストール

boi-exchange MCP が利用可能な場合は、上記の静的な参考表ではなく、そのツールをリアルタイム換算に使用してください。この MCP は公式代表レート（シャアール・ヤツィーグ）を提供します。これはイスラエルの税法で取引日に適用するよう求められているレートです。

注意点

• 公式の NIS 通貨コードは ILS（ISO 4217）ですが、イスラエルでは一般に「シェケル」または「シェカリム」と呼ばれます。エージェントは「NIS」を有効な通貨コードとして認識できなかったり、1985 年以前の「旧シェケル」（IS）と混同したりすることがあります。
• イスラエル銀行は通貨ごとに 1 日 1 回、代表レートを公表します（個別の買値・売値はありません）。月曜日から木曜日は 15:15 頃、金曜日（および祝日前日）は 12:15 頃に公表されます。土曜日、日曜日、イスラエルの祝日にはレートが設定されません。公表時刻前にエージェントがレートを取得すると、古いレートであることを示さずに、前回公表分のレートが返される場合があります。
• 代表レートがあるのは、イスラエル銀行が公式に公表する通貨のみです（現在は 14 通貨：USD、GBP、JPY、EUR、AUD、CAD、DKK、NOK、ZAR、SEK、CHF、JOD、LBP、EGP）。このスキルは、あらゆる世界の通貨に対応する汎用 FX コンバーターではありません。
• NIS の表記では、シェケル記号を数字の前に置き、千の位にはカンマ、小数点にはピリオドを使用します（例：1,234.56）。エージェントが欧州式表記（1.234,56）を使ったり、記号を数字の後ろに置いたりする場合があります。
• 税務目的の換算では、イスラエルの法律により、ライブの外国為替レートではなく、取引日当日のイスラエル銀行代表レート（シャアール・ヤツィーグ）を使用する必要があります。輸入品の輸入 VAT には、税務当局が公表する週次の税関レートを使用します。輸入サービス（リバースチャージ VAT）には、通常の代表レートを使用します。エージェントが、税務申告に法的に有効でないリアルタイムレートを使うことがあります。

トラブルシューティング

エラー：「指定日のレートを取得できません」

原因：指定日が土曜日、日曜日、イスラエルの祝日、または未来の日付です。 解決策：SDMX 系列から、指定日以前で最も新しい公表日を使用してください。イスラエル銀行は月曜日から木曜日（15:15 頃以降）と金曜日（12:15 頃以降）にレートを公表します。土曜日、日曜日、祝日は公表しません。

エラー：「通貨がサポートされていません」

原因：イスラエル銀行はこの通貨の代表レートを公表していません（対象は掲載されている 14 通貨のみです）。 解決策：換算の中間通貨として USD または EUR を使用することを提案してください。