← Back to Skills Marketplace
iyuanfang

Financial Ai Agent

by iyuanfang · GitHub ↗ · v1.0.4 · MIT-0
cross-platform ⚠ suspicious
417
Downloads
0
Stars
2
Active Installs
5
Versions
Install in OpenClaw
/install financial-ai-agent
Description
查询金融行情数据(股票、ETF、虚拟货币等)。当用户提到查询行情、价格、股票代码时使用。例如:'查询SH600519'、'茅台今天收盘价'、'0700.HK最近10天'。
README (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(中等),说明该股票整体表现中等
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install financial-ai-agent
  3. After installation, invoke the skill by name or use /financial-ai-agent
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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。 - 清晰的命令示例和支持的市场列表。 - 包含详细的用法说明与联系方式。
Metadata
Slug financial-ai-agent
Version 1.0.4
License MIT-0
All-time Installs 2
Active Installs 2
Total Versions 5
Frequently Asked Questions

What is Financial Ai Agent?

查询金融行情数据(股票、ETF、虚拟货币等)。当用户提到查询行情、价格、股票代码时使用。例如:'查询SH600519'、'茅台今天收盘价'、'0700.HK最近10天'。 It is an AI Agent Skill for Claude Code / OpenClaw, with 417 downloads so far.

How do I install Financial Ai Agent?

Run "/install financial-ai-agent" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Financial Ai Agent free?

Yes, Financial Ai Agent is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Financial Ai Agent support?

Financial Ai Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Financial Ai Agent?

It is built and maintained by iyuanfang (@iyuanfang); the current version is v1.0.4.

💬 Comments