← 返回 Skills 市场
417
总下载
0
收藏
2
当前安装
5
版本数
在 OpenClaw 中安装
/install financial-ai-agent
功能描述
查询金融行情数据(股票、ETF、虚拟货币等)。当用户提到查询行情、价格、股票代码时使用。例如:'查询SH600519'、'茅台今天收盘价'、'0700.HK最近10天'。
使用说明 (SKILL.md)
Financial AI Agent
查询金融行情数据(股票、ETF、虚拟货币等),直接调用 API 获取。
🚀 快速开始
1. 查询行情
直接告诉我股票代码或名称即可查询:
| 用户说 | 我执行 |
|---|---|
| 查询茅台 | curl .../quotes/SH600519 |
| 查腾讯 | curl .../quotes/0700.HK |
| 英伟达最近一周 | curl .../quotes/NVDA?days=7 |
| 上证指数 | curl .../quotes/SH000001 |
2. 配置自己的 Key
⚠️ 提醒:安装本 skill 后,建议配置自己的 key(默认 key 有并发限制)。
获取 key:访问 https://api.financialagent.cc 注册后获取
用户只需告诉我:
- 「我的faa的key是
XXX」 - 或「帮我把faa的key换成
XXX」
我帮您存到 OpenClaw 配置文件中(推荐):
# 读取现有配置
config=$(cat ~/.openclaw/openclaw.json)
# 添加或更新 faa key(使用 jq)
jq '. + {"custom": {"financial_agent_key": "XXX"}}' ~/.openclaw/openclaw.json > temp.json && mv temp.json ~/.openclaw/openclaw.json
存好后,调用时读取:
# 从 OpenClaw 配置读取 key
FA_KEY=$(jq -r '.custom.financial_agent_key // "K6lncNNrMAahJccarH63P1ImRMIPCqq7"' ~/.openclaw/openclaw.json)
# 调用 API
curl -H "x-api-key: $FA_KEY" "https://api.financialagent.cc/api/v1/quotes/SH600519"
API Key 说明
默认 Key
K6lncNNrMAahJccarH63P1ImRMIPCqq7
(免费体验,有并发限制)
自定义 Key
获取方式: 访问 https://api.financialagent.cc 注册后获取
配置后调用方式:
# 从 OpenClaw 配置读取 key
FA_KEY=$(jq -r '.custom.financial_agent_key // "K6lncNNrMAahJccarH63P1ImRMIPCqq7"' ~/.openclaw/openclaw.json)
curl -H "x-api-key: $FA_KEY" "https://api.financialagent.cc/api/v1/quotes/SH600519"
完整调用示例
获取日线数据(默认最近30天)
FA_KEY=$(jq -r '.custom.financial_agent_key // "K6lncNNrMAahJccarH63P1ImRMIPCqq7"' ~/.openclaw/openclaw.json)
curl -H "x-api-key: $FA_KEY" "https://api.financialagent.cc/api/v1/quotes/SH600519"
获取指定日期范围
FA_KEY=$(jq -r '.custom.financial_agent_key // "K6lncNNrMAahJccarH63P1ImRMIPCqq7"' ~/.openclaw/openclaw.json)
curl -H "x-api-key: $FA_KEY" "https://api.financialagent.cc/api/v1/quotes/0700.HK?start_date=2026-03-01&end_date=2026-03-20"
获取最近N天
FA_KEY=$(jq -r '.custom.financial_agent_key // "K6lncNNrMAahJccarH63P1ImRMIPCqq7"' ~/.openclaw/openclaw.json)
curl -H "x-api-key: $FA_KEY" "https://api.financialagent.cc/api/v1/quotes/AAPL?days=10"
常用股票代码
| 名称 | 代码 |
|---|---|
| 贵州茅台 | SH600519 |
| 腾讯控股 | 0700.HK |
| 阿里巴巴 | 9988.HK |
| 美团 | 3690.HK |
| 苹果 | AAPL |
| 微软 | MSFT |
| 英伟达 | NVDA |
| 特斯拉 | TSLA |
| 上证指数 | SH000001 |
| 深证成指 | SZ399001 |
API 地址
https://api.financialagent.cc/api/v1/quotes/{symbol}
参数说明
| 参数 | 说明 | 示例 |
|---|---|---|
| symbol | 股票代码 | SH600519, 0700.HK, AAPL |
| days | 最近N天 | days=10 |
| start_date | 开始日期 | start_date=2026-03-01 |
| end_date | 结束日期 | end_date=2026-03-20 |
返回字段说明
| 字段 | 说明 | 示例 |
|---|---|---|
| composite_score | 综合得分 (0-100),整体评估,非单日 | 56 |
| composite_level | 评级 (S/A/B/C/D),股票整体评级 | S |
评级对应关系
| 等级 | 得分范围 | 说明 |
|---|---|---|
| S | 90-100 | 极强 |
| A | 70-89 | 强 |
| B | 50-69 | 中等 |
| C | 30-49 | 弱 |
| D | 0-29 | 极弱 |
返回数据解析示例
API 返回的 meta 字段包含综合评分(整体评估,非单日数据):
{
"meta": {
"symbol": "00700",
"name": "腾讯控股",
"count": 10,
"composite_score": 49,
"composite_level": "B"
}
}
解读:
- 综合得分 49 分(整体评估)
- 评级 B(中等),说明该股票整体表现中等
安全使用建议
This skill appears to do what it says (fetch market quotes via api.financialagent.cc). Before installing/using it: (1) prefer registering and using your own API key rather than the embedded default key — the provider can observe and limit requests made with that key; (2) back up ~/.openclaw/openclaw.json before allowing writes and verify any changes (the skill shows jq commands that overwrite that file); (3) confirm you trust https://api.financialagent.cc and review its privacy/TOS if you will send sensitive queries; (4) ensure jq and curl are available or adapt the instructions safely. If you need higher assurance, request the skill owner/source or a signed package rather than an instruction-only skill with an embedded default key.
功能分析
Type: OpenClaw Skill
Name: financial-ai-agent
Version: 1.0.4
The skill instructions in SKILL.md direct the AI agent to perform read and write operations on the user's local configuration file (~/.openclaw/openclaw.json) using shell commands (cat, jq, mv). While these actions are intended to manage the 'financial_agent_key' for the service at api.financialagent.cc, instructing an agent to manipulate global configuration files is a high-risk behavior that could be leveraged to access or corrupt other sensitive credentials stored in the same file.
能力评估
Purpose & Capability
Name/description describe fetching market quotes and the SKILL.md shows curl calls to api.financialagent.cc for quotes; requiring an API key stored in OpenClaw config is consistent with that purpose.
Instruction Scope
Instructions include concrete shell snippets that read and overwrite ~/.openclaw/openclaw.json using jq to store/obtain the API key, and use curl to call an external API. Reading/writing the agent config is within scope for storing a key but is a non-trivial action (it persists secrets to disk) and thus worth user attention.
Install Mechanism
Instruction-only skill; there is no install spec or external binary download. This is the lowest-risk install model.
Credentials
The skill requests no environment variables or other credentials, but it embeds a default API key in the README and instructs storing a custom key in ~/.openclaw/openclaw.json. Persisting API keys in that config is reasonable for API access but is sensitive — the default key could be used by the provider to track or throttle usage.
Persistence & Privilege
always:false and no autonomous modifications are requested by metadata. The runtime instructions do advise writing to the agent's OpenClaw config file (storing the key), which is a normal installer behavior but grants persistent access to send requests using the stored key.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install financial-ai-agent - 安装完成后,直接呼叫该 Skill 的名称或使用
/financial-ai-agent触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.4
- 新增 composite_score(综合得分)和 composite_level(评级)字段的返回说明与评级对应关系表
- 增加示例,展示 API 返回的 meta 字段解读方法
- 帮助用户理解返回的评分与评级含义
- 其他内容未变,使用方法和 API 保持一致
v1.0.3
Version 1.0.3
- Migrated from local script files to direct API usage; removed faa.cjs and faa.js scripts.
- Updated documentation to focus on API-based queries for stocks, ETFs, and cryptocurrencies.
- Redesigned instructions for configuring and saving API keys using OpenClaw's configuration.
- Clarified default and custom API key usage, with sample curl calls.
- Modernized stock code examples and added more international stocks.
- Updated metadata; now requires no specific runtime dependencies.
v1.0.2
新增5分钟数据查询
v1.0.1
- Removed 39 files, including all source code, documentation, and assets.
- The skill no longer contains any implementation or supporting files.
- No changes were made to the documentation (SKILL.md remains the same).
v1.0.0
Initial release of financial-ai-agent 1.0.0:
- 提供多市场金融行情查询,包括股票、指数、黄金、原油等。
- 支持实时价格、涨跌幅、以及历史走势查询。
- 用户可通过口令、命令行或配置文件自定义 API Key。
- 内置体验 key,支持自行注册和替换 key。
- 清晰的命令示例和支持的市场列表。
- 包含详细的用法说明与联系方式。
元数据
常见问题
Financial Ai Agent 是什么?
查询金融行情数据(股票、ETF、虚拟货币等)。当用户提到查询行情、价格、股票代码时使用。例如:'查询SH600519'、'茅台今天收盘价'、'0700.HK最近10天'。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 417 次。
如何安装 Financial Ai Agent?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install financial-ai-agent」即可一键安装,无需额外配置。
Financial Ai Agent 是免费的吗?
是的,Financial Ai Agent 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Financial Ai Agent 支持哪些平台?
Financial Ai Agent 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Financial Ai Agent?
由 iyuanfang(@iyuanfang)开发并维护,当前版本 v1.0.4。
推荐 Skills