# top10.top

> top10.top 是一个每周更新的 Steam 新游发布 Top 10 榜单网站。每周选择不同游戏类别（Action、RPG、Strategy、Indie 等），从 Steam 平台搜索该类别最受关注的 10 款新游生成榜单。网站同时为 AI 模型和人类读者提供优化的数据访问方式。

## 站点结构

- 首页 (/) - 显示本周 Top 10 新游榜单，包含当前周类别和排名
- 历史归档 (/archive.html) - 按周和按类别浏览所有历史榜单
- 类别记录 (/category.html?cat={category}) - 指定类别的所有新游历史记录
- 周榜详情 (/week.html?w={YYYY-WW}) - 指定周的 Top 10 榜单详情
- 关于页面 (/about.html) - 网站介绍和技术说明

## API 端点 (JSON)

所有 API 返回 JSON 格式数据，无需认证：

### 当前周 Top 10
GET /data/api_top10.json
返回当前周的 Top 10 榜单，包含 week_id、category、date_range、games 数组。
每个 game 对象包含: rank, appid, name, developer, publisher, release_date, genres, description, steam_url, header_image, followers, price

### 全部游戏数据库
GET /data/games.json
返回所有追踪的游戏数据，按关注度降序排列。

### 指定周 Top 10
GET /data/weeks/{YYYY-WW}.json
示例: /data/weeks/2026-36.json
返回指定 ISO 周编号的 Top 10 榜单。

### 类别历史记录
GET /data/categories/{category}.json
示例: /data/categories/action.json
返回指定类别下所有游戏的历史记录，按关注度降序排列。
可用类别: action, adventure, casual, indie, rpg, racing, simulation, sports, strategy

### 归档索引
GET /data/archive.json
返回所有历史周榜的索引信息。

### 站点信息
GET /data/site_info.json
返回站点元数据，包括当前周编号、类别、所有类别列表和 API 端点说明。

## 数据结构

### Game 对象
{
    "rank": 1,                          // 排名 (1-10)
    "appid": 3751260,                   // Steam App ID
    "name": "The Blood of Dawnwalker",  // 游戏名称
    "developer": "Rebel Wolves",        // 开发者
    "publisher": "Bandai Namco",       // 发行商
    "release_date": "2026-09-02",       // 发布日期 (ISO 8601)
    "genres": ["Action", "RPG"],        // Steam 类型标签
    "description": "...",              // 游戏简介
    "steam_url": "https://store.steampowered.com/app/3751260/",
    "header_image": "https://cdn.cloudflare.steamstatic.com/steam/apps/3751260/header.jpg",
    "followers": 100242,              // Steam 关注人数
    "price": "$59.99"                  // 价格 (USD)
}

## 每周类别轮换

网站按以下顺序轮换每周类别:
Action -> RPG -> Strategy -> Indie -> Simulation -> Adventure -> Sports -> Casual -> (循环)

## 结构化数据

每个页面包含 Schema.org JSON-LD 结构化数据:
- WebSite: 站点信息
- ItemList: Top 10 游戏列表
- VideoGame: 每个游戏的详细信息
- BreadcrumbList: 面包屑导航

## 数据更新

数据每周通过 /scripts/collect_data.py 脚本更新。
脚本从 Steam Store API 和 upcoming-games-releases.com 采集新游发布数据，
按类别分类后生成 JSON 文件并重新部署到 Cloudflare Pages。

## 联系

数据来源: Steam Store API (https://store.steampowered.com)
部署平台: Cloudflare Pages (https://pages.cloudflare.com)