Claudinho 是一个独立的开源球迷项目，用于在终端、AI 编程助手状态栏和 MCP 客户端中查看足球比赛的实时比分、赛程和积分榜。它支持世界杯、英超、西甲、欧冠等 13 项赛事，无需 API 密钥或注册。世界杯的 104 场赛程已内置，其他赛事的赛程从数据源读取。项目与 FIFA、任何联合会、联赛、俱乐部或 Anthropic 均无关联，仅显示事实性比赛数据（比分、赛程、积分榜）并使用 emoji 国旗，不包含徽标、队服、转播画面或球员肖像。
主要能力：
- 实时比分、赛程、积分榜、淘汰赛对阵图、比赛详情（进球和红黄牌）。
- 预测市场信号：只读的“谁更被看好”一行，显示市场隐含百分比，来源 Polymarket，仅在存在可靠市场时显示，仅供参考，不构成投注建议。可通过 --no-markets 或 CLAUDINHO_MARKETS=off 关闭。
- 可分享卡片：claudinho share 可生成纯文本比赛卡片、积分榜卡片或淘汰赛对阵图卡片，支持复制到剪贴板。
- 多语言支持：英语、西班牙语、葡萄牙语、法语，可选本地化解说风格（如 ¡GOOOOL!），可通过 --flavor subtle|off 调整。
- 状态栏集成：Claude Code 和 Cursor CLI 状态栏可内联显示实时比分，读取本地微缓存，不阻塞网络。
- 得分感知钩子（Claude Code）：UserPromptSubmit 钩子在比赛期间将实时比分注入模型上下文，非比赛期间零 token 消耗。
- MCP 服务器：提供 10 个只读工具（get_today、get_live、get_match、get_next_fixture、get_standings、get_bracket、get_market_signal、get_share_snippet、get_team、list_competitions）以及 my_team / tournament_today 提示。
使用方式：
- 通过 npx 运行，无需安装。
- 选择关注赛事：claudinho follow premier-league，可固定球队：claudinho follow premier-league --team Arsenal。
- 初始化 Claude Code：claudinho init claude；初始化 Cursor：claudinho init cursor。
- 其他 MCP 客户端（Codex、Claude Desktop、Windsurf、Zed、VS Code）使用标准 stdio 配置。
- CLI 命令包括：today、live、next、table、match <id>、bracket、markets、share、team 等，均支持 --json 和 --tz。
适用场景：
- 在终端或 AI 编程助手状态栏中快速查看比赛信息。
- 在 AI 对话中通过 MCP 获取实时比分。
- 生成可分享的比赛卡片用于群聊。
限制：
- 需要网络获取实时数据（世界杯内置数据可离线使用）。
- 预测市场信号仅供参考，不构成投注建议。
- 部分终端（如 Warp）可能无法正确显示国旗 emoji，工具会自动检测并降级为三字母代码。
- 计划中的桌面通知和 AI 评论员功能尚未发布。
- 数据来源：实时比分来自 ESPN 公共记分板，市场信号来自 Polymarket 公共数据。
