exchange-rates

💱 实时汇率查询与货币转换

对接XE.com权威数据源,支持全球货币实时换算与金额转换,为跨境交易和财务决策提供精准汇率参考。

收藏
3.7k
安装
1.3k
版本
v1.0.1
CLS 安全性认证2026-05-21
点击查看完整报告 >

使用说明

核心用法

Exchange Rates 技能通过 Node.js 脚本调用 Playwright 浏览器自动化工具,从 XE.com 抓取实时中间市场汇率(mid-market rates)。用户可通过命令行指定源货币(FROM)、目标货币(TO)和可选金额(AMOUNT),脚本将返回包含汇率、换算结果、时间戳等信息的结构化 JSON 数据。当 XE.com 不可用时,系统会自动回退至 exchangerate-api.com 作为备用数据源,确保服务的可用性。

显著优点

该技能的最大优势在于数据权威性——XE.com 是全球知名的外汇数据提供商,其中间市场汇率被广泛视为行业标准。技能设计具备良好的容错机制,不仅提供主备双数据源,还内置了输入标准化处理(自动将货币代码转为大写)和错误捕获机制。输出格式规范统一,包含单位汇率和总换算金额,便于直接集成到财务系统或报表中。对于开发者而言,无需申请 API 密钥即可使用(通过网页抓取方式),降低了接入门槛。

潜在缺点与局限性

首先,性能开销较大,由于采用浏览器自动化技术(Playwright + Browserless),单次查询需要 4-5 秒的执行时间,不适合高频实时交易场景。其次,稳定性依赖外部因素:XE.com 网站结构的变化可能导致抓取逻辑失效,且技能硬编码了本地浏览器服务的 WebSocket 连接地址和 token,缺乏灵活性。此外,技能由个人开发者维护(T3 来源),缺乏企业级 SLA 保障和长期维护承诺,代码中也未锁定依赖版本,存在潜在的兼容性风险。

适合的目标群体

该技能适合需要偶尔查询汇率信息的个人用户、财务助理、跨境电商从业者,以及需要在脚本或自动化流程中集成汇率转换功能的开发者。对于不追求毫秒级延迟、能够接受秒级响应的后台数据处理场景尤为适用。同时,适合在本地开发环境或私有部署场景中使用,不建议直接用于面向终端用户的生产环境高并发服务。

使用风险与注意事项

主要风险集中在安全性和稳定性两方面。安全层面,代码中硬编码了包含敏感 token 的 WebSocket URL(ws://localhost:7002?token=...),虽然这是本地服务凭证,但仍不符合安全最佳实践,存在配置泄露风险。稳定性方面,技能强依赖外部网络服务(XE.com)和本地浏览器基础设施,任何一方的不可用都会导致功能中断。此外,网页抓取方式可能违反目标网站的服务条款,存在被封禁 IP 的法律合规风险。建议用户在隔离环境(如 Docker 容器)中运行浏览器服务,并通过环境变量注入配置信息,避免使用硬编码凭证。

安全解读

功能概述

Exchange Rates 是一款基于 XE.com 的实时汇率查询工具,通过 Playwright + Browserless 实现网页抓取,并设有 exchangerate-api.com 作为备用数据源。用户可通过简单的命令行接口查询任意两种货币之间的兑换比例,支持指定金额批量转换。

核心用法

node ~/clawd/skills/exchange-rates/scripts/xe-rate.mjs <FROM> <TO> [AMOUNT]
  • 基础查询USD INR 返回 1 美元兑换多少印度卢比
  • 金额转换EUR USD 500 返回 500 欧元等于多少美元
  • 输出格式:JSON 结构化数据,包含汇率、转换金额、时间戳及数据来源

显著优点

| 优势 | 说明 |
|------|------|
| 数据源权威 | XE.com 是全球知名的外汇数据提供商,采用 mid-market 中市场汇率 |
| 容错机制 | 主源失效时自动 fallback 到 exchangerate-api.com |
| 标准兼容 | 使用 ISO 4217 三字母货币代码,覆盖全球主流货币 |
| 输出友好 | 同时展示单位汇率和总金额,便于核对 |

潜在局限

1. 响应延迟:浏览器开销导致单次查询需 4-5 秒,不适合高频批量调用
2. 网络依赖:完全依赖外部服务可用性,XE.com 反爬虫策略变化可能导致中断

3. 非交易汇率:提供的是中市场参考价,实际银行换汇存在买卖价差

4. 无历史数据:仅支持实时汇率,不提供趋势图表或历史走势

适合人群

  • 跨境网购用户:快速估算海外商品的人民币成本
  • 出境旅行者:行前了解目的地货币购买力
  • 外汇投资者:辅助判断汇率波动方向(需配合专业平台)
  • 跨境电商从业者:多币种定价参考

常规风险提示

  • 汇率数据存在数分钟延迟,大额换汇请以银行柜台实时报价为准
  • 部分小众货币(如某些非洲、大洋洲国家货币)可能覆盖不全
  • 频繁查询可能触发 XE.com 的反爬虫机制,建议合理控制调用频率
  • 工具不提供买入/卖出价,实际交易成本需额外计算点差

安全认证摘要

该 Skill 经 CLS-Certify 扫描获得 B 级(64 分) 认证,主要风险包括:硬编码 Browserless CDP 令牌(本地环境配置)、外部 API 依赖导致的可用性风险,以及缺乏用户数据使用说明。未发现恶意代码或敏感信息窃取行为,建议个人用户放心使用,企业敏感环境需评估网络依赖风险。

exchange-rates 内容

scripts文件夹
手动下载zip · 2.5 kB
xe-rate.mjstext/javascript
请选择文件