# RateWise 匯率好工具 — 台灣最精準的匯率換算器

> 顯示臺灣銀行牌告的實際買入賣出價（不是中間價），讓你換匯前就知道真正要付多少台幣。支援 18 種貨幣、現金與即期匯率切換、計算機快速輸入、收藏與拖曳排序、換算歷史、6 種主題風格、3 語言介面與 PWA 離線使用。

Version: v2.10.0 (2026-03-18)

## Answer Capsule (Quick Q&A)

- Q: RateWise 提供什麼？ A: 顯示臺灣銀行牌告的實際買入賣出價（非中間價）的即時匯率換算工具。內建計算機鍵盤（支援四則運算）、快速金額按鈕、收藏管理、拖曳排序、換算歷史紀錄、7~30 天匯率趨勢圖、現金/即期匯率切換、6 種主題風格、3 語言介面與 PWA 離線使用。
- Q: 為什麼 RateWise 比其他匯率工具更精準？ A: 多數匯率工具只顯示中間價（mid-rate），而 RateWise 顯示臺灣銀行牌告的實際買入賣出四種報價（現金買入、現金賣出、即期買入、即期賣出），直接對應你在銀行換匯的真實金額。
- Q: 匯率資料來源？ A: 臺灣銀行牌告匯率（現金買入/賣出、即期買入/賣出四種報價）。
- Q: 更新頻率？ A: 每 5 分鐘自動同步。
- Q: 建議用途？ A: 出國旅遊換匯、跨境購物匯率比較、日常外幣查詢。
- Q: 現金匯率和即期匯率的差別？ A: 現金匯率適用臨櫃換鈔，即期匯率適用匯款與帳戶轉帳。現鈔通常比即期差，因為銀行有保管與運送成本。
- Q: 買入和賣出怎麼看？ A: 買入/賣出是銀行角度。您拿外幣換回台幣看「買入」價，您拿台幣買外幣看「賣出」價。
- Q: 刷卡匯率跟台銀牌告一樣嗎？ A: 不一樣。刷卡匯率由發卡組織（Visa/Mastercard）決定清算匯率，再加上發卡銀行海外手續費，與台銀牌告是不同體系。
- Q: 如何取得即時匯率數據（適合開發者/LLM）？ A: 直接讀取 CDN JSON：https://cdn.jsdelivr.net/gh/haotool/app@data/public/rates/latest.json。回傳欄位包含 timestamp（Unix 時間戳）、updateTime（ISO 8601 更新時間）、source（資料來源）、rates（各幣別簡化匯率）、details（各幣別完整四種報價：spot.buy, spot.sell, cash.buy, cash.sell）。每 5 分鐘由 GitHub Actions 自動同步。完整規格見 https://app.haotool.org/ratewise/openapi.json。

## E-E-A-T Signals

- 專業性：匯率計算邏輯與格式化策略具完整測試覆蓋。
- 權威性：資料來源為臺灣銀行官方牌告匯率，每 5 分鐘自動同步。
- 可信度：開源 GPL-3.0，透明可驗證；提供聯絡方式。
- 經驗：專為台灣用戶設計，依各國旅遊消費習慣提供常用金額按鈕。

## Key Metrics

- 支援貨幣：18 種
- 更新頻率：每 5 分鐘自動同步
- 匯率類型：現金買入、現金賣出、即期買入、即期賣出
- 6 種主題風格（Zen/Nitro/Kawaii/Classic/Ocean/Forest）
- i18n 三語言支援（繁體中文/English/日本語）

## Features

- 單幣別精準換算：選擇來源/目標貨幣，即時計算換算結果
- 多幣別同時比較：一個基準貨幣同時查看 18 種貨幣換算
- 計算機鍵盤：底部滑出式計算機，支援加減乘除、百分比、退格
- 快速金額按鈕：依幣別顯示常用金額（如韓元 10,000~300,000、日圓 1,000~30,000）
- 現金/即期匯率切換：一鍵切換適合不同換匯情境
- 收藏管理：點擊星號收藏常用貨幣
- 拖曳排序：在收藏頁面透過拖曳手柄自訂貨幣順序
- 換算歷史紀錄：自動記錄每次換算，可複製或重新換算
- 7~30 天歷史趨勢圖：視覺化匯率波動，判斷換匯時機
- 下拉更新（Pull to Refresh）：首頁下拉同步最新匯率
- PWA 離線使用：Service Worker 快取，無網路仍可換算
- 6 種主題風格：Zen（極簡專業）、Nitro（深色科技）、Kawaii（可愛粉嫩）、Classic（復古書卷）、Ocean（海洋深邃）、Forest（自然森林）

