Sports Trading Card Agent

体育卡牌 Agent

一个 MCP 服务，为 AI Agent 提供专家级体育交易卡牌数据。涵盖价格、市场分析、套利机会检测、评级投资回报、投资建议、球员数据（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 的未评级与评级后价格，并计算扣除费用后的投资回报率。
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 Agent 都可以提问：

• “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