How do I install GitHub Hot Board?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does GitHub Hot Board need an API key?

No required environment variable is listed on this record.

What transport does GitHub Hot Board use?

GitHub Hot Board is reached over HTTP.

When was GitHub Hot Board last checked?

Last checked 2026-11-09. GitHub hot-repo leaderboards: snapshots, movers, rank history. Read-only JSON, hourly batches.

GitHub Hot Board MCP server

GitHub 火线榜 · GitHub Hot Board

English

GitHub 排行榜 · 趋势榜 · 飙升榜(周榜 / 月榜 / 总榜 / 黑马 / 里程碑),中英文双语界面,每 6 小时自动更新:https://git.vaiox.xyz

十个视角的 GitHub 开源热榜。数据只有公开数据一种来源,口径贴在每一页上,中英文双语,站点刷新每 60 秒一次。

本周飙升 Top 10 · 打开完整榜单 →

#	项目	累计 Star	本周新增 Star
1	morluto/rea	392.5k	26.7k
2	Gathin23/cleanyourtv	37.6k	13.7k
3	peach-mitao/peach	12.0k	9.8k
4	cloudflare/security-audit-skill	47.9k	8.5k
5	debpalash/VoiceStudio	89.7k	8.0k
6	Ebony-Vinyl/dsh-our-free-model	44.2k	7.5k
7	Zagitta/gpu-unlock	8.5k	5.6k
8	deepseek-ai/deepseek-harness	262.8k	4.7k
9	stablyai/orca	107.3k	4.6k
10	Nutlope/hallmark	35.2k	4.5k

本月飙升 Top 10 · 打开完整榜单 →

#	项目	累计 Star	本月新增 Star
1	morluto/rea	392.5k	26.7k
2	Gathin23/cleanyourtv	37.6k	13.7k
3	peach-mitao/peach	12.0k	9.8k
4	cloudflare/security-audit-skill	47.9k	8.5k
5	debpalash/VoiceStudio	89.7k	8.0k
6	Ebony-Vinyl/dsh-our-free-model	44.2k	7.5k
7	Zagitta/gpu-unlock	8.5k	5.6k
8	deepseek-ai/deepseek-harness	262.8k	4.7k
9	stablyai/orca	107.3k	4.6k
10	Nutlope/hallmark	35.2k	4.5k

累计 Star Top 10 · 打开完整榜单 →

#	项目	累计 Star	新增
1	codecrafters-io/build-your-own-x	556.5k	—
2	sindresorhus/awesome	525.2k	—
3	public-apis/public-apis	492.5k	—
4	freeCodeCamp/freeCodeCamp	458.0k	—
5	EbookFoundation/free-programming-books	400.2k	—
6	openclaw/openclaw	393.2k	—
7	morluto/rea	392.5k	—
8	donnemartin/system-design-primer	375.7k	—
9	nilbuild/developer-roadmap	370.5k	—
10	jwasham/coding-interview-university	363.4k	—

先说三件不掺假的事:

不伪造数据。榜单页面写的是哪种口径,数出来就是哪种口径;口径失效时页面明示,不悄悄换数。
不碰付费数据。只用 GitHub Search API 和官方 trending 页,不需要任何特殊权限。
不装没有的历史。往日榜从 2026-10-18 起积累,之前的日期不提供。

十个榜

#	榜单	来源	口径
1	总榜 · 史上最强	Search API	累计 Star 降序(排除 fork)
2	周榜 · 本周点火	本站快照自算 + 官方 Trending 周页互证	近 7 天真实星增量降序(自有 6 小时快照差);与官方页重叠者标"官方同款",官方有而本站缺的列"新面孔"
3	月榜 · 本月风潮	本站快照自算 + 官方 Trending 月页互证	同上,月窗口
4	年度新星榜	Search API	今年创建,按累计 Star 排
5	潜力榜 · 本周真涨	本站快照自算	近 7 天真实星增 Top 300(不论新旧),行内附增速百分比;星速层不可用时退旧日均口径并标注
6	黑马榜 · 被雪藏候选	本站快照自算	近 7 天增速百分比 Top 100(同涨 1000 星,500 星仓 +200% 排在 10 万星仓 +1% 前);首日 <10 星剔除
7	被忽视榜 · 活跃冷清	Search API	近 30 天持续 push、Star 100–800,升序
8	黑红榜 · 争议指数	Search API 衍生	(Fork×2 + Issue)÷Star,候选池 = 总榜前 300 中 ≥3000 星者。结构化启发式,不是情感分析
9	Fork 之王	Search API	累计 Fork 降序
10	实时里程碑 · 破星直播	Search API × 4	1k / 10k / 50k / 100k 阈值 ±80 星的冲刺者,前端 60 秒轮询,跨线撒彩带

