OI Contest Fetch

en/zh

从多个在线评测平台抓取编程竞赛日程，并导出为 JSON。仓库中还包含一个简单的 PHP 页面，可以读取生成的 JSON 并展示即将到来的比赛。

支持平台

Codeforces
AtCoder
UOJ
Nowcoder

输出文件

运行抓取脚本后，会在仓库根目录写入一个 JSON 文件：

contests_all.json：尚未结束的比赛，包括尚未开始和正在进行中的比赛，以及最近 30 天内已经结束的比赛。

JSON 文件的顶层结构如下。generated_at 是文件写入时的秒级 Unix 时间戳。

{
  "generated_at": 1784550894,
  "contests": [
    {
      "platform": "AtCoder",
      "title": "AtCoder Beginner Contest 468",
      "start_time": 1784980800,
      "end_time": 1784986800,
      "status": "upcoming",
      "url": "https://atcoder.jp/contests/abc468"
    }
  ]
}

比赛记录存放在 contests 数组中。start_time 和 end_time 是秒级 Unix 时间戳。status 可能是以下值之一：

finished：已结束
running：进行中
upcoming：尚未开始

环境要求

Python 3
PHP 5.4 或更新版本，仅在需要使用 server/ 下的页面时需要

Python 依赖：

pip install requests beautifulsoup4

使用方式

在仓库根目录运行抓取脚本：

python fetch_contests.py

成功运行后，脚本会输出类似下面的统计信息：

Total active contests: 13
Total contests finished in last 30 days: 139

网页展示

server/index.php 会读取公开 GitHub Raw 地址中的 contests_all.json，在本地缓存 5 分钟，并渲染带客户端倒计时的即将开始比赛，以及最近已结束的比赛。页面还会读取 JSON 中的 generated_at，按检测到的时区显示最后更新时间。页面会识别浏览器/系统语言和时区，将其同步到 cookie，并在后续加载时用于本地化文案和比赛时间显示。不支持的语言会回退到英语。

如果你自行部署，并且仓库路径或分支发生变化，需要修改 server/index.php 中的这个常量：

define('JSON_URL', 'https://raw.githubusercontent.com/hanyixuanten/OI-contest-fetch/master/contests_all.json');

缓存文件会以 contests_all_cache.json 的名字写在 index.php 同目录下，因此 Web 服务器进程需要拥有 server/ 目录的写入权限。

自动化

一个常见的自动化流程是：

定时运行 python fetch_contests.py。
提交更新后的 JSON 文件。
推送到 GitHub。
让 server/index.php 从 GitHub Raw 读取最新的 contests_all.json。

如果使用 GitHub Actions，请在运行脚本前安装 Python 依赖。

开发说明

AI coding agents 和维护者在修改比赛提供商、输出契约、工作流行为或文档时，应遵循 AGENTS.md。

注意事项

AtCoder 使用 AtCoder Problems API；在需要时会回退解析 AtCoder 官方比赛页面以获取即将开始的比赛。
UOJ 从公开比赛列表页面解析，并读取比赛链接中的 timeanddate 持续时间参数。
Nowcoder 从牛客竞赛 VIP 列表页内嵌的比赛元数据解析。
网络问题或上游 API/页面结构变化，可能会暂时影响抓取到的比赛数量。

3.3 KiB Raw Permalink Blame History