The Performance API for Developers & AI Agents

curl -X POST https://pulspeed.ai/api/v2/scan \
  -H "Authorization: Bearer $PULSPEED_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "wait": true}'

# Response (200) ~ 30 seconds
{
  "data": {
    "performance_score": 85,
    "metrics": { "fcp": 1200, "lcp": 2500, "tbt": 150, "cls": 0.05 },
    "analysis": "AI-powered recommendations..."
  }
}

# Install MCP server
npx @pulspeed/mcp-server

# Then ask your AI agent:
"Scan my site and suggest performance improvements"

# Agent automatically:
# 1. Calls scan_site tool      -> gets Core Web Vitals
# 2. Calls get_recommendations  -> gets AI analysis
# 3. Suggests concrete code changes to fix issues

# .github/workflows/lighthouse.yml
name: Performance Check
on: [push]

jobs:
  scan:
    runs-on: ubuntu-latest
    steps:
      - name: Run Pulspeed scan
        run: |
          curl -X POST https://pulspeed.ai/api/v2/scan \
            -H "Authorization: Bearer ${{ secrets.PULSPEED_KEY }}" \
            -d '{"url": "${{ env.STAGING_URL }}", "wait": true}'

# Trigger scan via webhook (Team plan)
curl -X POST https://pulspeed.ai/api/v1/webhook/scan \
  -H "Authorization: Bearer $WEBHOOK_TOKEN" \
  -d '{"repository": {"full_name": "your-org/your-repo"}}'

# Pulspeed will:
# 1. Find the site linked to this repository
# 2. Run a full PageSpeed scan
# 3. Store snapshot with metrics & AI analysis
# 4. Data available via API and dashboard