总榜、周榜、月榜有语言分榜(javascript / typescript / python / go / rust / java / c / c++),URL 形如 /zh/boards/weekly/python。c++ 在路径里写成 /cpp,因为 + 进路径段会在路由匹配层直接死掉——查询时仍用 GitHub 原生语言名,旧链接由 proxy.ts 在路由前 308 归一。

站点语言(16 种)

/en /zh /zh-TW /ja /ko /de /fr /es /pt /it /ru /uk /pl /tr /vi /id,根路径默认进英文(带 Accept-Language 时按浏览器语言挑)。全部 UI 文案逐语种成套(app/[lang]/dict/),SEO 每页带全语 hreflang + canonical,sitemap 覆盖 16 语 × 全榜。

行描述与抽屉 README 按站点语言取仓库自身的本地化版本(切换器解析 + 命名候选两级),读不到就诚实回退仓库原文。描述缓存在 repo_desc 表(仓库粒度),两条填充通道:浏览行为驱动(访客打开哪个语言就近补上,60 秒轮询自动送达)与同步期主动收割(每轮同步尾部按热度序扫描全部榜头仓库,一次拿齐 15 种语言,探测结论 30 天免重试;站点读取路径依旧只查库)。

The site ships in 16 languages (default English). UI copy is fully translated per locale; row descriptions and the in-drawer README follow the repo's own localized files when available, falling back to the original text. Descriptions are cached per repo (repo_desc) and filled two ways — on demand by visitors, and proactively at the tail of every sync run (one sweep per repo covers all 15 locales; resolved probes are skipped for 30 days). The serving path always reads from the database only.

数据架构

一句话:卖货的通道不进货。

GitHub ──(只有同步任务碰)──> Postgres(Neon 或自托管)──(站点只 SELECT)──> 访客

同步任务(lib/sync.ts)顺序抓全部 34 个键(10 榜 + 语言分面),写两张表:
- board_head:每个键的最新一拍,站点读它。插新的,前拍自然被覆盖。
- board_snapshots:逐仓逐名次的明细行,本次同步是历史事实的存档。
触发方式:npm run sync(本地,需站点在跑)、POST /api/sync(带 CRON_SECRET)、 GitHub Actions 每 6 小时一轮(.github/workflows/sync.yml)。
站点渲染路径对 GitHub 零请求。降级链:数据库 → 磁盘快照(本地 .data/,重建时不打 GitHub)→ 现场拉取。同步停太久时数据会旧,但不会假。
Trending 页被风控挡住时,周榜/月榜内部自行换到 Search 口径补命,页面上如实标注,不糊弄。

往日榜

每次同步把完整榜单拍进 board_snapshots,所以任意一天切任意名字都能回看:

/zh/history/overall/2026-10-19

入口在 footer(往日榜 → 总榜)。历史拍只存排名、仓库和数字,不存实时简介;数据保留 SNAPSHOT_RETENTION_DAYS(默认 60 天)。页面 noindex,属工具页,不在 sitemap 里占道。

本地跑起来

npm install
cp .env.example .env.local
# 填 GITHUB_TOKEN / NEXT_PUBLIC_SITE_URL / DATABASE_URL(见下表)
npm run dev

环境变量	必填?	说明
`GITHUB_TOKENS`	可选	多账号池:`GITHUB_TOKENS=ghp_a,ghp_b,ghp_c`(逗号/空白分隔),一枚烧完自动换下一枚,取数节奏随池子规模等比放宽;不填则回落单枚 `GITHUB_TOKEN`,都没有走匿名降速
`GITHUB_TOKEN`	建议填	classic PAT(不勾任何权限)或多枚时令其作为单枚兜底。Search API 从 60 次/时升到 5000 次/时
`NEXT_PUBLIC_SITE_URL`	部署时填	canonical / sitemap / OG 用的最终域名
`DATABASE_URL`	部署时填	Neon Postgres 连接串。表首次写入时自动建
`CRON_SECRET`	部署必填	`/api/sync` `/api/snapshot` `/api/refresh` `/api/dbcheck` 的门锁,只认 `Authorization: Bearer <secret>` 头(常数时间比较;不再支持 `?secret=` query,密钥不该进访问日志)。不配置时这些端点仅本地回环可用——公网部署务必配上;`?only=榜名` 单榜重灌、`?boards=0` 只跑描述收割照旧

本地调试开关:GHB_FILL_DEBUG=1 看读路(数据库命中还是水合),GHB_SQL_DEBUG=1 看发往库的 SQL。

部署

在 Neon 建个项目,拿 Pooled connection 连接串。
Vercel 导入仓库,配四个环境变量(上表 + CRON_SECRET 自定义一个长随机串)。
仓库 Actions secrets 配 SYNC_URL(你的域名 /api/sync)和 CRON_SECRET,6 小时一次的同步就转起来了。
https://域名/robots.txt 里已有 sitemap 指向;搜索引擎控制台提交一次即可。

