SDKs & Libraries

Fully typed SDK for Node.js (ESM). Best for backend services, workers, Next.js apps, and programmatic SEO pipelines.

Current first-class methods include localAudit, contentGap, search, analyzeSerp, aiOverviewExtract, localVisibilityTrack, llmMentionsTrack, contentDecayDetect, keywordClusterBuild, getJob, and waitForJob. For endpoints not yet wrapped, call the REST API directly.

import { AgentSEO } from "@agentseo/sdk";

const client = new AgentSEO({
  apiKey: process.env.AGENTSEO_API_KEY!,
  projectId: "client-alpha",
  workflowId: "nightly-refresh",
});

const job = await client.analyzeSerp({
  keyword: "seo agency austin",
  location: "Austin, TX",
  location_code: 1026201
});

const status = await client.waitForJob(job.jobId, {
  timeoutMs: 90_000,
});

if (status.status === "failed") {
  throw new Error(status.error?.message || "Job failed");
}

console.log(status.result);

Official Python client for data science and backend workflows.

The Python SDK mirrors the same core workflow set as the Node SDK and adds get_job plus wait_for_job for async handling.

from agentseo_sdk import AgentSEOClient

client = AgentSEOClient(
    api_key="sk_live_...",
    project_id="client-alpha",
    workflow_id="nightly-refresh",
)

job = client.content_gap(
    url="https://example.com/blog/post",
    keyword="seo agency austin",
    location="Austin, TX",
    location_code=1026201,
)

status = client.wait_for_job(
    job["jobId"],
    timeout_seconds=90,
)

if status["status"] == "failed":
    raise RuntimeError(status["error"]["message"])

print(status["result"])

Model Context Protocol server for Claude Desktop and Cursor. Use the hosted endpoint when you want zero local install, or keep the local package when you want the MCP process on your own machine.

For runtime-specific guidance, see the Claude Code integration page or the Claude Desktop integration page.

claude mcp add --transport http agentseo https://www.agentseo.dev/mcp \
  --header "Authorization: Bearer sk_live_..." \
  --header "x-project-id: client-alpha" \
  --header "x-workflow-id: nightly-refresh"

{
  "mcpServers": {
    "agentseo": {
      "url": "https://www.agentseo.dev/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_...",
        "x-project-id": "client-alpha",
        "x-workflow-id": "nightly-refresh"
      }
    }
  }
}

{
  "mcpServers": {
    "agentseo": {
      "command": "npx",
      "args": ["-y", "@agentseo/mcp-server"],
      "env": {
        "AGENTSEO_API_KEY": "sk_live_...",
        "AGENTSEO_API_URL": "https://www.agentseo.dev/api/v1",
        "AGENTSEO_PROJECT_ID": "client-alpha",
        "AGENTSEO_WORKFLOW_ID": "nightly-refresh"
      }
    }
  }
}

Hosted MCP requires a server-side API key with no allowed domains. If you restrict a key to browser origins, use the local MCP package instead.

For OpenClaw, prefer the first-party AgentSEO plugin. Use the ACP adapter when you need to import AgentSEO tools into a custom ACP-compatible runtime.

This package is published by AgentSEO. The docs do not claim upstream OpenClaw-maintainer approval. See the OpenClaw integration page for positioning and setup guidance.

{
  "agents": {
    "list": [
      {
        "id": "seo",
        "tools": {
          "allow": [
            "agentseo_local_audit",
            "agentseo_content_gap",
            "agentseo_ai_overview_extract",
            "agentseo_local_visibility_track",
            "agentseo_rank_track",
            "agentseo_job_status"
          ]
        }
      }
    ]
  }
}