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. 01BTCやETHの現在価格を確認
  2. 02DeFiなどのウォッチリストを確認
  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. 任意:API キーを管理する場合は pip install python-dotenv をインストールします
  3. 任意:レート制限を緩和するには、https://www.coingecko.com/en/api から無料の API キーを取得します
  4. API キーを ${CLAUDE_SKILL_DIR}/config/settings.yaml に追加するか、COINGECKO_API_KEY 環境変数を設定します

手順

  1. 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):${CLAUDE_SKILL_DIR}/data/ への OHLCV 過去データのエクスポート

出力形式の詳しい例については、${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 - 過去データのフォールバック

コメント