Sports Trading Card Agent

スポーツカードエージェント

AI エージェントに専門家レベルのスポーツトレーディングカードデータを提供する MCP サーバーです。価格設定、市場分析、裁定取引の検出、グレーディングの ROI、投資アドバイス、選手の成績（NBA／NFL／MLB）、ヴィンテージカード分析、注目選手のアラートを扱います。

9 個のツール。3 種類のスポーツ。40 種以上のヴィンテージセット。手動調査は不要です。

ツール

価格設定と市場

ツール	説明
card_price_lookup	eBay のリアルタイムの販売済み価格と出品中価格を取得します。スポーツ、ブランド、年、グレーディングを問わず対応します。
card_market_analysis	販売済み価格と希望価格を比較してトレンドを分析します。市場価格を下回る価格で出品されているカードを見つけ、裁定取引の機会を検出します。

選手の成績

ツール	説明
player_stats_lookup	複数のスポーツ（NBA／NFL／MLB）の選手成績を、パフォーマンスに基づくカード市場の分析情報とともに取得します。
nfl_stats_lookup	NFL のパス、ラン、レシーブ、ディフェンスの成績を、カード市場の分析情報とともに取得します。
mlb_stats_lookup	MLB の打撃成績（AVG、HR、RBI、OPS）と投手成績（ERA、K、WHIP）を、カードの分析情報とともに取得します。

分析と戦略

ツール	説明
grading_roi_calculator	カードのグレーディングが利益につながるかを計算します。PSA、BGS、SGC の未鑑定カードと鑑定済みカードの価格を比較し、手数料を考慮した ROI を算出します。
card_investment_advisor	3 種すべてのスポーツについて、市場トレンドと選手の成績データを組み合わせて、購入／売却／保有を推奨します。
trending_players	突出した成績を残し、カードの価値が上昇する可能性が高い NBA 選手を特定します。
vintage_card_analysis	2000 年以前のカードを対象に、年代別の分析を行います。1909 T206 から 2000 Playoff Contenders まで、40 種以上の象徴的なセットを、グレード別の価格とともに扱います。

クイックスタート

PyPI からインストール

pip install sports-card-agent

サーバーを起動する

sports-card-agent

Claude Desktop で使う

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "sports-card-agent": {
      "command": "sports-card-agent"
    }
  }
}

Claude Code で使う

.mcp.json に追加します。

{
  "mcpServers": {
    "sports-card-agent": {
      "command": "sports-card-agent"
    }
  }
}

設定

.env ファイルを作成するか、環境変数を設定します。

# eBay API (register free at developer.ebay.com)
EBAY_APP_ID=your_app_id
EBAY_CERT_ID=your_cert_id

# Ball Don't Lie API (register free at app.balldontlie.io)
BALLDONTLIE_API_KEY=your_api_key

サーバーはモックデータを使用するため、API キーがなくても動作し、すぐに試すことができます。

質問の例

接続すると、どの AI エージェントからでも次のような質問ができます。

• 「2023 Topps Chrome Wembanyama のルーキーカードはいくらで売れていますか？」
• 「Patrick Mahomes のルーキーカードは買うべきですか、それとも売るべきですか？」
• 「1986 Fleer Jordan のカードをグレーディングする価値はありますか？」
• 「カードの価値が上昇している、注目の NBA 選手は誰ですか？」
• 「Ken Griffey Jr 1989 Upper Deck のルーキーカードの市場を分析してください」
• 「ヴィンテージの 1952 Topps Mickey Mantle の投資見通しはどうですか？」
• 「今シーズンの Shohei Ohtani の成績はどうですか？それはカードにどのような影響がありますか？」

対象のスポーツとセット

スポーツ： 野球、バスケットボール、アメリカンフットボール、ホッケー、サッカー

選手の成績： NBA（全チーム）、NFL（全ポジション）、MLB（打撃＋投球）

ヴィンテージセットには以下が含まれます： 1909 T206、1933 Goudey、1951 Bowman、1952 Topps、1954-55 Topps、1958 Topps Football、1961 Fleer Basketball、1965 Topps Football、1966 Topps Hockey、1969 Topps、1979 O-Pee-Chee、1981 Topps Football、1984 Topps Football、1986 Fleer Basketball、1986 Donruss、1989 Upper Deck、1993 SP、1996 Topps Chrome、1997 Metal Universe、2000 Playoff Contenders など。

グレーディング会社： PSA、BGS、SGC（現在の価格が設定された全サービス階層）

開発

git clone https://github.com/rjexile/sports-card-agent.git
cd sports-card-agent
python -m venv venv
source venv/Scripts/activate  # Windows
pip install -e .
python test_all.py  # Run all 29 tests

ライセンス

MIT