Skip to main content
Builder Plus Feature

SEO Agent API

The moment something breaks on your site, you should know about it. The SEO Agent API is a programmable diagnostic bridge you embed in your own app. Install it once with a single prompt in your AI builder. Every fix and insight flows back to your admin page automatically.

Hash-based auth · HMAC signing · Rate limiting · Webhook delivery · Full audit trail

How it works

Step 01

Generate API Key

One-click key generation. SHA-256 hashed, shown once.

Step 02

Scan from Code

POST to /v1/agent-scan with any URL. Get JSON findings.

Step 03

Policy Enforced

Path scoping, rate limits, and IP allowlists applied.

Step 04

Webhook Delivery

Findings pushed to your endpoint with HMAC signing.

Enterprise-grade security. Developer-friendly API.

Every request is authenticated, signed, and rate-limited. No plaintext secrets stored, ever.

AI Crawl Intelligence

See which AI bots are reading your llms.txt and llms-full.txt files. Distinguish shallow reads from deep reads. Activates automatically when your API key is active, no extra setup.

Instant Scans

Trigger SEO audits on any page from your codebase. Get structured JSON findings in seconds.

Path-Based Scoping

Define allowed and blocked paths so the agent only scans what you permit. Full control.

Hash-Based Auth

API keys are SHA-256 hashed, never stored in plaintext. HMAC request signing prevents tampering.

Rate Limiting

Per-key (60 req/min) and per-domain (10 scans/hr) limits protect your site from abuse.

Webhook Delivery

Get findings pushed to your endpoint with retry logic, delivery tracking, and HMAC verification.

IP Allowlisting

Lock API access to specific IPs. Combined with key rotation and expiry for defense in depth.

Batch Scanning

Scan multiple URLs in a single API call. Perfect for CI/CD pipelines and monitoring.

Key Rotation

90-day key expiry with graceful rotation. Previous key stays valid during transition window.

Audit Trail

Full activity log with duration, findings count, cache hits, and error tracking per scan.

Built for real workflows

Not just another API. These are the patterns developers actually use.

CI/CD Pipeline Guard

Block deploys that break SEO. Add a pre-deploy scan that checks meta tags, structured data, and crawlability before shipping.

// In your deploy script
const result = await fetch(API_URL + '/v1/agent-scan', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ url: 'https://yoursite.com/new-page' })
});
const { findings } = await result.json();
if (findings.some(f => f.severity === 'critical')) {
  process.exit(1); // Block deploy
}

Admin Health Dashboard

Build an internal SEO health card on your admin page that auto-scans on load and shows current score.

// React component (auto-scans on mount)
useEffect(() => {
  fetch(API_URL + '/v1/agent-scan', {
    method: 'POST',
    headers: { 'Authorization': 'Bearer ' + apiKey },
    body: JSON.stringify({}) // headless mode: scans site_url
  })
  .then(r => r.json())
  .then(data => setScore(data.overall_score));
}, []);

Webhook-Driven Alerts

Get notified when your SEO score drops. The webhook delivers findings to Slack, Discord, or your own endpoint.

// Webhook payload example
{
  "event": "scan.complete",
  "url": "https://yoursite.com",
  "overall_score": 72,
  "findings_count": 8,
  "critical_issues": [
    "Missing meta description",
    "No structured data detected"
  ]
}
Works with AI Builders

Copy. Paste. Ship.

Pre-formatted prompts for Lovable, Cursor, Bolt, Windsurf, Claude Code, and more. Just paste and your admin dashboard gets an SEO health card.

Lovable
Cursor
Bolt
Windsurf
1

Generate your API key from the dashboard (one click)

2

Copy the AI builder prompt (pre-formatted for your tool)

3

Paste into your AI builder chat

4

An SEO Health card appears on your admin page, auto-scanning on load

Security by design

API keys are SHA-256 hashed. Plaintext is never stored.

HMAC-SHA256 request signing with replay protection.

Timestamp + nonce headers prevent replay attacks.

90-day key expiry with graceful rotation window.

robots.txt compliance enforced server-side.

Full audit trail with per-request logging.

New: Chat clients (MCP)

Use SEO AgentBoss from Claude, Cursor, and ChatGPT

Plug SEO AgentBoss straight into your AI chat as an MCP server. Ask your assistant to scan a domain, pull the top fixes with copy-paste prompts, or summarize readiness across your sites — all scoped to the domains you own, all read-only.

Ask, don't click

Trigger scans and pull fix prompts from a conversation, no dashboard hopping.

Sign in once

OAuth-scoped to your account. Only your domains, only your findings.

AI-builder ready

Fix prompts come back formatted for Lovable, Cursor, Bolt, and Claude Code.

Read-only

The MCP surface never writes to your site or your account settings.

Connection URL and setup steps live in your dashboard.

Your site's SEO brain, always on.

Installs in minutes. Powers AI Crawl Intelligence, webhook alerts, and automated audits. Available on Builder Plus and above.