English Français العربية

AgentSEO

Registre officiel Outils de développement

Live SEO workflow tools for Claude Code, Codex, and AI agents.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http agentseo 'https://www.agentseo.dev/mcp' --header 'x-api-key: <Your AgentSEO server-side API key. Create one at https://www.agentseo.dev.>' --header 'x-project-id: <Optional project attribution for client, tenant, or workspace tracking.>' --header 'x-workflow-id: <Optional workflow attribution for scheduled jobs, agents, or automations.>'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "agentseo": {
            "type": "http",
            "url": "https://www.agentseo.dev/mcp",
            "headers": {
                "x-api-key": "<Your AgentSEO server-side API key. Create one at https://www.agentseo.dev.>",
                "x-project-id": "<Optional project attribution for client, tenant, or workspace tracking.>",
                "x-workflow-id": "<Optional workflow attribution for scheduled jobs, agents, or automations.>"
            }
        }
    }
}
NPM package @agentseo/mcp-server
Claude Code 
claude mcp add agentseo -e 'AGENTSEO_API_KEY=<your agentseo_api_key>' -e 'AGENTSEO_API_URL=<AGENTSEO_API_URL>' -e 'AGENTSEO_PROJECT_ID=<AGENTSEO_PROJECT_ID>' -e 'AGENTSEO_WORKFLOW_ID=<AGENTSEO_WORKFLOW_ID>' -- npx -y @agentseo/mcp-server@0.1.3
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "agentseo": {
            "command": "npx",
            "args": [
                "-y",
                "@agentseo/mcp-server@0.1.3"
            ],
            "env": {
                "AGENTSEO_API_KEY": "<your agentseo_api_key>",
                "AGENTSEO_API_URL": "<AGENTSEO_API_URL>",
                "AGENTSEO_PROJECT_ID": "<AGENTSEO_PROJECT_ID>",
                "AGENTSEO_WORKFLOW_ID": "<AGENTSEO_WORKFLOW_ID>"
            }
        }
    }
}

Variables d'environnement

  • AGENTSEO_API_KEY obligatoire secret Your AgentSEO server-side API key.
  • AGENTSEO_API_URL Optional API base URL. Defaults to https://www.agentseo.dev/api/v1.
  • AGENTSEO_PROJECT_ID Optional project attribution for usage and job tracking.
  • AGENTSEO_WORKFLOW_ID Optional workflow attribution for usage and job tracking.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. AgentSEO Clients
  2. Quick Start
  3. Development
  4. Security
  5. License

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

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.

Questions fréquentes

Qu'est-ce que AgentSEO ?

Live SEO workflow tools for Claude Code, Codex, and AI agents.

Comment installer AgentSEO ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http agentseo 'https://www.agentseo.dev/mcp' --header 'x-api-key: <Your AgentSEO server-side API key. Create one at https://www.agentseo.dev.>' --header 'x-project-id: <Optional project attribution for client, tenant, or workspace tracking.>' --header 'x-workflow-id: <Optional workflow attribution for scheduled jobs, agents, or automations.>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour AgentSEO ?

Oui. Il attend AGENTSEO_API_KEY, x-api-key, x-project-id, x-workflow-id, à renseigner dans sa configuration.

AgentSEO est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient AgentSEO ?

Il est publié par AgentSEO-dev. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.