github-trending

name	github-trending
description	通过网页抓取获取 GitHub 按日/周/月增长的热门仓库。当用户询问 GitHub 趋势、热门项目、本周热点或「什么在 GitHub 上 trending」时使用。可输出列表或 JSON，无需 API Key。

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.