list_boards
List boards
The 10 leaderboards on GitHub Hot Board: what each ranks, its canonical page URL and its JSON API endpoint.
無需輸入參數。
GitHub Hot Board
io.github.JKWY01由 GitHub 帳號 JKWY01 發布v2.1.0更新於 Oct 31, 2026
GitHub hot-repo leaderboards: snapshots, movers, rank history. Read-only JSON, hourly batches.
概覽
AI 產生的概覽
以唯讀方式透過 MCP 取得 GitHub 火線榜的熱門儲存庫榜單、名次變動、儲存庫檔案，以及逐小時名次與星數歷史。
- 可以做什麼
- 列出十個榜單及其口徑、頁面網址與 JSON 端點
- 取得某個榜單的前 N 名，含名次、Star、Fork、Issue、語言與描述
- 查看過去 24 小時內在某榜單上確實發生名次變動的儲存庫
- 查詢單一儲存庫的 Star、Fork、多語言描述、目前總榜名次與資料新鮮度
- 依 owner/name 或關鍵字搜尋站點收錄的儲存庫資料庫
- 讀取某儲存庫在某榜單上的逐小時名次與星數時間序列
- 適用情境
- 適合讓助理彙報 GitHub 開源趨勢、週榜月榜漲星、名次變動或某儲存庫的名次歷史，而不必爬取網頁，也不消耗 GitHub API 配額。
- 執行需求
- 遠端 Streamable HTTP 端點；未宣告需要驗證、環境變數或請求標頭。資料來自站點自有資料集，用戶端不需 GitHub 權杖。
安裝前請注意
唯讀且不索取憑證，但資料來自站點自有快照，批次約每 30 分鐘至 6 小時更新一次，數字可能落後於 GitHub 即時頁面。部分榜單採用備援口徑時會標示降級，黑紅榜是結構化啟發式而非情感分析。從未上榜的儲存庫不會出現在搜尋與查詢中。限流為每 IP 每分鐘 60 次。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 GitHub Hot Board，將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
交給代理程式安裝
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/io.github.JKWY01%2Fgithub-hot-board/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。其他 MCP 客戶端
把它新增到你客戶端的 mcpServers 設定中。
{
"mcpServers": {
"github-hot-board": {
"type": "http",
"url": "https://git.vaiox.xyz/api/mcp"
}
}
}README
GitHub 火线榜 · GitHub Hot Board
GitHub 排行榜 · 趋势榜 · 飙升榜(周榜 / 月榜 / 总榜 / 黑马 / 里程碑),中英文双语界面,每 6 小时自动更新:https://git.vaiox.xyz
十个视角的 GitHub 开源热榜。数据只有公开数据一种来源,口径贴在每一页上,中英文双语,站点刷新每 60 秒一次。
本周飙升 Top 10 · 打开完整榜单 →
本月飙升 Top 10 · 打开完整榜单 →
累计 Star Top 10 · 打开完整榜单 →
先说三件不掺假的事:
- 不伪造数据。榜单页面写的是哪种口径,数出来就是哪种口径;口径失效时页面明示,不悄悄换数。
- 不碰付费数据。只用 GitHub Search API 和官方 trending 页,不需要任何特殊权限。
- 不装没有的历史。往日榜从 2026-10-18 起积累,之前的日期不提供。
十个榜
总榜、周榜、月榜有语言分榜(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.
数据架构
一句话:卖货的通道不进货。
- 同步任务(
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,所以任意一天切任意名字都能回看:
入口在 footer(往日榜 → 总榜)。历史拍只存排名、仓库和数字,不存实时简介;数据保留 SNAPSHOT_RETENTION_DAYS(默认 60 天)。页面 noindex,属工具页,不在 sitemap 里占道。
本地跑起来
本地调试开关: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 挂机即可)。
诊断与运维
同步是顺序慢跑(为控边界与限流),一轮约 4 分钟;6 小时一次绰绰有余。明细行过 60 天自动清,board_head 只留最新,不需要人手干预。
徽章 · 状态页 · 跨线提醒
-
上榜徽章:项目被任何一张榜收录后,维护者都可以把名次徽章贴进自家 README——徽章自动显示当前最好名次(现役 / 曾上榜 / 未上榜三态),点击回到站内档案页。这也是本站唯一的外链请求:
档案页(任意
/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% 抽样,看形状用):
顺带一个探明的平台事实(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 无官方关系,榜单仅为研究参考。
來源：README.md，提交 fb48747
工具
6get_board
Get board snapshot
Top-N rows of one leaderboard (rank, stars, forks, issues, language, description). Refreshes in hourly batches; generatedAt is the batch stamp (fetch once per hour).
輸入參數
slug必填limitlanguageget_board_movers
Get 24h movers
Repositories that genuinely moved rank on a board within the last 24 hours, from our own hourly snapshot series (the same data as the on-site movers strip). Positive climb = went up.
輸入參數
slug必填limitget_repo
Get repository record
Library record for one repository: stars, forks, description in up to 16 UI languages (keys are locale codes), current overall-board rank if listed, pushedAt, and asOf freshness stamps. Served from our own dataset (no live GitHub API call); repos outside the library return not-in-library.
輸入參數
lgfull必填search_library
Search the library
Search repositories tracked by this site, by owner/name (exact wins) or by keyword over descriptions (16 languages). Library-only: repos never listed on a board are not here. No live GitHub calls.
輸入參數
q必填limitget_repo_history
Get rank history
Time series of one repository on one board (default overall): hourly rank + star points from our own snapshot series. Our unique moat — this data exists on no other service. Empty result means the repo was not tracked in the window.
輸入參數
daysfull必填board版本歷史
1- v2.1.0最新Oct 24, 2026
評分
已滿足適用檢查項的 90%
該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。
- 近 30 天內可連通必需25 分
- 已宣告認證方式必需10 分
- 已列出工具必需15 分
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分
請在儲存庫或註冊中心條目中宣告授權條款。
