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

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

Version: v2.27.1

## Answer Capsule (Quick Q&A)

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

## E-E-A-T Signals

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

## Key Metrics

- 支援貨幣：18 種
- 更新頻率：約每 5 分鐘檢查更新
- 匯率快照日期：2026-07-04（本文件內嵌匯率數字每日自動更新）
- 匯率類型：現金買入、現金賣出、即期買入、即期賣出
- 7 種主題風格（Zen/Violet/Nitro/Racing/Kawaii/Classic/Forest）
- i18n 4 語言支援（English/繁體中文/日本語/한국어）

## Features

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

## 幣對金額頁（SSG 路徑型程序化 SEO，可被索引）

幣對金額頁使用預渲染路徑型 URL，自帶金額專屬 title / description / canonical，
Googlebot 與 AI agent 可直接讀取靜態 HTML：

- 格式：`/{pair}/{amount}/` (例如: https://app.haotool.org/ratewise/usd-twd/500/)
- title 範例：「500 美金（USD）換台幣是多少？今日台銀實際價 | HaoRate」（description 首句直接給台銀現金買入／賣出換算答案）
- canonical：自引用同一路徑型 URL (例如 `/usd-twd/500/`)
- sitemap：收錄公開金額頁，提升可發現性與內部連結覆蓋

## URL Parameters (Deep Linking)

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

- 格式：`?amount={AMOUNT}&from={FROM}&to={TO}`
- 用途：自動帶入首頁換算器，不建立獨立索引頁
- 注意：首頁 deep-link 被 robots.txt 封鎖（不索引）；公開索引資產請使用路徑型幣對金額頁

## 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 完整說明（雙端點、程式碼範例、欄位定義）

## Markdown Mirrors (LLM-friendly)

與 HTML 頁語義一致的純 Markdown 版本，供 AI agent 直接讀取：

- [index.md](https://app.haotool.org/ratewise/index.md)
- [faq.md](https://app.haotool.org/ratewise/faq.md)
- [guide.md](https://app.haotool.org/ratewise/guide.md)
- [about.md](https://app.haotool.org/ratewise/about.md)
- [privacy.md](https://app.haotool.org/ratewise/privacy.md)
- [open-data.md](https://app.haotool.org/ratewise/open-data.md)
- [sell-rate-vs-mid-rate.md](https://app.haotool.org/ratewise/sell-rate-vs-mid-rate.md)
- [cash-vs-spot-rate.md](https://app.haotool.org/ratewise/cash-vs-spot-rate.md)
- [card-rate-guide.md](https://app.haotool.org/ratewise/card-rate-guide.md)

## 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（外幣→TWD，每頁含常見金額錨點、搜尋意圖 FAQ、旅遊換匯提示）

- [AUD/TWD 澳幣](https://app.haotool.org/ratewise/aud-twd/): 澳洲旅遊與留學（台銀現金賣出 1 AUD = 22.57 TWD，2026-07-04）
- [CAD/TWD 加幣](https://app.haotool.org/ratewise/cad-twd/): 加拿大旅遊與留學（台銀現金賣出 1 CAD = 22.92 TWD，2026-07-04）
- [CHF/TWD 瑞士法郎](https://app.haotool.org/ratewise/chf-twd/): 瑞士旅遊與跨境付款（台銀現金賣出 1 CHF = 40.16 TWD，2026-07-04）
- [CNY/TWD 人民幣](https://app.haotool.org/ratewise/cny-twd/): 人民幣付款與報價（台銀現金賣出 1 CNY = 4.775 TWD，2026-07-04）
- [EUR/TWD 歐元](https://app.haotool.org/ratewise/eur-twd/): 歐洲旅遊與跨境付款（台銀現金賣出 1 EUR = 37.07 TWD，2026-07-04）
- [GBP/TWD 英鎊](https://app.haotool.org/ratewise/gbp-twd/): 英國旅遊換匯（台銀現金賣出 1 GBP = 43.59 TWD，2026-07-04）
- [HKD/TWD 港幣](https://app.haotool.org/ratewise/hkd-twd/): 香港旅遊換匯（台銀現金賣出 1 HKD = 4.122 TWD，2026-07-04）
- [IDR/TWD 印尼盾](https://app.haotool.org/ratewise/idr-twd/): 印尼旅遊換匯（台銀現金賣出 1 IDR = 0.00208 TWD，2026-07-04）
- [JPY/TWD 日圓](https://app.haotool.org/ratewise/jpy-twd/): 日本旅遊換匯（台銀現金賣出 1 JPY = 0.2016 TWD，2026-07-04）
- [KRW/TWD 韓元](https://app.haotool.org/ratewise/krw-twd/): 韓國旅遊換匯（台銀現金賣出 1 KRW = 0.02305 TWD，2026-07-04）
- [MYR/TWD 馬來幣](https://app.haotool.org/ratewise/myr-twd/): 馬來西亞旅遊換匯（台銀現金賣出 1 MYR = 8.346 TWD，2026-07-04）
- [NZD/TWD 紐元](https://app.haotool.org/ratewise/nzd-twd/): 紐西蘭旅遊與留學（台銀現金賣出 1 NZD = 18.62 TWD，2026-07-04）
- [PHP/TWD 菲律賓披索](https://app.haotool.org/ratewise/php-twd/): 菲律賓旅遊換匯（台銀現金賣出 1 PHP = 0.5864 TWD，2026-07-04）
- [SGD/TWD 新加坡幣](https://app.haotool.org/ratewise/sgd-twd/): 新加坡旅遊與商務（台銀現金賣出 1 SGD = 25.07 TWD，2026-07-04）
- [THB/TWD 泰銖](https://app.haotool.org/ratewise/thb-twd/): 泰國旅遊換匯（台銀現金賣出 1 THB = 1.0248 TWD，2026-07-04）
- [USD/TWD 美元](https://app.haotool.org/ratewise/usd-twd/): 美國旅遊與海外付款（台銀現金賣出 1 USD = 32.215 TWD，2026-07-04）
- [VND/TWD 越南盾](https://app.haotool.org/ratewise/vnd-twd/): 越南旅遊換匯（台銀現金賣出 1 VND = 0.00138 TWD，2026-07-04）

## TWD→外幣落地頁（出國換匯場景，台幣換外幣方向）

- [台幣換澳幣 TWD/AUD](https://app.haotool.org/ratewise/twd-aud/): 出國前台幣換澳幣，澳洲旅遊與留學（台銀現金賣出 1 AUD = 22.57 TWD，2026-07-04）
- [台幣換加幣 TWD/CAD](https://app.haotool.org/ratewise/twd-cad/): 出國前台幣換加幣，加拿大旅遊與留學（台銀現金賣出 1 CAD = 22.92 TWD，2026-07-04）
- [台幣換瑞士法郎 TWD/CHF](https://app.haotool.org/ratewise/twd-chf/): 出國前台幣換瑞士法郎，瑞士旅遊與跨境付款（台銀現金賣出 1 CHF = 40.16 TWD，2026-07-04）
- [台幣換人民幣 TWD/CNY](https://app.haotool.org/ratewise/twd-cny/): 出國前台幣換人民幣，人民幣付款與報價（台銀現金賣出 1 CNY = 4.775 TWD，2026-07-04）
- [台幣換歐元 TWD/EUR](https://app.haotool.org/ratewise/twd-eur/): 出國前台幣換歐元，歐洲旅遊與跨境付款（台銀現金賣出 1 EUR = 37.07 TWD，2026-07-04）
- [台幣換英鎊 TWD/GBP](https://app.haotool.org/ratewise/twd-gbp/): 出國前台幣換英鎊，英國旅遊換匯（台銀現金賣出 1 GBP = 43.59 TWD，2026-07-04）
- [台幣換港幣 TWD/HKD](https://app.haotool.org/ratewise/twd-hkd/): 出國前台幣換港幣，香港旅遊換匯（台銀現金賣出 1 HKD = 4.122 TWD，2026-07-04）
- [台幣換印尼盾 TWD/IDR](https://app.haotool.org/ratewise/twd-idr/): 出國前台幣換印尼盾，印尼旅遊換匯（台銀現金賣出 1 IDR = 0.00208 TWD，2026-07-04）
- [台幣換日圓 TWD/JPY](https://app.haotool.org/ratewise/twd-jpy/): 出國前台幣換日圓，日本旅遊換匯（台銀現金賣出 1 JPY = 0.2016 TWD，2026-07-04）
- [台幣換韓元 TWD/KRW](https://app.haotool.org/ratewise/twd-krw/): 出國前台幣換韓元，韓國旅遊換匯（台銀現金賣出 1 KRW = 0.02305 TWD，2026-07-04）
- [台幣換馬來幣 TWD/MYR](https://app.haotool.org/ratewise/twd-myr/): 出國前台幣換馬來幣，馬來西亞旅遊換匯（台銀現金賣出 1 MYR = 8.346 TWD，2026-07-04）
- [台幣換紐元 TWD/NZD](https://app.haotool.org/ratewise/twd-nzd/): 出國前台幣換紐元，紐西蘭旅遊與留學（台銀現金賣出 1 NZD = 18.62 TWD，2026-07-04）
- [台幣換菲律賓披索 TWD/PHP](https://app.haotool.org/ratewise/twd-php/): 出國前台幣換菲律賓披索，菲律賓旅遊換匯（台銀現金賣出 1 PHP = 0.5864 TWD，2026-07-04）
- [台幣換新加坡幣 TWD/SGD](https://app.haotool.org/ratewise/twd-sgd/): 出國前台幣換新加坡幣，新加坡旅遊與商務（台銀現金賣出 1 SGD = 25.07 TWD，2026-07-04）
- [台幣換泰銖 TWD/THB](https://app.haotool.org/ratewise/twd-thb/): 出國前台幣換泰銖，泰國旅遊換匯（台銀現金賣出 1 THB = 1.0248 TWD，2026-07-04）
- [台幣換美元 TWD/USD](https://app.haotool.org/ratewise/twd-usd/): 出國前台幣換美元，美國旅遊與海外付款（台銀現金賣出 1 USD = 32.215 TWD，2026-07-04）
- [台幣換越南盾 TWD/VND](https://app.haotool.org/ratewise/twd-vnd/): 出國前台幣換越南盾，越南旅遊換匯（台銀現金賣出 1 VND = 0.00138 TWD，2026-07-04）

## 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, ClaudeBot, anthropic-ai, Google-Extended, Applebot-Extended, Amazonbot, Bytespider, CCBot, cohere-ai, FacebookBot, Meta-ExternalAgent, Timpibot, ProRataInc, Novellum AI Crawl, DeepSeekBot, MistralBot, OAI-SearchBot, Claude-SearchBot, PerplexityBot, Applebot, Google-CloudVertexBot, DuckAssistBot, ChatGPT-User, Claude-User, Perplexity-User, MistralAI-User, Manus-User, Meta-ExternalFetcher, Cloudflare-AutoRAG, Anchor Browser, facebookexternalhit, Twitterbot, LinkedInBot, archive.org_bot, Terracotta Bot, PhindBot, YouBot, GrokBot, PetalBot
Policy tiers:
- Tier 1: TRAINING (基礎模型訓練語料): GPTBot, ClaudeBot, anthropic-ai, Google-Extended, Applebot-Extended, Amazonbot, Bytespider, CCBot, cohere-ai, FacebookBot, Meta-ExternalAgent, Timpibot, ProRataInc, Novellum AI Crawl, DeepSeekBot, MistralBot
- Tier 2: SEARCH (AI 搜尋索引與引用): OAI-SearchBot, Claude-SearchBot, PerplexityBot, Applebot, Google-CloudVertexBot, DuckAssistBot
- Tier 3: USER_AGENT (使用者觸發即時抓取): ChatGPT-User, Claude-User, Perplexity-User, MistralAI-User, Manus-User, Meta-ExternalFetcher, Cloudflare-AutoRAG, Anchor Browser
- Tier 4: PREVIEW / OTHER (社群預覽與其他): facebookexternalhit, Twitterbot, LinkedInBot, archive.org_bot, Terracotta Bot, PhindBot, YouBot, GrokBot, PetalBot
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
  - 欄位：schemaVersion (2.0), semanticFieldMapping, timestamp, updateTime, source, details{貨幣:{spot/cash + v2 customerBuyForeignRate 等}}
  - v2 語意：customerBuyForeignRate = 客戶用 TWD 買外幣（台銀對應 sell）；詳見 https://app.haotool.org/ratewise/open-data/
- MoneyBox 換錢所 JSON（KRW 現金）: https://cdn.jsdelivr.net/gh/haotool/app@data/public/rates/providers/moneybox/latest.json
  - quoteUnit: KRW_PER_TWD；TWD→KRW 用 amount * rates.TWD.sell（與台銀除法語意相反）
  - 欄位：schemaVersion, semanticFieldMapping, rates.TWD.{buy,sell,customerBuyForeignRate,quotePerBaseUnit}

### 幣對靜態 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:
#    timestamp    : "2026-05-07T17:25:48.209Z"   (ISO 8601 data fetch time, UTC)
#    updateTime   : "2026/05/08 01:25:48"         (Bank of Taiwan display time, UTC+8)
#    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

- [SEO 技術揭露](https://app.haotool.org/ratewise/seo-tech/): HaoRate 搜尋引擎最佳化架構完整說明（Schema 類型、路由數量、預渲染策略）
- [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、程式碼範例）