Finance Toolkit Free

提供股票、ETF、指数和外汇的延迟行情及历史数据查询，支持本地自选股管理和缓存优化，适合日常投资追踪。

行情追踪基础工具（免费版）

概述

本工具为个人投资者提供轻量级的金融市场行情查询能力。支持股票、ETF、指数和外汇的最新报价与历史数据获取，内置本地自选股管理功能。通过缓存机制优化请求频率，适合日常投资追踪使用。

核心能力

行情查询

功能	支持标的	数据频率
最新报价	股票/ETF/指数	延迟约15分钟
外汇汇率	主要货币对	每日更新
历史序列	全部标的	日线数据
自选股	自定义标的列表	手动触发

输入: 用户提供行情查询所需的指令和必要参数。 处理: 解析行情查询的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回行情查询的响应数据,包含状态码、结果和日志。

数据源策略

标的类型	默认数据源	是否需Key	说明
股票/ETF/指数	Yahoo Finance	否	覆盖广，非官方接口
外汇	ExchangeRate-API	否	每日更新一次

输入: 用户提供数据源策略所需的指令和必要参数。 处理: 解析数据源策略的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回数据源策略的响应数据,包含状态码、结果和日志。

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：外汇行情查询工具、支持本地自选股与、历史数据获取、面向个人投资者的、轻量级行情追踪工、支持股票、外汇的实时、报价与历史序列获、内置缓存机制避免、频率限制、适合日常行情查询、个人自选股管理、Use、when、需要数据分析、报表生成、统计洞察、数据可视化时使用、不适用于实时流数、据处理、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：查询最新股价

用户输入："AAPL现在多少钱？"

输入格式

参数名	类型	必填	说明
input	string	是	行情追踪基础工具处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

bash

# 获取苹果公司最新报价
python （请参考skill目录中的脚本文件） AAPL
# ...
# 示例
# AAPL: $178.45 (+1.23%)
# 时间: 2026-07-18 10:30:00
# 数据源: Yahoo Finance

场景二：获取历史数据

用户输入："给我看看VOO最近30天的走势"

bash

# 获取30天历史数据
python （请参考skill目录中的脚本文件） VOO --days 30
# ...
# 输出CSV格式历史数据
# date,open,high,low,close,volume
# 2026-06-19,420.1,422.5,419.8,421.3,1234567
# ...

场景三：自选股管理

用户输入："帮我追踪AAPL、MSFT和USD/ZAR"

bash

# 添加自选股
python （请参考skill目录中的脚本文件） add AAPL MSFT USD/ZAR
# ...
# 查看自选股汇总
python （请参考skill目录中的脚本文件） summary
# ...
# 移除某只股票
python （请参考skill目录中的脚本文件） remove MSFT

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

环境准备

bash

# 创建虚拟环境
python -m venv .venv
# ...
# 激活虚拟环境
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/（请参考skill目录中的脚本文件）
# ...
# 依赖说明
pip install -r requirements.txt

常用命令

bash

# 查询股票报价
python （请参考skill目录中的脚本文件） AAPL
# ...
# 查询指数
python （请参考skill目录中的脚本文件） ^GSPC    # 标普500
# ...
# 查询外汇
python （请参考skill目录中的脚本文件） USD/ZAR
python （请参考skill目录中的脚本文件） EURUSD
python （请参考skill目录中的脚本文件） GBP-JPY
# ...
# 历史数据
python （请参考skill目录中的脚本文件） AAPL --days 30
python （请参考skill目录中的脚本文件） USD/ZAR --days 30
# ...
# 自选股管理
python （请参考skill目录中的脚本文件） add AAPL MSFT USD/ZAR
python （请参考skill目录中的脚本文件） summary

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤。

配置示例

自选股配置

yaml

watchlist:
  stocks:
    - ticker: AAPL
      name: 苹果公司
      note: 长期持有
    - ticker: MSFT
      name: 微软
      note: 云业务关注
  etfs:
    - ticker: VOO
      name: 标普500ETF
  forex:
    - pair: USD/ZAR
      note: 南非兰特
  indices:
    - ticker: ^GSPC
      name: 标普500指数
# ...
cache:
  ttl: 300              # 缓存有效期（秒）
  max_size: 100         # 最大缓存条目

最佳实践

1. 利用缓存：相同标的的重复查询会命中缓存，避免触发频率限制
2. 外汇注意频率：免费外汇数据每日仅更新一次，不适合实时交易
3. 历史数据预取：如需多次分析同一标的，先下载历史数据到本地
4. 自选股定期维护：定期清理不再关注的标的，保持汇总报告简洁

实践要点	说明
查询频率	建议间隔≥30秒，避免被数据源限流
数据验证	Yahoo Finance为非官方接口，重要决策前验证数据
外汇限制	免费外汇数据每日更新，不适合高频场景
缓存管理	定期清理缓存目录，避免占用过多磁盘

常见问题

已知限制

Yahoo Finance为非官方接口，高频请求会被限流。建议：增加查询间隔至60秒以上、启用缓存机制、或升级至PRO版使用多数据源回退策略。

Q2：外汇数据为什么不是实时的？

免费版使用ExchangeRate-API开放接口，每日更新一次。如需实时外汇数据，建议升级至PRO版接入付费数据源。

Q3：支持加密货币查询吗？

免费版对加密货币仅提供有限支持（取决于Yahoo Finance覆盖）。如需专业的加密货币行情，建议使用专用的加密货币工具。

Q4：自选股数据保存在哪里？

自选股列表保存在本地文件中，不会上传至任何服务器。文件位置由配置中的watchlist_path指定。

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• Python版本: 3.8+

第三方依赖

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供
Python	运行时	必需	系统安装或conda环境
yfinance	Python库	必需	pip install yfinance
requests	Python库	必需	pip install requests
pandas	Python库	可选	pip install pandas（数据处理）

API Key 配置

• 免费版无需任何API Key
• 股票/ETF/指数数据通过yfinance免费获取
• 外汇数据通过ExchangeRate-API开放接口免费获取

可用性分类

• 分类: MD+EXEC（Markdown指令+Python脚本执行）
• 说明: 通过Python脚本调用免费数据源API获取行情数据
• 免费版限制: 单数据源、无自动回退、外汇每日更新、不支持加密货币高频数据

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

示例

基本用法

输入：用户提供操作指令和必要参数

输出：返回执行结果,包含操作状态和输出数据

text

用户: 执行核心功能
Skill: 正在执行核心功能...
Skill: 执行完成,结果如下: 操作成功

输出格式

json

{
  "success": true,
  "data": {
    "result": "行情追踪基础工具处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "financekit"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}