← 返回 Skills 市场
iyuanfang

Financial Ai Agent

作者 iyuanfang · GitHub ↗ · v1.0.4 · MIT-0
cross-platform ⚠ suspicious
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install financial-ai-agent
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /financial-ai-agent 触发
  4. 根据 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。 - 清晰的命令示例和支持的市场列表。 - 包含详细的用法说明与联系方式。
元数据
Slug financial-ai-agent
版本 1.0.4
许可证 MIT-0
累计安装 2
当前安装数 2
历史版本数 5
常见问题

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。

💬 留言讨论