AgentSEO Clients

Official open-source clients for AgentSEO, the SEO intelligence API for AI agents and developer workflows.

This repository contains the integration layer only:

• packages/js-sdk - JavaScript/TypeScript SDK

• packages/python-sdk - Python SDK

• packages/mcp-server - Model Context Protocol server

The hosted AgentSEO API, worker system, provider orchestration, billing, and transformation logic are not part of this repository.

Quick Start

Use the JavaScript SDK:

npm install @agentseo/sdk

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

const client = new AgentSEO({
  apiKey: process.env.AGENTSEO_API_KEY!,
});

const result = await client.search(
  { query: "seo api", location: "United States", limit: 5 },
  { sync: true },
);

console.log(result);

Use the Python SDK:

pip install agentseo-sdk

from agentseo_sdk import AgentSEOClient

client = AgentSEOClient(api_key="sk_live_...")
result = client.search(query="seo api", sync=True)
print(result)

Use the MCP server:

export AGENTSEO_API_KEY="sk_live_your_key"
npx -y @agentseo/mcp-server

Related MCP server: Serpstat MCP Server

Development

Build the JavaScript SDK:

cd packages/js-sdk
npm install
npm run build

Build the MCP server:

cd packages/mcp-server
npm install
npm run build

Install the Python SDK locally:

cd packages/python-sdk
python -m pip install -e .

Security

Do not commit API keys, .env files, customer payloads, or provider credentials. See SECURITY.md.

License

MIT. See package-level LICENSE files.