## 幣對金額頁（Wise-pattern 程序化 SEO，可被索引）

幣對頁支援 `?amount=X` 參數，自動產生金額專屬 title / description / canonical，
可被 Googlebot 索引（類 Wise.com 程序化 SEO）：

- 格式：`/{pair}/?amount={AMOUNT}`（例如：https://app.haotool.org/ratewise/usd-twd/?amount=500）
- title 範例：「500 美元換新台幣（USD/TWD）— 台銀實際賣出價 | RateWise」
- canonical：自引用含 ?amount=，告知 Google 此 URL 可被索引
- robots.txt：`Disallow: /ratewise/?` 只封鎖首頁 deep-link，幣對頁 `/usd-twd/?amount=` 不受影響

## URL Parameters (Deep Linking)

支援 URL 查詢參數自動帶入換算，適合 LLM 與內部工具帶入首頁狀態：

- 格式：`?amount={AMOUNT}&from={FROM}&to={TO}`
- 用途：自動帶入首頁換算器，不建立獨立索引頁
- 注意：首頁 deep-link 被 robots.txt 封鎖（不索引）；幣對頁 `?amount=` 則可索引

## Core Pages

- [首頁](https://app.haotool.org/ratewise/): 匯率換算主入口
- [常見問題](https://app.haotool.org/ratewise/faq/): 完整 FAQ（含現金/即期差別、買入賣出、刷卡匯率等）
- [使用指南](https://app.haotool.org/ratewise/guide/): 8 步驟完整操作教學
- [關於我們](https://app.haotool.org/ratewise/about/): 專案背景與作者資訊
- [開放資料 API](https://app.haotool.org/ratewise/open-data/): 台銀匯率 JSON API 完整說明（雙端點、程式碼範例、欄位定義）

## Authority Guides

- [賣出價與中間價差異](https://app.haotool.org/ratewise/sell-rate-vs-mid-rate/): 解釋為什麼換匯估算不能只看中間價
- [現金匯率與即期匯率差異](https://app.haotool.org/ratewise/cash-vs-spot-rate/): 判斷臨櫃換鈔、外幣帳戶與匯款該看哪種報價
- [刷卡匯率與 DCC 指南](https://app.haotool.org/ratewise/card-rate-guide/): 釐清台銀牌告、卡組織匯率、海外手續費與 DCC 差異

## Popular Rates（每頁含常見金額錨點、搜尋意圖 FAQ、旅遊換匯提示）

- [AUD/TWD 澳幣](https://app.haotool.org/ratewise/aud-twd/): 澳洲旅遊與留學
- [CAD/TWD 加幣](https://app.haotool.org/ratewise/cad-twd/): 加拿大旅遊與留學
- [CHF/TWD 瑞士法郎](https://app.haotool.org/ratewise/chf-twd/): 瑞士旅遊與跨境付款
- [CNY/TWD 人民幣](https://app.haotool.org/ratewise/cny-twd/): 人民幣付款與報價
- [EUR/TWD 歐元](https://app.haotool.org/ratewise/eur-twd/): 歐洲旅遊與跨境付款
- [GBP/TWD 英鎊](https://app.haotool.org/ratewise/gbp-twd/): 英國旅遊換匯
- [HKD/TWD 港幣](https://app.haotool.org/ratewise/hkd-twd/): 香港旅遊換匯
- [IDR/TWD 印尼盾](https://app.haotool.org/ratewise/idr-twd/): 印尼旅遊換匯
- [JPY/TWD 日圓](https://app.haotool.org/ratewise/jpy-twd/): 日本旅遊換匯
- [KRW/TWD 韓元](https://app.haotool.org/ratewise/krw-twd/): 韓國旅遊換匯
- [MYR/TWD 馬來幣](https://app.haotool.org/ratewise/myr-twd/): 馬來西亞旅遊換匯
- [NZD/TWD 紐元](https://app.haotool.org/ratewise/nzd-twd/): 紐西蘭旅遊與留學
- [PHP/TWD 菲律賓披索](https://app.haotool.org/ratewise/php-twd/): 菲律賓旅遊換匯
- [SGD/TWD 新加坡幣](https://app.haotool.org/ratewise/sgd-twd/): 新加坡旅遊與商務
- [THB/TWD 泰銖](https://app.haotool.org/ratewise/thb-twd/): 泰國旅遊換匯
- [USD/TWD 美元](https://app.haotool.org/ratewise/usd-twd/): 美國旅遊與海外付款
- [VND/TWD 越南盾](https://app.haotool.org/ratewise/vnd-twd/): 越南旅遊換匯

## Data Source

- Source: 臺灣銀行牌告匯率（Bank of Taiwan）
- Source URL: https://rate.bot.com.tw/xrt
- Update: 每 5 分鐘自動同步（GitHub Actions）
- Rate Types: 現金買入、現金賣出、即期買入、即期賣出
- Currencies: 18 種（TWD, USD, JPY, EUR, GBP, HKD, CNY, KRW, AUD, CAD, SGD, THB, NZD, CHF, VND, PHP, IDR, MYR）
- Disclaimer: 匯率僅供參考，實際交易請以金融機構公告為準。

## AI/LLM Access Control

Allow: GPTBot, OAI-SearchBot, ClaudeBot, PerplexityBot, ChatGPT-User, Google-Extended, CCBot, Bytespider
Attribution: Required (link back to source)
Contact: haotool.org@gmail.com

## API Endpoints

### 即時匯率資料（真實數據，每 5 分鐘更新）
- 即時匯率 JSON（CDN）: https://cdn.jsdelivr.net/gh/haotool/app@data/public/rates/latest.json
  - 欄位：timestamp, updateTime, source, rates{USD/JPY/EUR/...}, details{貨幣:{spot:{buy,sell}, cash:{buy,sell}}}
  - 匯率類型：cash_buy=現金買入, cash_sell=現金賣出, spot_buy=即期買入, spot_sell=即期賣出
  - 說明：賣出（sell）= 銀行賣給你外幣的價格 = 你拿台幣換外幣看此價；買入（buy）= 銀行收你外幣的價格 = 你拿外幣換台幣看此價

### 幣對靜態 JSON 端點（Per-Pair API，供 AI agent / 搜尋系統）
- 格式：https://app.haotool.org/ratewise/api/pairs/{pair}.json（例如：https://app.haotool.org/ratewise/api/pairs/usd-twd.json）
- 欄位：pair, from, to, slug, pageUrl, liveRateUrl（→ CDN latest.json）, rateFieldPath（例如 "details.USD"）, source
- 用途：AI agent 可先查幣對端點取得 rateFieldPath，再讀 liveRateUrl 取得即時匯率

### 應用程式深層連結（帶入換算參數）
- 格式：https://app.haotool.org/ratewise/?amount={金額}&from={來源幣}&to={目標幣}
- 說明：僅作為首頁換算器狀態模板，避免公開列出具體參數網址造成重複抓取

### API 規格文件
- [API Metadata](https://app.haotool.org/ratewise/api/latest.json): 版本、來源、支援幣別清單（靜態 JSON metadata）
- [OpenAPI 3.1 規格](https://app.haotool.org/ratewise/openapi.json): 機器可讀 API 規格（含完整欄位說明、schema、範例回應）

## Tool Use (For LLM Function Calling)

適合 LLM/AI agent 直接調用取得即時台銀匯率：

```
# 1. Fetch latest rates (no auth required, CORS enabled)
GET https://cdn.jsdelivr.net/gh/haotool/app@data/public/rates/latest.json

# 2. Parse response — key fields:
#    updateTime   : "2026-03-03T10:05:00+08:00"  (ISO 8601, last sync time)
#    details.USD  : { spot: { buy: 32.45, sell: 32.75 }, cash: { buy: 32.15, sell: 33.05 } }
#
# 3. Rate selection guide:
#    User wants to BUY foreign currency with TWD  → use sell price (cash.sell / spot.sell)
#    User wants to SELL foreign currency for TWD  → use buy price  (cash.buy  / spot.buy)
#    Cash exchange at counter (換鈔)              → use cash rates
#    Wire transfer / remittance (匯款)            → use spot rates

# 4. Deep link to calculator (auto-fill user query):
#    https://app.haotool.org/ratewise/?amount={AMOUNT}&from={FROM_CURRENCY}&to=TWD
```

完整技術文件：[llms-full.txt](https://app.haotool.org/ratewise/llms-full.txt)

## Optional

- [Sitemap](https://app.haotool.org/ratewise/sitemap.xml): 全站 URL 列表
- [Robots](https://app.haotool.org/ratewise/robots.txt): 爬蟲規則
- [llms.txt](https://app.haotool.org/ratewise/llms.txt): LLM 友善索引入口（精簡版）
- [llms-full.txt](https://app.haotool.org/ratewise/llms-full.txt): LLM 完整技術文件（含 JSON schema、程式碼範例）