该技能用于帮助用户安全地管理足球数据提供商的 API 密钥,并了解自身可访问的数据范围。使用前先读取 .nutmeg.user.md;若文件不存在,应提示用户先运行 /nutmeg:init。
主要能力:指导密钥存储与配置。API 密钥绝不应提交到 git。项目级密钥放入 .env(需被 gitignore);系统级密钥使用环境变量;nutmeg 专用配置放入 .nutmeg.credentials.local(需被 gitignore)。添加密钥时应:创建或更新 .env、确认 .gitignore 包含 .env 与 *.local、用最小 API 调用验证密钥有效。
数据访问参考:免费来源包括 StatsBomb 开放数据(GitHub 下载或 statsbombpy,部分赛事事件数据)、FBref 与 Understat(soccerdata 抓取,分别提供赛季聚合与逐场 xG)、ClubElo(HTTP API,无需密钥)、football-data.co.uk(CSV 历史赛果与赔率)、Transfermarkt(网页抓取)。付费/需密钥的有 SportMonks、Opta/Perform、StatsBomb API、Wyscout,对应环境变量约定为 SPORTMONKS_API_TOKEN、OPTA_FEED_TOKEN、STATSBOMB_API_KEY 与 STATSBOMB_API_PASSWORD、WYSCOUT_API_KEY;也可关注 Kaggle、GitHub、data.world 等数据市场并按许可证与时效性筛选。针对“免费能访问什么”的问题,可按用户画像给出方案:初学者从 StatsBomb 开放数据入手;Python 用户安装 statsbombpy 与 soccerdata;R 用户安装 StatsBombR 与 worldfootballR;JS/TS 用户可直接从 GitHub 取 StatsBomb 开放数据 JSON,FBref 需抓取。
限制与警告:抓取网站可能违反服务条款;商业 API 密钥通常禁止再分发数据,须核对许可证;免费层级速率限制可能很低(如 SportMonks 某些方案每日 5 次请求);绝不要打印或记录 API 密钥,应使用 process.env 或等价方式。