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

概述

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

核心能力

行情查询

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

数据源策略

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

核心功能执行

用input_params参数进行配置。

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

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

使用场景

场景一：查询最新股价

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

输入格式

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

场景二：获取历史数据

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

# 获取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"

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

快速开始

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

环境准备

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

常用命令

# 查询股票报价
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

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

配置示例

自选股配置

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. 自选股定期维护：定期清理不再关注的标的，保持汇总报告简洁

常见问题

已知限制

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+

第三方依赖

API Key 配置

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

可用性分类

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

错误处理

示例

基本用法

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

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

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

输出格式

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