mcpField
F
fund-assistant

fund-assistant

github.com/xer97その他5427 回インストール37 週間前に更新
リポジトリ

fund-assistant について

fund-assistantは、ファンドの相場確認や保有資産の管理を行うスキルです。照会スクリプトとユーザー別のローカル保有データを組み合わせ、当日損益と保有全体の損益を区別します。

主な機能

  1. 01推定値、詳細、過去の基準価額を照会
  2. 02ファンド検索、保有明細や運用担当者の確認
  3. 03指数と資金フローの確認
  4. 04ユーザー別のローカル保有資産管理
  5. 05保有資産のエクスポートと損益計算

活用シーン

  1. 01場中の推定値や過去の基準価額を確認
  2. 02複数ユーザーのファンド保有状況を記録
  3. 03推定値と取得単価から損益を計算

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/xer97/fund-assistant --skill fund-assistant

インストール後、Claude Code で/fund-assistantを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.gitignore
README.md
references/
api.md
storage.md
scripts/
portfolio.py
fund_api.py

詳細

プロジェクトの README より

基金投资助手

脚本命令

基金 API（scripts/fund_api.py）
python scripts/fund_api.py query 001618,000001   # 查询实时估值
python scripts/fund_api.py search 白酒           # 搜索基金
python scripts/fund_api.py detail 001618         # 基金详情
python scripts/fund_api.py history 001618 y      # 历史净值 (y/3y/6y/n/3n/5n)
python scripts/fund_api.py position 001618       # 持仓明细
python scripts/fund_api.py manager 001618        # 基金经理
python scripts/fund_api.py index                 # 大盘指数
python scripts/fund_api.py flow                  # 资金流向
python scripts/fund_api.py north                 # 北向资金
持仓管理（scripts/portfolio.py）
python scripts/portfolio.py init                 # 初始化数据目录
python scripts/portfolio.py list                 # 查看持仓
python scripts/portfolio.py add 001618 1000 1.5  # 添加持仓（代码 份额 成本）
python scripts/portfolio.py update 001618 shares=1500  # 更新持仓
python scripts/portfolio.py remove 001618        # 删除持仓
python scripts/portfolio.py user 老婆            # 切换用户
python scripts/portfolio.py users                # 列出所有用户
python scripts/portfolio.py export portfolio.json  # 导出持仓
python scripts/portfolio.py import portfolio.json  # 导入持仓

数据存储

位置：.fund-assistant/users/{用户名}/portfolio.json（项目本地目录）

{"funds": [{"code": "001618", "name": "天弘中证食品饮料", "shares": 1000, "cost": 1.5}]}

详细结构：references/storage.md

收益计算

// 当日预估收益（今天赚/亏多少）
dailyGains = (gsz - nav) * shares;
dailyGainsRate = gszzl;  // 直接用API返回的涨跌幅

// 持仓总收益（从买入到现在总共赚/亏多少）
costGains = (gsz - cost) * shares;
costGainsRate = ((gsz - cost) / cost) * 100;

重要区分：

  • 当日收益 = (估算净值 - 昨日净值) × 份额 → 今天赚了多少
  • 持仓收益 = (估算净值 - 成本价) × 份额 → 总共赚了多少

字段说明：

  • nav: 昨日净值（已公布）
  • gsz: 估算净值（盘中实时）
  • gszzl: 估算涨跌幅（%）
  • gztime: 估值更新时间
  • cost: 用户买入成本价

操作流程

用户意图执行步骤
查询基金fund_api.py query {代码} → 解析 JSON 输出
添加持仓portfolio.py add {代码} {份额} {成本}
查看持仓收益portfolio.py list → fund_api.py query {代码列表} → 计算收益
切换用户portfolio.py user {用户名}
查看行情fund_api.py index

API 响应字段

详见 references/api.md

注意事项

  1. 首次使用需运行 portfolio.py init 初始化数据目录
  2. 实时估值使用天天基金接口 http://fundgz.1234567.com.cn/js/{code}.js
  3. 交易时段：9:30-11:30, 13:00-15:00（排除节假日）
  4. QDII基金估值可能延迟，部分新发基金无估值数据

コメント

Markdown 対応