GitHub Trending
Fetches GitHub Trending repositories (daily/weekly/monthly). Uses only Python standard library; no external packages.
When to Use
- User asks for GitHub trending, popular repos, 本周热点 / this week's hotspots
- User wants daily / weekly / monthly trending
- User wants trending filtered by programming language
Quick Start
Run from the skill directory (e.g. github-trending/):
# Weekly trending (default), 15 repos
python scripts/github_trending.py weekly
# Daily trending, 10 repos
python scripts/github_trending.py daily --limit 10
# Weekly trending in Python
python scripts/github_trending.py weekly --language python
# JSON output (for piping or tooling)
python scripts/github_trending.py weekly --json
Parameters
| Argument | Values | Default | Description |
|---|---|---|---|
period | daily, weekly, monthly | weekly | Time range for "stars gained" |
--limit | integer | 15 | Max number of repos to return |
--language | string | (all) | Filter by language (see below) |
--json | flag | — | Output JSON instead of human-readable text |
Language: Use full name or alias. Script supports aliases: py→python, ts→typescript, js→javascript, cpp/c++→c++, c#/csharp→c#, rs→rust, rb→ruby, go→go. Others are passed as-is (e.g. --language "c").
Output
Text (default)
- Rank (numeric), repo
full_name, description (trimmed to 90 chars) - 每行统计符号含义：
- 🔧 编程语言（Language）
- ⭐ 总 Star 数（total stars）
- 📈 本周期新增 Star 数（stars gained in the selected period）
- 时间以北京时区 (UTC+8) 显示
JSON (--json)
{
"period": "weekly",
"updated_at": "2026-03-13T21:00:00+08:00",
"data": [
{
"rank": 1,
"full_name": "owner/repo",
"url": "https://github.com/owner/repo",
"description": "...",
"language": "Python",
"stars_total": "12345",
"stars_gained": 1234
}
]
}
Data Source
- URL:
https://github.com/trending(and.../trending/<language>?since=<period>) - Method: HTTP +
html.parser.HTMLParser(no browser, no auth) - Fresh: Each run fetches the current page
Dependencies
Python standard library only: urllib.request, html.parser, json, argparse, datetime. No pip install required.
Troubleshooting
| Issue | What to do |
|---|---|
Empty data / no repos | Network may have closed early (IncompleteRead). Retry; if script supports it, use chunked read. |
| Parse errors / wrong structure | GitHub may have changed HTML; script may need selector/parser updates. |
| Timeout | Check network; default timeout 15s. |
| Windows console encoding error on emoji | Set PYTHONIOENCODING=utf-8 or run with --json and parse elsewhere. |
Notes
- Trending is by stars gained in the chosen period, not total stars.
- For GitHub API (e.g. search by stars, auth), use a separate GitHub API skill.