# AgentSEO

Подключает поисковую аналитику и SEO-инструменты AgentSEO прямо в сессию ИИ-агента. Пригодится для проверки поисковой выдачи и автоматизации SEO-задач в коде.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: AgentSEO-dev
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/AgentSEO-dev/agentseo-clients
- Обновлён: 2026-07-17
- HTML: https://affpapa.org/nevibecode/mcp/agentseo

## Что делает

Сервер связывает ИИ-ассистентов с облачной платформой AgentSEO. В открытом репозитории находится только слой интеграции: пакеты для JavaScript, Python и реализация протокола MCP. Логика сбора данных, биллинг и оркестрация провайдеров работают на стороне удалённого сервиса.

Для локального запуска через `npx` нужен ключ `AGENTSEO_API_KEY`. Без действующего API-ключа сервер не сможет обращаться к сервису и выполнять поисковые запросы. Дополнительно через переменные среды можно настроить URL сервиса, идентификаторы проекта и рабочего процесса.

Подключение возможно двумя способами: локально через `stdio` пакетом `@agentseo/mcp-server` либо напрямую к удалённому эндпоинту по протоколу HTTP.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://www.agentseo.dev/mcp`
- Переменные окружения: `AGENTSEO_API_KEY`, `AGENTSEO_API_URL`, `AGENTSEO_PROJECT_ID`, `AGENTSEO_WORKFLOW_ID` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы**
```bash
claude mcp add --env AGENTSEO_API_KEY=<AGENTSEO_API_KEY> --env AGENTSEO_API_URL=<AGENTSEO_API_URL> --env AGENTSEO_PROJECT_ID=<AGENTSEO_PROJECT_ID> --env AGENTSEO_WORKFLOW_ID=<AGENTSEO_WORKFLOW_ID> --transport stdio agentseo -- npx -y @agentseo/mcp-server
```
Вместо <…> подставьте свои значения

2. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http agentseo https://www.agentseo.dev/mcp
```

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add agentseo --url https://www.agentseo.dev/mcp
```

2. **Командой платформы**
```bash
codex mcp add agentseo --env AGENTSEO_API_KEY=<AGENTSEO_API_KEY> --env AGENTSEO_API_URL=<AGENTSEO_API_URL> --env AGENTSEO_PROJECT_ID=<AGENTSEO_PROJECT_ID> --env AGENTSEO_WORKFLOW_ID=<AGENTSEO_WORKFLOW_ID> -- npx -y @agentseo/mcp-server
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agentseo": {
            "url": "https://www.agentseo.dev/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agentseo": {
            "command": "npx",
            "args": [
                "-y",
                "@agentseo/mcp-server"
            ],
            "env": {
                "AGENTSEO_API_KEY": "<AGENTSEO_API_KEY>",
                "AGENTSEO_API_URL": "<AGENTSEO_API_URL>",
                "AGENTSEO_PROJECT_ID": "<AGENTSEO_PROJECT_ID>",
                "AGENTSEO_WORKFLOW_ID": "<AGENTSEO_WORKFLOW_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "agentseo": {
            "type": "http",
            "url": "https://www.agentseo.dev/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "agentseo": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@agentseo/mcp-server"
            ],
            "env": {
                "AGENTSEO_API_KEY": "<AGENTSEO_API_KEY>",
                "AGENTSEO_API_URL": "<AGENTSEO_API_URL>",
                "AGENTSEO_PROJECT_ID": "<AGENTSEO_PROJECT_ID>",
                "AGENTSEO_WORKFLOW_ID": "<AGENTSEO_WORKFLOW_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http agentseo https://www.agentseo.dev/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e AGENTSEO_API_KEY=<AGENTSEO_API_KEY> -e AGENTSEO_API_URL=<AGENTSEO_API_URL> -e AGENTSEO_PROJECT_ID=<AGENTSEO_PROJECT_ID> -e AGENTSEO_WORKFLOW_ID=<AGENTSEO_WORKFLOW_ID> agentseo npx -y @agentseo/mcp-server
```
Вместо <…> подставьте свои значения

## Когда брать
- проверить позиции сайта и результаты выдачи в поисковиках
- передать в поиск фильтрацию по целевой локации и лимиту ответов
- встроить поиск SEO-данных в агентские сценарии разработки

## Примеры запросов агенту
- Сделай поисковый запрос по ключу «seo api» для региона «United States» через AgentSEO
- Запусти синхронный поиск по выдаче с ограничением в 5 результатов

## Похожие
- [New-Term Radar](https://affpapa.org/nevibecode/mcp/new-term-radar.md) — MCP-сервер · ★ 1823
- [NotFair](https://affpapa.org/nevibecode/mcp/notfair.md) — MCP-сервер · ★ 4064
- [seo-monster](https://affpapa.org/nevibecode/mcp/seo-monster.md) — MCP-сервер · ★ 555
- [Google Maps MCP Server](https://affpapa.org/nevibecode/mcp/google-maps-mcp-server.md) — MCP-сервер · ★ 484
- [Search Console MCP](https://affpapa.org/nevibecode/mcp/search-console-mcp.md) — MCP-сервер · ★ 310
- [squirrelscan](https://affpapa.org/nevibecode/mcp/squirrelscan.md) — MCP-сервер · ★ 298

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md