OpenRouter Rankings Tracker

Fetch and track OpenRouter's AI model usage rankings.

---

Quick Start

# Fetch current rankings
node scripts/fetch.js

# With options
node scripts/fetch.js --save --push

---

What It Captures

| Section | Data | |---------|------| | Top Models | Weekly token usage, growth % | | Top Apps | Apps consuming most tokens | | Market Share | Provider market distribution | | Highlights | Fastest growing, #1 model/app |

---

Output Format

Data saved to ~/.openclaw/data/openrouter-rankings/YYYY-MM-DD.json

{
  "fetchedAt": "2026-03-10T02:15:00.000Z",
  "source": "https://openrouter.ai/rankings",
  "period": "This Week",
  "topModels": [...],
  "marketShare": [...],
  "topApps": [...],
  "highlights": {...}
}

---

Cron Integration

Set up weekly automated fetch:

{
  "name": "openrouter-weekly",
  "schedule": { "kind": "cron", "expr": "0 9 * * 1" },
  "payload": { "kind": "agentTurn", "message": "Fetch OpenRouter rankings and push to Feishu" },
  "sessionTarget": "isolated"
}

---

Options

| Flag | Description | |------|-------------| | --save | Save to JSON file | | --push | Push to Feishu (requires config) | | --compare | Compare with last week |

---

Data Structure

See references/data-structure.md for detailed schema.