etf-finance

核心用法

ETF Finance Skill 是一款基于 Python 的本地化投资组合管理工具，通过命令行脚本实现完整的持仓管理、盈亏追踪和价格提醒功能。用户可通过 add_position.py 添加持仓记录（代码、买入价、数量、名称），系统自动调用 Yahoo Finance（美股）或腾讯财经（A股）获取实时价格，并计算持仓市值、盈亏金额及收益率。价格提醒功能支持设置上涨/下跌目标价，配合 check_alerts.py 可接入 cron 定时任务实现自动化监控。

显著优点

1. 零成本接入：无需 API Key，直接利用 Yahoo Finance 和腾讯财经的免费数据源
2. 隐私本地化：所有持仓数据以 JSON 格式存储于本地 ~/.clawdbot/etf_investor/，不上传云端
3. 跨市场覆盖：同时支持美股 ETF（SPY、QQQ 等）和中国 A 股基金
4. 自动化友好：脚本化设计便于集成定时任务，适合技术型投资者构建个人工作流

潜在缺点与局限性

• 数据延迟：美股价格存在约15分钟延迟，不适合高频交易决策
• 无推送通知：价格提醒仅本地检查，需主动运行脚本或依赖 cron，无邮件/短信/推送通知
• 功能边界：仅支持基础盈亏计算，无资产配置分析、夏普比率、回撤分析等进阶指标
• 技术门槛：纯命令行操作，无图形界面，对非技术用户不友好

适合人群

• 熟悉命令行的技术型个人投资者
• 需要轻量、免费、本地化方案的长期持仓跟踪者
• 已自建自动化工作流（如 cron、Home Assistant）的高级用户

常规风险

• 数据准确性风险：第三方免费数据源可能存在延迟或偶发错误，建议关键决策前交叉验证
• 本地数据安全：JSON 明文存储，无加密机制，共用设备需注意权限管理
• 无交易功能：纯追踪工具，不提供下单接口，需手动在券商平台执行交易
• 维护依赖：脚本持续运行依赖本地 Python 环境及网络连接，系统更新可能导致依赖断裂

ETF Finance Skill 综合评估

核心功能

ETF Finance Skill 是一款专注于ETF和基金投资组合管理的本地工具，提供完整的持仓管理、实时盈亏计算、价格提醒和行情监控功能。支持美股ETF（如SPY、QQQ、VOO）及A股基金，数据来源覆盖腾讯财经和Yahoo Finance两大权威金融数据平台。

显著优点：
1. 数据主权完全可控 — 所有持仓记录、价格提醒均以JSON格式本地存储（~/.clawdbot/etf_investor/），不上传云端，符合隐私优先原则
2. 功能完整闭环 — 涵盖从添加持仓、批量更新价格、计算收益率到设置双向价格提醒的全流程投资管理需求
3. 零API成本 — 直接调用Yahoo Finance和腾讯财经公开接口，无需申请API Key即可使用
4. 自动化扩展能力 — 支持通过cron定时任务实现自动价格监控，适合构建个人投资信息系统

潜在局限：

• 价格数据存在约15分钟延迟，不适合高频交易场景
• 价格提醒仅为本地检查，无系统推送通知（需手动运行或配置定时任务）
• 依赖外部数据源的稳定性，API变更或限流可能影响核心功能
• 缺乏可视化图表，盈亏分析以纯文本形式呈现

适合人群：

• 注重隐私、不愿将持仓数据上传第三方的长期投资者
• 熟悉命令行操作、习惯本地数据管理的进阶用户
• 需要简单价格追踪和基础盈亏计算的指数基金定投者
• 寻求免费替代方案替代付费投资组合管理工具的用户

常规风险提示：
该工具仅提供数据记录与计算功能，不构成投资建议。Yahoo Finance免费数据存在延迟，重大市场波动期间数据可能滞后；本地JSON文件需定期备份以防丢失；个人开发者维护（T3级别），长期更新保障有限。