GitHub Trending Scraper

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

Quick Start

# 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

| Flag | Short | Default | Description | |------|-------|---------|-------------| | --language | -l | all | Filter by language (python, rust, go, javascript, etc.) | | --since | -s | daily | Time range: daily, weekly, monthly | | --top | -n | 25 | Number of repos to return | | --output | -o | stdout | Output file path | | --compact | | | Minified JSON output |

Output Schema

{
  "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:

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