棒球数据分析引擎

一个为德克萨斯长角牛棒球队提供历史数据和实时数据结合分析的TypeScript分析引擎和文档中心,生成三层验证报告服务于球迷、教练、NIL前线办公室和研究人员。

  • by ahump20
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 ahump20/Texas-Longhorns-Baseball-Intelligence

使用说明

得克萨斯长角棒球情报

得克萨斯长角棒球情报

德克萨斯长角棒球情报的TypeScript分析引擎和文档中心。将历史节目原则与BSI制作API的实时数据联系起来,为粉丝、教练、NIL前台和研究人员制作经过验证的三层报告。

计划部署: blazesportsintel.com/college-baseball/exas-intelligence/


建筑

┌─────────────────────────────────────────────────────────────────┐
│                   This Repository                               │
│                                                                 │
│  src/doctrine/      Historical standards, coaching eras         │
│  src/live-data/     MCP client → api.blazesportsintel.com       │
│  src/analytics/     SEC variance, doctrine deviation            │
│  src/validation/    Three-layer report builder                  │
│                                                                 │
│  references/        JSON: championships, philosophy, standards  │
│  data/              Program constants, baselines, media sources │
│  docs/              Architecture, frameworks, audiences         │
│  assets/            Historical images, annual PDF fact books    │
└────────────────────────────┬────────────────────────────────────┘
                             │ MCP fetch calls
                             ▼
            api.blazesportsintel.com
            (Blaze-sports-Intel/college-baseball-api)
            12 MCP tools · 8 MCP resources
            Cloudflare Workers + D1 + KV

模块

src/doctrine/

从以下位置加载并验证历史程序数据 references/*.json。提供:

  • loadDoctrine() --完整的条令记录
  • getNationalTitleCount() --6个标题(1949年、1950年、1975年、1983年、2002年、2005年)
  • getConferenceEra() --当前美国证券交易委员会成员背景
  • getPerformanceStandard() --全国锦标赛标准门槛

src/live-data/

MCP客户端包装对生产API的fetch调用:

  • CollegeBaseballSabermetricsClient --所有12个MCP工具的键入客户端
  • 获取第一个架构 FetchResult/FetchError/FetchOutcome 类型

src/analytics/

  • applySecVarianceAdjustment() --调整SEC竞争的Big 12基线(乘数:1.35)
  • checkDoctrineDeviation() / detectDeviations() --5%/15%/25%的轻微/中等/关键标志
  • generateTeamReport() --生产 ThreeLayerReport 来自live+条令数据

src/validation/

  • buildThreeLayerReport() --收集经过验证的事实→ 系统推理→ 专业推荐
  • validateReport() --确认所有三个层都存在并已填充

快速开始

npm install       # Install dependencies
npm run lint      # Type-check (tsc --noEmit)
npm test          # Run Jest test suite (64 tests, 4 files)
npm run build     # Compile TypeScript → dist/

项目事实

事实 价值
主教练 Jim Schlossnagle(2025年至今)
国家级职称 6(1949年、1950年、1975年、1983年、2002年、2005年)
CWS露面 38
会议 SEC(自2024年以来)
地点 UFCU Disch Falk Field(可容纳7273人)
2025赛季 44胜14负,SEC常规赛冠军,SEC COY
2026年初 12-0开局,Schlossnagle 1000+职业生涯D1获胜

MCP工具(通过api.basesportsintel.com)

工具 目的
cbb_player_lookup 按姓名/球队查找球员
cbb_player_stats 全统计线(击球/投球/防守)
cbb_compare_players 并排比较
cbb_havf_player HAV-F综合得分(0–100)
cbb_team_analytics 团队级高级指标
cbb_leaderboard 按指标排名
cbb_park_factor 场馆调整运行环境
cbb_conference_strength 会议强度评级
cbb_mmi_game 每场比赛的动量/配对指数
cbb_compute_batting 无状态wOBA/wRC+/ISO计算
cbb_compute_pitching 无状态FIP/xFIP计算
cbb_glossary 度量定义和公式

看 docs/data-sources.md 用于完整的输入/输出模式。


相关存储库

Repo 目的 URL
Blaze sports英特尔/大学棒球api 生产MCP服务器 api.blazesportsintel.com
ahump20/college-基线-参数-API 反应仪表板 sabermetrics.blazesportsintel.com

文档

文件 描述
docs/architecture.md 系统设计和数据流
docs/data-sources.md MCP工具、资源、新鲜度、注意事项
docs/audiences.md 球迷、教练、NIL、研究人员的输出路径
docs/analytical-frameworks.md HAV-F、MMI、SEC方差、所有公式
CLAUDE.md 此仓库的代理/复制人说明

许可证

麻省理工学院