自托管也成立(本项目生产即此形态):npm run build && npm run start,数据面只要求能连上 Postgres——Neon 托管或自建实例(Docker/1Panel 等)均可,对 Host/Vercel 无偏好。自建库建议配每日 pg_dump 滚动备份,参考 scripts/ghb-backup.sh(每日一备、保留最近 7 份,cron 挂机即可)。

诊断与运维

npm run sync                       # 本地手动拉一轮(30 榜,~4 分钟,一次重试)
curl -H "Authorization: Bearer $CRON_SECRET" https://域名/api/dbcheck   # 库状态:head 键数、明细行数
gh run watch                       # 看 Actions 同步跑完没有

同步是顺序慢跑(为控边界与限流),一轮约 4 分钟;6 小时一次绰绰有余。明细行过 60 天自动清,board_head 只留最新,不需要人手干预。

徽章 · 状态页 · 跨线提醒

上榜徽章:项目被任何一张榜收录后,维护者都可以把名次徽章贴进自家 README——徽章自动显示当前最好名次(现役 / 曾上榜 / 未上榜三态),点击回到站内档案页。这也是本站唯一的外链请求:
```
[](https://git.vaiox.xyz/zh/repo/{owner}/{repo})
```
档案页(任意 /zh/repo/{owner}/{repo})顶部有徽章预览与一键复制的嵌入码。
数据健康页:/{lang}/status(footer 入口)—— 34 个键各自的来源、新鲜度、降级状态,与站点读路径同一张表,不涂脂抹粉。
跨线提醒(可选):配置 VAPID_PUBLIC_KEY / VAPID_PRIVATE_KEY 后,关注页出现"跨线提醒"开关 —— 无账号 Web Push,关注的仓库向上跨过 1k/10k/50k/100k 时推送;未配置则整条链路静默不存在。订阅只存推送端点与关注列表,退订即刻删除。

市场分析(可选,与站点无关)

站点只服务榜单本身;历史维度的深挖走独立脚本 scripts/market.mjs,数据来自 GH Archive 公共镜像(约 10% 抽样,看形状用):

node scripts/market.mjs repo vercel/next.js --days 60   # 单仓库爆发日/拐点(自动兼容改名)
node scripts/market.mjs track agent --months 12          # 赛道趋势(新星数/活跃仓库数)
node scripts/market.mjs risers --days 30 --limit 15      # 涨星火箭榜

顺带一个探明的平台事实(2026-10):GitHub 已把 REST stargazers/subscribers 明细端点平台级撤下,逐星时间线只存在于事件归档里。仓库改名后归档仍按旧名存,查询需新旧名都算——repo 命令已处理。

如何新增一个榜

lib/boards.ts:写一个 getXxxData(),在 getBoardData 分发,BOARD_META 登记排行与排序语义。
app/[lang]/dictionaries.ts:补 BoardCopy(名称 / 口径 / FAQ,中英都要)。
想有语言分面就在 BOARD_META 开 facets。
路由、导航、footer、sitemap 随 BOARD_ORDER 自动生效,不手改。

MCP server(agent-native 数据口)

榜单数据以 MCP 协议直供 agent,不依赖爬虫路径:

URL:https://git.vaiox.xyz/api/mcp(Streamable HTTP,无状态 JSON,最新 protocolVersion 2026-07-28,老客户端自动降档)
工具(只读 + 结构化输出):list_boards / get_board / get_board_movers / get_repo / search_library(库内关键词搜索)/ get_repo_history(仓库级小时名次 + 星数时间线,自有无一物快照序列独供,别的服务拿不出这份数)
全部零 GitHub 配额消耗;限流 60 次/分钟/IP;数据一小时一拍,别连点
接入示例:Claude Code claude mcp add --transport http github-hot-board https://git.vaiox.xyz/api/mcp

已知限制,如实说

Trending 数字在缓存期内(同步后 ≤6 小时)可能与官方页面存在偏差。
Search API 单查询 1000 条上限;总榜展示 Top 500,头部故事全覆盖。
潜力/黑马榜主口径 = 本站快照实测(近 7 天星数差 / 增速百分比,星速层随总榜收盘);旧"90 天斜率"口径降为兜底,启用时会标注 degraded。
黑红榜的候选池是总榜(前 300)中 ≥3000 星的仓库,即"明星仓内部"的争议对比;open_issues 口径含 PR(GitHub 字段如此,页面已明示)。请勿读成"情感评分"。
黑马榜按斜率取前 100(页面口径文案同此)。
里程碑跨线检测发生在页面停留期间,服务器不留历史状态;想看"历史上谁跨过 1k",等往日榜攒几天再回看。
往日榜当前只存基准口径(全语言),语言分面的历史拍在库里,页面上还没有入口。
本项目与 GitHub 无官方关系,榜单仅为研究参考。

GitHub Hot Board

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions