oem-api-discover - SKILL.md Agent Skill

name: oem-api-discover description: CDP network interception for API discovery. Analyses network requests during browser rendering to discover OEM APIs that can be called directly, bypassing expensive browser renders. Learns optimal methods per OEM over time.

OEM API Discovery

Intercepts network traffic during browser rendering to discover callable APIs.

Discovery Targets

Gatsby page-data: /{route}/page-data.json — Static JSON endpoints on Gatsby sites (e.g. LDV AU on Gatsby 5.14.6). Rich structured data without browser rendering or API keys. Detection: probe any route with /page-data.json suffix.
Next.js data routes: /_next/data/{buildId}/...
React/Vue API calls: /api/*, /graphql
AEM Content Services: /content/dam/*, /api/assets/*
Sitecore Layout Service: /sitecore/api/layout/*
WordPress REST API: /wp-json/wp/v2/*
Generic JSON endpoints with product/offer data
GM/Chevrolet colorizer APIs: /content/gm/api/services/colorizerContent
GM chip/jelly CDN patterns: colorizer/ directory with chip textures and vehicle renders

Prerequisites

SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY for storing discovered APIs
GROQ_API_KEY for API classification

How It Works

During full render (via oem-crawl), enable CDP Network domain using cloudflare-browser skill
Call client.getApiCandidates() to get filtered JSON endpoints
Classify API pattern using Groq Llama
Store discovered API in discovered_apis table (unique: oem_id, url) with schema_json, reliability_score, status
On future crawls, try direct API call before falling back to browser render

Integration with cloudflare-browser

const { createClient } = require('../cloudflare-browser/scripts/cdp-client');

// Enable network interception
const client = await createClient();
await client.enableNetwork();

// Navigate and wait for render
await client.navigate('https://ford.com/suvs/explorer', 5000);

// Get API candidates for classification
const apis = client.getApiCandidates();
// Pass to oem-api-discover handler for Groq classification

Input

{
  "oem_id": "ford-au",
  "page_url": "https://ford.com/suvs/explorer",
  "network_log": [
    {
      "url": "https://ford.com/api/vehicles/explorer",
      "method": "GET",
      "status": 200,
      "content_type": "application/json",
      "response_size": 15000
    }
  ]
}

Output

{
  "apis_discovered": 2,
  "apis_updated": 1
}