mcpField
T
tracking-crypto-prices

tracking-crypto-prices

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

关于 tracking-crypto-prices

Tracking Crypto Prices 是获取加密货币当前及历史价格的技能，适用于需要市场数据的加密货币工作流。它支持观察列表及表格、JSON、CSV 输出，并通过缓存和回退机制处理数据获取问题。

主要功能

  1. 01查询币种当前价格
  2. 02查询预设或自定义观察列表
  3. 03按周期或日期获取历史价格
  4. 04以表格、JSON 或 CSV 导出
  5. 05使用缓存、退避和备用数据

适用场景

  1. 01查看 BTC 和 ETH 当前价格
  2. 02扫描 DeFi 等观察列表
  3. 03导出历史价格用于分析
  4. 04网络异常时使用缓存数据

安装

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

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

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

包含的文件

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

ARD.md
PRD.md
config/
settings.yaml
references/
errors.md
examples.md
implementation.md
scripts/
api_client.py
cache_manager.py
formatters.py
price_tracker.py

详细介绍

跟踪加密货币价格

目录

概述 | 前置条件 | 说明 | 输出 | 错误处理 | 示例 | 资源

概述

基础技能，提供实时和历史加密货币价格数据，覆盖 10,000 多种币种。这是加密货币插件生态系统的数据层——还有 10 多项其他技能依赖它获取价格信息。

前置条件

  1. 安装依赖项：pip install requests pandas yfinance
  2. 可选：安装 pip install python-dotenv 以管理 API 密钥
  3. 可选：从 https://www.coingecko.com/en/api 获取免费 API 密钥，以提高速率限制
  4. 将 API 密钥添加到 ${CLAUDE_SKILL_DIR}/config/settings.yaml，或设置 COINGECKO_API_KEY 环境变量

说明

  1. 查询一个或多个币种的当前价格：

    python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbols BTC,ETH,SOL

  2. 使用关注列表扫描预定义分组（可用分组：top10、defi、layer2、stablecoins、memecoins）：

    python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist top10     # Top 10 by market cap
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist defi      # DeFi tokens
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist layer2    # Layer 2 tokens

  3. 按周期或自定义日期范围获取历史数据：

    python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC --period 30d
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC --period 90d --output csv
python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol ETH --start 2024-01-01 --end 2024-12-31  # 2024 full year

  4. 编辑 ${CLAUDE_SKILL_DIR}/config/settings.yaml 配置设置，自定义缓存 TTL、默认货币和自定义关注列表。完整配置参考请见 references/implementation.md。

输出

  • 表格（默认）：以格式化列显示币种符号、价格、24 小时涨跌幅、交易量和市值
  • JSON（--format json）：包含价格数组和元数据，便于机器读取
  • CSV（--output csv）：将 OHLCV 历史数据导出到 ${CLAUDE_SKILL_DIR}/data/

详细的输出格式示例请见 ${CLAUDE_SKILL_DIR}/references/implementation.md。

错误处理

错误原因解决方案
Unknown symbol: XYZ币种代码无效检查拼写，使用 --list 搜索
Rate limit exceededAPI 调用过多等待 60 秒，或添加 API 密钥以提高限制
Network error无互联网连接检查连接；系统会自动使用缓存数据
Cache stale数据超过 TTL显示警告，并在下次调用时刷新

此技能会自动管理速率限制：优先使用缓存、采用指数退避、回退到 yfinance，最后再使用过期缓存。

示例

快速查询价格：

python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol BTC
# Output: BTC (Bitcoin) $97,234.56 USD +2.34% (24h) | Vol: $28.5B | MCap: $1.92T

扫描关注列表：

python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --watchlist top10

导出历史数据：

python ${CLAUDE_SKILL_DIR}/scripts/price_tracker.py --symbol ETH --period 90d --output csv
# Creates: ${CLAUDE_SKILL_DIR}/data/ETH_90d_[date].csv

资源

  • ${CLAUDE_SKILL_DIR}/references/implementation.md - 输出格式、完整配置、集成指南、文件映射
  • CoinGecko API - 主要数据源
  • yfinance - 历史数据备用来源

评论

支持 Markdown