English Français العربية

AgentSEO

السجل الرسمي أدوات المطورين

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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.>'
إعداد 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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • AGENTSEO_API_KEY إلزامي سري 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.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو AgentSEO؟

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

كيف أثبّت AgentSEO؟

يعمل كخادم بعيد. في 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.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج AgentSEO إلى مفتاح API؟

نعم. يتطلب AGENTSEO_API_KEY, x-api-key, x-project-id, x-workflow-id، وتضبطها في إعداداته.

هل AgentSEO مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون AgentSEO؟

ينشره AgentSEO-dev. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.