← Back to Skills Marketplace
jikeapi-cn

人民币汇率查询 - 即刻数据

by jikeapi · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
59
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install jike-cny-exchange-rate
Description
人民币汇率查询。支持外汇牌价币种列表、人民币外汇牌价查询和汇率转换。适用场景:用户说“100美元等于多少人民币”“查一下美元兑人民币汇率”“支持哪些外汇币种”等。数据由即刻数据(jikeapi.cn)开放接口提供。
README (SKILL.md)

人民币汇率查询 - 即刻数据

数据由 即刻数据 提供。即刻数据专注稳定易用的数据 API、MCP 与 AI Skill 能力,帮助开发者和 AI 客户端快速接入可靠数据服务。

支持:外汇币种列表、人民币外汇牌价查询、汇率转换


前置配置:获取 AppKey

export JIKE_CNY_EXCHANGE_RATE_KEY=你的AppKey

也可以使用通用 Key:

export JIKE_APPKEY=你的AppKey

使用方法

查询支持的币种列表

python3 scripts/cny_exchange_rate.py list

查询单个币种人民币牌价

python3 scripts/cny_exchange_rate.py query --currency usd

查询全部币种人民币牌价

python3 scripts/cny_exchange_rate.py query

汇率转换

python3 scripts/cny_exchange_rate.py convert --from-currency usd --to-currency cny --money 100

输出示例:

💱 汇率转换结果

  日期: 2025-11-23
  金额: 712.6900
  说明: 100美元 = 712.6900人民币

直接调用 API

GET https://api.jikeapi.cn/v1/cny_exchange_rate/currenc_list?appkey=YOUR_APPKEY
GET https://api.jikeapi.cn/v1/cny_exchange_rate/query?currency=usd&appkey=YOUR_APPKEY
GET https://api.jikeapi.cn/v1/cny_exchange_rate/convert?from_currency=usd&to_currency=cny&money=100&appkey=YOUR_APPKEY

AI 使用步骤

当用户询问汇率、外汇牌价、金额换算时:

  1. 判断意图:问“支持哪些币种”用 list;问“某币种牌价”用 query;问“多少钱换算”用 convert
  2. 提取参数:识别源币种、目标币种和金额。
  3. 调用脚本:执行对应子命令。
  4. 展示结果:说明汇率日期、转换金额和接口返回描述。

参数说明

子命令 参数 说明 示例
list 查询支持币种 list
query --currency 币种代码,不传返回全部 usd
convert --from-currency 源货币 usd
convert --to-currency 目标货币 cny
convert --money 金额 100

返回字段

字段 含义
currency 货币类型
currency_name 货币名称
spot_buying 现汇买入价
cash_buying 现钞买入价
spot_selling 现汇卖出价
cash_selling 现钞卖出价
money 转换后的金额
desc 转换说明

错误处理

情况 处理方式
未配置 AppKey 提醒用户配置 JIKE_CNY_EXCHANGE_RATE_KEYJIKE_APPKEY
币种不存在 提醒用户先用 list 查询支持币种
金额非法 提醒用户提供大于 0 的数字
网络超时 建议稍后重试或检查网络

脚本位置

scripts/cny_exchange_rate.py:封装了 currenc_listqueryconvert 三个接口的参数校验、请求和展示逻辑。

Usage Guidance
This skill appears to do exactly what it says: call jikeapi.cn to list currencies, return RMB rates, and convert amounts. To be safe: (1) only supply a valid AppKey you trust (set JIKE_CNY_EXCHANGE_RATE_KEY or JIKE_APPKEY); (2) review the script if you have concerns—it reads a local .env in the script directory and will honor a JIKE_API_BASE_URL env override (avoid setting that unless you trust the alternate host); (3) confirm the AppKey's permissions and billing implications with the provider before sharing; (4) because the skill performs network requests, do not provide secrets unrelated to jikeapi (no other credentials are needed). Overall the package is coherent and proportionate to its stated purpose.
Capability Analysis
Type: OpenClaw Skill Name: jike-cny-exchange-rate Version: 1.0.0 The skill is a standard API wrapper for querying RMB exchange rates via the Jike API (jikeapi.cn). The Python script (scripts/cny_exchange_rate.py) uses only standard libraries, implements proper input validation for currency codes and amounts, and handles API keys through environment variables or a local configuration file. No malicious patterns such as data exfiltration, unauthorized execution, or prompt injection were found.
Capability Assessment
Purpose & Capability
Name/description match the implemented functionality: the script calls jikeapi.cn endpoints to list currencies, query rates, and convert amounts. Required binary (python3) and an AppKey are appropriate for this purpose.
Instruction Scope
SKILL.md directs the agent to run the included Python script or call documented API URLs. The script only reads an AppKey (CLI, env, or .env), builds query parameters, and performs HTTP GETs to the API; it does not access other system files, network hosts, or external endpoints beyond the API base URL.
Install Mechanism
No install spec is provided (instruction-only with a script). No downloads or archive extraction occur; the only runtime requirement is python3.
Credentials
Declared primary env JIKE_CNY_EXCHANGE_RATE_KEY is appropriate. The script also accepts a fallback JIKE_APPKEY and honors an optional JIKE_API_BASE_URL override and a local .env file in the script directory; these additional envs are reasonable but not all are listed in the registry metadata—JIKE_API_BASE_URL in particular could redirect requests if intentionally changed.
Persistence & Privilege
Skill is not always-enabled and doesn't modify other skills or system settings. It has no elevated persistence or privileged hooks.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install jike-cny-exchange-rate
  3. After installation, invoke the skill by name or use /jike-cny-exchange-rate
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
初始版本:支持外汇牌价币种列表、人民币牌价查询和汇率转换
Metadata
Slug jike-cny-exchange-rate
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is 人民币汇率查询 - 即刻数据?

人民币汇率查询。支持外汇牌价币种列表、人民币外汇牌价查询和汇率转换。适用场景:用户说“100美元等于多少人民币”“查一下美元兑人民币汇率”“支持哪些外汇币种”等。数据由即刻数据(jikeapi.cn)开放接口提供。 It is an AI Agent Skill for Claude Code / OpenClaw, with 59 downloads so far.

How do I install 人民币汇率查询 - 即刻数据?

Run "/install jike-cny-exchange-rate" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is 人民币汇率查询 - 即刻数据 free?

Yes, 人民币汇率查询 - 即刻数据 is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does 人民币汇率查询 - 即刻数据 support?

人民币汇率查询 - 即刻数据 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created 人民币汇率查询 - 即刻数据?

It is built and maintained by jikeapi (@jikeapi-cn); the current version is v1.0.0.

💬 Comments