Soccer Cli

核心功能

soccer-cli 是一款面向足球爱好者的命令行工具，通过 API-Football 服务在终端内提供三类核心能力：

| 命令 | 用途 | 示例输出 |

|------|------|----------|

| `scores "<team>"` | 查询指定球队最新比分与赛程 | 比分、进球时间、赛事阶段 |

| `game <id>` | 获取单场比赛详细事件流 | 进球、红黄牌、换人、裁判 |

| `squad <id>` | 查看阵容与球员技术统计 | 出场时间、评分、位置分布 |

显著优点

• 终端原生体验：无需打开浏览器或 App，适合开发者/运维人员多屏工作流
• 结构化数据：YAML/JSON 风格输出，便于配合 jq、grep 做二次处理
• 轻量依赖：仅需 Go 1.18+ 运行时，静态编译后单二进制文件

潜在局限

• 外部 API 依赖：数据质量与可用性完全受制于 API-Football 商业服务稳定性
• 配置门槛：需手动申请并配置 API Key，无内置密钥托管或加密存储
• 功能边界：仅覆盖主流联赛，低级别赛事数据完整性存疑；无实时推送，需主动轮询

适合人群

• 习惯终端环境的足球数据分析师、开发者
• 需要快速集成体育数据至 CI/CD 报告或内部机器人的技术团队
• 追求极简交互、反感广告干扰的硬核球迷

常规风险

• 密钥泄露风险：配置文件以明文 YAML 存储于 ~/.config/，共享设备或误提交至版本控制可能导致 API 滥用
• 隐私与合规：API-Football 为第三方服务，用户请求数据（球队偏好、IP 地理位置）可能被记录，需确认其 GDPR/CCPA 合规性
• 供应链安全：install.sh 脚本直接编译并移动二进制，若源码仓库被篡改存在潜在供应链攻击面

使用建议

建议在隔离环境（容器或专用低权限用户）中运行，定期轮换 API Key，并监控 API-Football 账单防止配额盗刷。

核心用法

soccer-cli 是一款面向足球爱好者的命令行工具，通过调用 API-Football 服务获取实时赛事数据。用户需先申请 API-Football 密钥并配置于本地 YAML 文件，即可在终端快速查询：球队最新比分（scores）、单场比赛详情（game）、以及球员阵容统计（squad）。支持主流联赛与球队名称搜索，返回结果以表格形式呈现，适合开发者在工作流中快速扫览赛况。

显著优点

• 轻量高效：纯 Go 编写，编译后单二进制文件，启动极速，资源占用极低
• 数据权威：背靠 API-Football（api-sports.io），覆盖全球主流联赛，数据实时性强
• 交互友好：使用 cobra 构建子命令体系，viper 管理配置，tablewriter 美化输出，体验接近现代 CLI 标准
• 隐私可控：API 密钥本地存储，除必要赛事请求外无其他数据上传

潜在局限

• 外部依赖重：完全依赖 API-Football 服务，若配额耗尽或服务变更，工具即不可用
• 配置门槛：需自行注册获取 API 密钥，对非技术用户不够友好
• 输入验证不足：球队名称直接拼接 URL，特殊字符可能导致请求异常（已识别风险）
• 依赖管理缺失：无 go.mod 锁定，存在供应链安全风险

适合人群

• 技术背景足球迷，习惯终端操作
• 需在工作间隙快速查分、不愿打开网页/APP 的开发者
• 希望将赛况数据集成到自动化脚本或通知系统的进阶用户

常规风险

| 风险类别 | 说明 |

|---------|------|

| 输入注入 | 球队名含 `&`、`%` 等字符可能破坏 API 请求格式 |

| 供应链安全 | 缺少 go.mod/go.sum，依赖版本不可追溯 |

| API 密钥泄露 | 配置文件若权限设置不当，可能被同机其他用户读取 |

| 服务中断 | 第三方 API 配额限制或停服将直接影响功能 |

安全评级 A 表明代码无恶意行为，但建议用户关注上述中等及以下风险点。