Codeforces API 查询分析

解决什么

当你需要分析某位选手的 rating 变化曲线、批量拉取某场比赛的提交状态，或按标签筛选特定难度的题库时，通常要手动翻页点击 Codeforces 网页。这个过程在自动化脚本中极易卡壳，原因在于官方 API 有独立的 base path，且认证请求涉及 SHA512 签名与 apiSig 参数计算。本技能将这 18 个端点的调用逻辑（含 16 个公开端点与 2 个需认证的端点）封装为标准化工作流。

工作原理

技能通过分层逻辑处理请求：

• 公开端点：默认使用 WebFetch 直接请求，如 contest.standings 或 user.rating，无需编写额外脚本。
• 认证端点：涉及 user.friends 或 group.isManager 时，触发 scripts/cf_api.py，自动计算签名并拼接参数。
• 领域解读：拉取到的原始数据会被自动翻译为开发者友好的格式，例如将 creationTimeSeconds 转为 YYYY-MM-DD HH:MM，或者根据 Ratings 分段（灰-绿-青-蓝-紫-橙-红）标注用户水平。
• 限流适配：针对 API 每 2 秒 1 次的限制，技能会在连续请求间自动插入等待逻辑，并在遇到 HTTP 429 时执行退避重试。

适用边界与注意点

• 本技能专注于 Codeforces 官方 API，不适用于 AtCoder、洛谷或 LeetCode 等其他平台。
• 在 Claude Code 环境中，若 claude.ai 预检查域名被网络策略拦截，WebFetch 可能无法访问 codeforces.com，此时可切换至 curl 兜底方案。
• 认证功能需持有有效的 apiKey 与 apiSecret，建议通过命令行参数传入而非硬编码，避免安全风险。