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
Step 01
One-click key generation. SHA-256 hashed, shown once.
Step 02
POST to /v1/agent-scan with any URL. Get JSON findings.
Step 03
Path scoping, rate limits, and IP allowlists applied.
Step 04
Findings pushed to your endpoint with HMAC signing.
Every request is authenticated, signed, and rate-limited. No plaintext secrets stored, ever.
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.
Trigger SEO audits on any page from your codebase. Get structured JSON findings in seconds.
Define allowed and blocked paths so the agent only scans what you permit. Full control.
API keys are SHA-256 hashed, never stored in plaintext. HMAC request signing prevents tampering.
Per-key (60 req/min) and per-domain (10 scans/hr) limits protect your site from abuse.
Get findings pushed to your endpoint with retry logic, delivery tracking, and HMAC verification.
Lock API access to specific IPs. Combined with key rotation and expiry for defense in depth.
Scan multiple URLs in a single API call. Perfect for CI/CD pipelines and monitoring.
90-day key expiry with graceful rotation. Previous key stays valid during transition window.
Full activity log with duration, findings count, cache hits, and error tracking per scan.
Not just another API. These are the patterns developers actually use.
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
}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));
}, []);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"
]
}Pre-formatted prompts for Lovable, Cursor, Bolt, Windsurf, Claude Code, and more. Just paste and your admin dashboard gets an SEO health card.
Generate your API key from the dashboard (one click)
Copy the AI builder prompt (pre-formatted for your tool)
Paste into your AI builder chat
An SEO Health card appears on your admin page, auto-scanning on load
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.
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.
Trigger scans and pull fix prompts from a conversation, no dashboard hopping.
OAuth-scoped to your account. Only your domains, only your findings.
Fix prompts come back formatted for Lovable, Cursor, Bolt, and Claude Code.
The MCP surface never writes to your site or your account settings.