GitHub Trending Scraper#

Scrapes https://github.com/trending and outputs structured JSON.

Quick Start#

bash

# All languages, today, top 25
python3 scripts/github_trending.py

# Python repos, this week, top 10
python3 scripts/github_trending.py --language python --since weekly --top 10

# Save to file
python3 scripts/github_trending.py -o /tmp/github-trending.json

Options#

FlagShortDefaultDescription--language``-lallFilter by language (python, rust, go, javascript, etc.)--since``-sdailyTime range: daily, weekly, monthly``--top``-n25Number of repos to return--output``-ostdoutOutput file path--compactMinified JSON output

Output Schema#

json

{
  "source": "github-trending",
  "scraped_at": "ISO-8601",
  "language": "all|python|rust|...",
  "since": "daily|weekly|monthly",
  "count": 25,
  "repos": [
    {
      "rank": 1,
      "owner": "warpdotdev",
      "name": "warp",
      "full_name": "warpdotdev/warp",
      "url": "https://github.com/warpdotdev/warp",
      "description": "Warp is an agentic development environment...",
      "language": "Rust",
      "stars": 46667,
      "forks": 2917,
      "stars_period": 12822,
      "stars_period_label": "today"
    }
  ]
}

Integration with Trending Cards#

Pipe output into the existing trending card generator:

bash

python3 scripts/github_trending.py -o /tmp/github-trending.json
python3 ~/.openclaw/workspace/scripts/trending-card-gen.py \
  --input /tmp/github-trending.json \
  --output /tmp/trending-card.html \
  --platform github --theme white --size hd

Notes#

• No API key required; scrapes the public GitHub Trending page
• Rate limit: reasonable use only; avoid rapid repeated calls
• Some repos (e.g. sponsors/username) may show 0 stars/forks due to GitHub page structure