model-scraper

  ✅ **ONLY ALLOWED APPROACH:**
  - mcp__chrome-devtools__navigate - Navigate to web pages
  - mcp__chrome-devtools__evaluate - Execute JavaScript in browser
  - mcp__chrome-devtools__screenshot - Take debugging screenshots
  - mcp__chrome-devtools__console - Read console logs

  ❌ **ABSOLUTELY FORBIDDEN:**
  - curl, wget, or any HTTP client commands
  - fetch() or any JavaScript HTTP requests
  - API endpoints (https://openrouter.ai/api/*)
  - Bash scripts that make network requests
  - Any approach that doesn't use the browser

  **WHY:** OpenRouter rankings page is a React SPA. The data is rendered
  client-side via JavaScript. API endpoints don't expose the rankings data.
  ONLY browser-based scraping works.

  **IF MCP IS UNAVAILABLE:** STOP immediately and report configuration error.
  DO NOT attempt fallback approaches.
</approach_requirement>

<todowrite_requirement>
  You MUST use TodoWrite to track scraping progress through all phases.

  Before starting, create a todo list with:
  1. Navigate to OpenRouter rankings page
  2. Extract top 12 model rankings with provider field (UPDATED)
  3. Pre-filter Anthropic models (NEW - Phase 2.5)
  4. Extract model details via search for non-Anthropic models (UPDATED)
  5. Generate recommendations markdown
  6. Validate and write output file
  7. Report scraping summary

  Update continuously as you complete each phase.
</todowrite_requirement>

<mcp_availability>
  This agent REQUIRES Chrome DevTools MCP server to be configured and running.
  If MCP tools are not available, STOP and report configuration error.

  Test MCP availability by attempting to navigate to a test URL first.
</mcp_availability>

<data_quality>
  - Validate ALL extracted data before writing to file
  - If any model is missing critical data (slug, price, context), skip it
  - Minimum 6 valid non-Anthropic models required (UPDATED: was 7 total)
  - Rationale: Top 12 models include ~3 Anthropic (pre-filtered), leaving ~9 for extraction
  - Success threshold: 6/9 = 67% success rate
  - Report extraction failures with details
  - Each model MUST have: inputPrice, outputPrice, contextWindow
</data_quality>

<tiered_pricing_handling priority="CRITICAL">
  **CRITICAL: Some models have tiered/conditional pricing where cost increases
  dramatically at higher context windows. Always select the CHEAPEST tier.**

  See `shared/TIERED_PRICING_SPEC.md` (in repository root) for full specification.

  **Detection:**
  When extracting pricing, check if model has multiple pricing tiers:
  - Single object: `{ "prompt": 0.85, "completion": 1.50 }` → Flat pricing
  - Array/multiple entries → Tiered pricing (e.g., Claude Sonnet: 0-200K vs 200K-1M)

  **Selection Logic (IF tiered pricing detected):**
  1. Calculate average price for EACH tier: `avgPrice = (input + output) / 2`
  2. Select tier with LOWEST average price
  3. Use that tier's MAXIMUM context window (NOT the full model capacity!)
  4. Record tier metadata: `tiered: true`, note about pricing

  **Example: Claude Sonnet 4.5**
  ```
  OpenRouter shows:
    - Context: 1,000,000 tokens
    - Tier 1 (0-200K):   $3 input,  $15 output  → avg $9/1M
    - Tier 2 (200K-1M): $30 input, $150 output → avg $90/1M (10x!)

  CORRECT extraction:
    - slug: anthropic/claude-sonnet-4-5
    - price: 9.00 (tier 1 average)
    - context: 200K (tier 1 maximum, NOT 1M!)
    - tiered: true
    - tierNote: "Tiered pricing - beyond 200K costs $90/1M (10x more)"

  WRONG extraction:
    - price: 49.50 (averaged across both tiers - MISLEADING!)
    - context: 1M (suggests affordable 1M context - FALSE!)
  ```