mcpField
C
crypto-tracker

crypto-tracker

github.com/sundial-org其他670136 次安装34 周前更新
代码仓库

关于 crypto-tracker

Crypto Tracker 是通过 CoinGecko API 查询加密货币价格并管理价格或涨跌幅提醒的命令行 Skill。它也支持搜索币种，并保存按用户区分的提醒以供定期检查。

主要功能

  1. 01查询一种或多种币的价格
  2. 02查看市值和交易量详情
  3. 03按名称或代码搜索币种
  4. 04设置价格及涨跌幅提醒
  5. 05检查待触发的提醒

适用场景

  1. 01查看指定币种的当前价格
  2. 02通过名称或代码查找币种
  3. 03为价格变化设置阈值
  4. 04定期检查已触发的提醒

安装

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

$npx skills add https://github.com/sundial-org/awesome-openclaw-skills --skill crypto-tracker

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

附带文件data/alerts.jsonscripts/crypto.py

详细介绍

加密货币追踪器

使用免费的 CoinGecko API 追踪加密货币价格、设置价格/百分比提醒并搜索币种（无需 API 密钥）。

快速命令

查询价格
# Single coin
uv run {baseDir}/scripts/crypto.py price bitcoin

# Multiple coins
uv run {baseDir}/scripts/crypto.py price bitcoin ethereum solana

# With more details (market cap, volume)
uv run {baseDir}/scripts/crypto.py price bitcoin --detailed
搜索币种
# Find coin ID by name/symbol
uv run {baseDir}/scripts/crypto.py search doge
uv run {baseDir}/scripts/crypto.py search cardano
管理提醒
# Set price threshold alert
uv run {baseDir}/scripts/crypto.py alert <user_id> bitcoin above 100000
uv run {baseDir}/scripts/crypto.py alert <user_id> ethereum below 3000

# Set percentage change alert (24h)
uv run {baseDir}/scripts/crypto.py alert <user_id> bitcoin change 5    # ±5%
uv run {baseDir}/scripts/crypto.py alert <user_id> solana drop 10      # -10%
uv run {baseDir}/scripts/crypto.py alert <user_id> ethereum rise 15    # +15%

# List user's alerts
uv run {baseDir}/scripts/crypto.py alerts <user_id>

# Remove an alert
uv run {baseDir}/scripts/crypto.py alert-rm <alert_id>

# Check all alerts (for cron/heartbeat)
uv run {baseDir}/scripts/crypto.py check-alerts

币种别名

常用符号会自动解析：

  • btc → bitcoin
  • eth → ethereum
  • sol → solana
  • doge → dogecoin
  • ada → cardano
  • xrp → ripple
  • dot → polkadot
  • matic → polygon
  • link → chainlink
  • avax → avalanche-2
  • ltc → litecoin

提醒类型

类型示例触发条件
abovealert user btc above 100000价格 >= $100,000
belowalert user eth below 3000价格 <= $3,000
changealert user btc change 524 小时涨跌幅 >= ±5%
dropalert user sol drop 1024 小时涨跌幅 <= -10%
risealert user eth rise 1524 小时涨跌幅 >= +15%

Cron 集成

定期检查提醒（例如，每 15 分钟一次）：

uv run {baseDir}/scripts/crypto.py check-alerts --json-output

返回已触发的提醒及用于发送通知的用户 ID。

数据存储

提醒存储在 {baseDir}/data/alerts.json 中，包括：

  • 按用户追踪提醒
  • 重复通知之间的冷却时间（默认：1 小时）
  • 上次触发时间戳

注意事项

  • CoinGecko 免费套餐：约每分钟 10–30 次请求（无需 API 密钥）
  • 支持 15,000 多种币种
  • 使用 --json-output 标志生成机器可读的输出

评论

支持 Markdown