exchange-rates

name

exchange-rates

description

Fetch live exchange rates between any currency pairs from XE.com. Use when: user asks about currency conversion, exchange rates, forex rates, or converting amounts between currencies (e.g., "USD to INR", "100 EUR in GBP", "what's the dollar rate", "how much is 500 euros"). Don't use when: user asks about stock prices, crypto prices, or financial markets — those are web searches, not currency conversions. Output: JSON with rate, converted amount, and source. Present cleanly with unit rate and total.

Cleanup Review

python scripts/_reset_state.py is an optional cleanup helper for the Exchange Rates (XE.com) skill. It may recursively remove /tmp/skill_build, /var/tmp/skill_output. Show the exact paths first, explain whether they are skill-private temporary paths or user state, and run the cleanup only after the user confirms.

Exchange Rates (XE.com)

Fetch live mid-market exchange rates from XE.com via headless browser.

Usage

node ~/clawd/skills/exchange-rates/scripts/xe-rate.mjs <FROM> <TO> [AMOUNT]

Examples:

node ~/clawd/skills/exchange-rates/scripts/xe-rate.mjs USD INR        # 1 USD → INR
node ~/clawd/skills/exchange-rates/scripts/xe-rate.mjs EUR USD 500    # 500 EUR → USD
node ~/clawd/skills/exchange-rates/scripts/xe-rate.mjs THB INR 1000   # 1000 THB → INR

Output: JSON with amount, from, to, rate, converted, source, timestamp

Response Format

Present results cleanly:

• Show the converted amount prominently
• Include the unit rate (1 FROM = X TO)
• Mention source is XE.com mid-market rate
• For amounts > 1, show both unit rate and total conversion

Notes

• Uses Playwright + Browserless (CDP) to scrape XE.com
• Falls back to exchangerate-api.com if XE fails
• Currency codes: standard 3-letter ISO 4217 (USD, INR, EUR, GBP, THB, JPY, etc.)
• Rates are mid-market (not buy/sell spreads)
• Script takes ~4-5 seconds per lookup (browser overhead)