Exchange Rates

核心功能

Exchange Rates 技能通过 Playwright 无头浏览器抓取 XE.com 实时数据，提供全球货币对的中间市场汇率（mid-market rate）。支持基础用法（查询单位汇率）和完整金额换算，自动返回结构化 JSON 数据包含汇率、换算结果、时间戳及来源信息。

显著优点

• 数据源权威：XE.com 是全球知名的汇率参考平台，覆盖 170+ 种货币，数据更新及时
• 操作灵活：支持 ISO 4217 标准三字母货币代码，可处理任意货币对组合
• 双重保障：内置 exchangerate-api.com 备用接口，XE 故障时自动切换
• 输出规范：JSON 结构清晰，包含单位汇率和总换算额，便于二次开发集成

局限性与注意事项

• 时效延迟：浏览器抓取存在 4-5 秒固定开销，非高频实时报价
• 汇率类型：仅提供中间市场汇率，不含银行买入/卖出价差，实际交易可能有 1-3% 偏差
• 依赖外部：需 Browserless CDP 服务及 Playwright 环境，本地部署成本较高
• 场景限制：明确排除加密货币、股票价格等金融资产查询

适合人群

跨境电商务人员、国际旅行者、海外留学生、外贸从业者、需要快速估算货币价值的普通用户。

风险提示

中间市场汇率仅供参考，实际换汇请以银行或支付机构报价为准；脚本依赖外部网页结构，XE.com 界面变更可能导致抓取失效。

核心用法

exchange-rates 是一款汇率查询工具，通过 Playwright 无头浏览器抓取 XE.com 网页数据，并在失败时自动回退至 exchangerate-api.com。用户只需提供标准 ISO 4217 三位货币代码（如 USD、INR、EUR）及可选金额，即可获取实时中间市场汇率（mid-market rate）。

典型调用示例：

node xe-rate.mjs USD INR        # 查询 1 美元兑印度卢比
node xe-rate.mjs EUR USD 500    # 计算 500 欧元兑美元

输出包含：转换金额、单位汇率（1 FROM = X TO）、数据来源时间戳、源标识。

---

显著优点

| 优势 | 说明 |

|------|------|

| **数据源权威** | XE.com 为全球知名外汇数据平台，汇率更新频率高 |

| **自动容灾** | 主源故障时无缝切换至 exchangerate-api.com，保障可用性 |

| **隐私友好** | 仅传输货币代码与金额，不收集用户身份或敏感信息 |

| **输出规范** | JSON 结构化结果，便于集成至自动化工作流 |

| **依赖精简** | 仅依赖 playwright-core，无冗余第三方库 |

---

潜在缺点与局限性

1. 延迟较高：单次查询约 4-5 秒，源于浏览器启动与页面渲染开销
2. 非买卖价：返回的是中间市场汇率，实际银行换汇存在买卖价差（spread）
3. 本地依赖：需预先配置 Browserless/CDP 服务（默认 localhost:7002）
4. T3 来源：个人开发者维护，非企业级 SLA 保障
5. 无历史数据：仅支持当前汇率，无法查询过往走势

---

适合人群

• 跨境电商卖家快速估算收款金额
• 出境旅行者规划预算、记账换算
• 财务人员核对多币种发票
• 开发者集成至自动化报表系统

---

常规风险

| 风险项 | 等级 | 说明 |

|--------|------|------|

| 外部 API 依赖 | 低 | 依赖 XE.com 与 exchangerate-api.com，若服务中断可能影响功能 |

| 汇率波动 | 中 | 金融市场实时变动，查询结果与实际成交可能存在偏差 |

| 本地服务配置 | 低 | Browserless 未启动时将导致查询失败 |

| 来源可信度 | 中 | T3 级别项目，建议关键业务场景结合多方数据源交叉验证 |