mcpField
T
tracking-crypto-portfolio

tracking-crypto-portfolio

github.com/jeremylongshore其他2.9k86 次安装2 天前更新
代码仓库

关于 tracking-crypto-portfolio

用于分析加密货币持仓的技能，可通过 CoinGecko 获取估值，并查看资产配置、盈亏和集中度风险。适合需要快速检查、详细分析或导出投资组合数据的用户。

主要功能

  1. 01获取 CoinGecko 实时估值
  2. 02查看持仓与资产配置
  3. 03跟踪盈亏及周期变化
  4. 04提示集中度风险
  5. 05导出 JSON 或 CSV

适用场景

  1. 01快速查看投资组合总值
  2. 02按配置比例检查各项持仓
  3. 03分析盈亏与集中度风险
  4. 04导出数据用于外部分析或报税

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace --skill tracking-crypto-portfolio

安装后在 Claude Code 中输入/tracking-crypto-portfolio确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

ARD.md
PRD.md
config/
settings.yaml
references/
errors.md
examples.md
implementation.md
scripts/
formatters.py
portfolio_loader.py
portfolio_tracker.py
price_fetcher.py
valuation_engine.py

详细介绍

跟踪加密货币投资组合

概述

通过 CoinGecko 实时估值、配置分析、盈亏跟踪和集中度风险提醒，跟踪加密货币持仓。

先决条件

  1. 已安装 Python 3.8+
  2. 依赖项：pip install requests
  3. 可连接互联网以访问 CoinGecko API
  4. 包含持仓信息的投资组合 JSON 文件（格式参见 references/implementation.md）

说明

  1. 评估用户意图 - 确定需要哪种投资组合视图：

    • 快速查看：总价值和主要持仓
    • 持仓列表：所有头寸的完整明细
    • 详细分析：配置、盈亏、风险标记
    • 导出：供外部工具使用的 JSON 或 CSV

  2. 运行投资组合跟踪器并使用适当的选项：

    # Quick portfolio summary
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json

# Full holdings breakdown
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings

# Detailed analysis with P&L and allocations
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed

  3. 导出结果，供分析工具使用或用于税务申报：

    python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format json --output portfolio_export.json
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format csv --output portfolio.csv

  4. 向用户展示结果：

    • 显著显示投资组合总价值
    • 突出显示 24h 和 7d 的变化
    • 说明配置百分比
    • 标记任何集中度风险（默认情况下，配置比例 > 25% 的头寸）

输出

摘要显示总价值、24h/7d 变化、各资产配置情况，以及超过阈值的头寸的集中度警告：

==============================================================================
  CRYPTO PORTFOLIO TRACKER                          Updated: 2026-01-14 15:30  # 2026 - current year timestamp
==============================================================================

  PORTFOLIO SUMMARY: My Portfolio
------------------------------------------------------------------------------
  Total Value:    $125,450.00 USD
  24h Change:     +$2,540.50 (+2.07%)
  7d Change:      +$8,125.00 (+6.92%)
  Holdings:       8 assets

  TOP HOLDINGS
------------------------------------------------------------------------------
  Coin     Quantity      Price         Value      Alloc   24h
  BTC      0.500     $95,000.00   $47,500.00    37.9%   +2.5%
  ETH      10.000     $3,200.00   $32,000.00    25.5%   +1.8%
  SOL      100.000      $180.00   $18,000.00    14.4%   +4.2%

  WARNING: BTC (37.9%) exceeds 25% threshold

==============================================================================

错误处理

错误原因解决方案
找不到投资组合文件路径无效检查文件路径是否存在
JSON 无效文件格式错误验证 JSON 语法
找不到币种未知符号检查符号拼写，使用标准符号
API 请求受限请求过多等待后重试，或使用缓存

如需全面了解错误处理，请参阅 ${CLAUDE_SKILL_DIR}/references/errors.md。

示例

从快速查看到详细分析和导出的投资组合跟踪工作流：

# Basic portfolio check
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio ~/crypto/holdings.json

# All holdings sorted by allocation
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings --sort allocation

# Detailed analysis with custom 15% threshold
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed --threshold 15

# Export for tax software
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format csv --output tax_export.csv

资源

  • ${CLAUDE_SKILL_DIR}/references/implementation.md - 投资组合文件格式、CLI 选项、配置阈值、JSON 格式
  • ${CLAUDE_SKILL_DIR}/references/errors.md - 全面的错误处理说明
  • ${CLAUDE_SKILL_DIR}/references/examples.md - 详细用法示例
  • CoinGecko API：https://www.coingecko.com/en/api
  • ${CLAUDE_SKILL_DIR}/config/settings.yaml - 配置选项

评论

支持 Markdown