Documentation
Start with copy-paste quickstarts for SDK and MCP, then expand to the full API surface.
Quickstart
Public packages are available now: `@agentseo/sdk`, `@agentseo/mcp-server`, `@agentseo/acp-adapter`.
# SDK (Node.js, ESM)
npm i @agentseo/sdk
export AGENTSEO_API_KEY="sk_live_your_key"
import { AgentSEO } from "@agentseo/sdk";
const client = new AgentSEO({ apiKey: process.env.AGENTSEO_API_KEY! });
const result = await client.localAudit(
{ domain: "example.com", location: "New York, NY" },
{ sync: true }
);
console.log(result);# MCP (Claude Desktop)
{
"mcpServers": {
"agentseo": {
"command": "npx",
"args": ["-y", "@agentseo/mcp-server"],
"env": {
"AGENTSEO_API_KEY": "sk_live_your_key",
"AGENTSEO_API_URL": "https://api.agentseo.dev/api/v1"
}
}
}
}Authentication
All API requests require an API key in the x-api-key header.
# cURL example
curl https://agentseo.dev/api/v1/audit/local?sync=true \
-H "x-api-key: sk_live_your_key" \
-H "Content-Type: application/json" \
-d '{"domain":"example.com","location":"New York, NY"}'API Reference
Endpoints are async-first and support ?sync=true for inline responses.
Local Audit
POST /api/v1/audit/local
Content Gap
POST /api/v1/content/gap
Search
POST /api/v1/search
Extract
POST /api/v1/extract
Analyze SERP
POST /api/v1/analyze/serp
AI Overview Extract
POST /api/v1/ai-overview/extract
Local Visibility Track
POST /api/v1/local-visibility/track
Job Status
GET /api/v1/jobs/:id
SDKs & Libraries
@agentseo/sdk
Official JavaScript SDK.
@agentseo/mcp-server
Claude Desktop via MCP.
@agentseo/acp-adapter
ACP-compatible tool adapter.
Use Cases
AgentSEO supports autonomous SEO and search-visibility workflows.
AI Agent Pipelines
Feed structured SEO data into agent loops.
Content Automation
Detect gaps and prioritize content updates.
Local SEO Monitoring
Track visibility by domain, keyword, and location.
Competitive Research
Analyze SERP and monitor mention patterns.
Need help?
Get in touch with our team.