Skip to main content
Glama

MCP-сервер SearchAtlas

npm version MCP Registry License: MIT Node.js

npm · MCP Registry · GitHub

Подключите любой MCP-совместимый ИИ-клиент к MCP-серверу SearchAtlas v2 — более 500 инструментов, охватывающих OTTO SEO, PPC, Content Genius, Site Explorer, профиль компании в Google, локальное SEO, Link Laboratory, цифровой PR, видимость для LLM, исследование ключевых слов и многое другое.

Этот пакет работает как легкий мост stdio к размещенному серверу v2 MCP по адресу https://mcp.searchatlas.com/mcp/, поэтому он работает с клиентами, которые поддерживают только stdio. Клиенты с нативной поддержкой Streamable-HTTP могут подключаться к удаленной конечной точке напрямую.

Работает с Claude Code, Cursor, Claude Desktop, VS Code, Windsurf и Zed.


Настройка (3 шага)

1. Установка и вход

Через npm:

npm install -g searchatlas-mcp-server
searchatlas login

Через yarn:

yarn global add searchatlas-mcp-server
searchatlas login

Через pnpm:

pnpm add -g searchatlas-mcp-server
searchatlas login

Без установки (npx):

npx searchatlas-mcp-server login

Это откроет ваш браузер. После входа в систему:

  1. Нажмите F12 (или Cmd+Option+I на Mac), чтобы открыть инструменты разработчика (DevTools)

  2. Перейдите на вкладку Console (Консоль)

  3. Выполните: localStorage.getItem("token")

  4. Скопируйте результат и вставьте его в терминал

CLI проверит ваш токен, сохранит его и выведет готовые к вставке конфигурации с автоматически определенными путями.

2. Добавление в ваш MCP-клиент

Claude Code

macOS / Linux:

claude mcp add searchatlas -e SEARCHATLAS_TOKEN=your-token -- npx -y searchatlas-mcp-server

Windows (PowerShell):

claude mcp add searchatlas -e SEARCHATLAS_TOKEN=your-token -- npx.cmd -y searchatlas-mcp-server

Примечание для Windows: Вы должны использовать npx.cmd вместо npx. Это связано с тем, что Claude Code запускает процессы напрямую, а Windows требует расширение .cmd.

Готово. Это всё.

Cursor

Создайте .cursor/mcp.json в корне вашего проекта (или ~/.cursor/mcp.json для глобальной настройки):

{
  "mcpServers": {
    "searchatlas": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
      "env": {
        "SEARCHATLAS_TOKEN": "your-token"
      }
    }
  }
}

Ваши пути могут отличаться. Выполните which node и npm root -g, чтобы найти их, или просто скопируйте конфигурацию, которую вывел searchatlas login — в ней указаны ваши точные пути.

Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "searchatlas": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
      "env": {
        "SEARCHATLAS_TOKEN": "your-token"
      }
    }
  }
}

После сохранения перезапустите Claude Desktop.

Добавьте в ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "searchatlas": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
      "env": {
        "SEARCHATLAS_TOKEN": "your-token"
      }
    }
  }
}

Добавьте в .vscode/mcp.json в вашем проекте:

{
  "servers": {
    "searchatlas": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
      "env": {
        "SEARCHATLAS_TOKEN": "your-token"
      }
    }
  }
}

Добавьте в settings.json редактора Zed:

{
  "context_servers": {
    "searchatlas": {
      "command": {
        "path": "/opt/homebrew/bin/node",
        "args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
        "env": {
          "SEARCHATLAS_TOKEN": "your-token"
        }
      }
    }
  }
}

3. Проверка

searchatlas check
  SearchAtlas MCP Server — Health Check

  ✓ Credential source: ~/.searchatlasrc
  ✓ Config loaded successfully (endpoint: https://mcp.searchatlas.com/mcp)
  ✓ JWT structure valid (expires in 12 days) — user 42
  ✓ MCP handshake succeeded — 587 tools available

  All checks passed — you're ready to go!

Related MCP server: MCP by Amal Alexander

Почему полные пути?

Графические приложения macOS (Cursor, Claude Desktop, VS Code, Windsurf, Zed) не наследуют переменную PATH вашей оболочки, поэтому они не могут найти node или npx. Использование полного пути к node и прямое указание на установленный пакет полностью предотвращает ошибки spawn npx ENOENT и env: node: No such file.

Команда searchatlas login автоматически определяет ваши пути и выводит конфигурации, которые можно скопировать и вставить.

Как найти ваши пути

Команда

Полный путь к node

which node

Директория глобальных npm-модулей

npm root -g


Использование

Просто общайтесь естественным языком. ИИ сам выберет нужный инструмент:

"What are the top SEO issues for my site?"
"Run a technical SEO audit on example.com"
"Write a blog post about technical SEO best practices"
"Find long-tail keywords for project management software"
"List my projects"
"Show available playbooks and run one"

Команды CLI

Команда

Описание

searchatlas login

Войти, сохранить токен, вывести MCP-конфигурации

searchatlas check

Проверить учетные данные + подключение к API

searchatlas --version

Вывести версию

searchatlas --help

Показать справку

Все команды также работают через npx searchatlas-mcp-server <команда>.


Инструменты

Инструменты обнаруживаются динамически с размещенного сервера v2 MCP — ваш клиент видит актуальный каталог (в настоящее время около 587 инструментов) без необходимости обновления пакета при появлении новых. Основные группы:

Префикс

Область

Примеры инструментов

otto_*

OTTO SEO-автоматизация (70 инструментов)

otto_list_projects, otto_add_site, otto_get_dynamic_optimizations

ppc_*

Google Ads / PPC (76 инструментов)

ppc_list_accounts, ppc_create_campaign, ppc_get_keyword_performance

cg_*

Content Genius (74 инструмента)

cg_list_articles, cg_edit_article_content, cg_generate_content_brief

se_*

Site Explorer (46 инструментов)

se_list_sites, se_get_details, se_backlinks_overview

gbp_*

Профиль компании в Google (96 инструментов)

gbp_get_business_categories, gbp_list_citation_submissions

local_seo_*

Тепловые карты локального SEO (19 инструментов)

local_seo_heatmaps_get_heatmap_details, local_seo_heatmaps_get_rank

ll_*

Link Laboratory (24 инструмента)

ll_list_projects, ll_create_order

dpr_*

Цифровой PR (20 инструментов)

dpr_list_campaigns, dpr_create_campaign

llmv_*

Видимость для LLM (30 инструментов)

llmv_list_projects, llmv_get_visibility_report

krt_*

Отслеживание позиций ключевых слов (16 инструментов)

krt_list_projects, krt_track_keywords

bv_*

Brand Vault (25 инструментов)

bv_list, bv_ask, bv_update_business_info

ws_*

Website Studio (8 инструментов)

ws_list_projects, ws_create_project

gsc_*

Google Search Console (11 инструментов)

gsc_get_sites, gsc_get_keyword_performance

social_hub_*

Social Hub (19 инструментов)

social_hub_list_posts, social_hub_create_post

cs_*

Контент-стратегия (12 инструментов)

cs_list_templates, cs_create

kg_*

Граф знаний (7 инструментов)

kg_list, kg_create_entity

dkn_*

Сеть знаний о доменах (7 инструментов)

dkn_list_nodes, dkn_create

indexer_*

Индексатор (6 инструментов)

indexer_submit_batch, indexer_check_status

rb_*

Конструктор отчетов (3 инструмента)

rb_list_reports, rb_get_report_details

pr_*

Пресс-релизы (14 инструментов)

pr_list, pr_write, pr_update

Выполните searchatlas check, чтобы увидеть актуальное количество, или попросите ваш MCP-клиент вывести список инструментов после подключения.


Конфигурация

Приоритет токена (побеждает первое совпадение)

  1. Переменная окружения SEARCHATLAS_TOKEN

  2. Переменная окружения SEARCHATLAS_API_KEY

  3. Файл ~/.searchatlasrc (создается командой searchatlas login)

Переменные окружения

Переменная

Обязательно

Описание

SEARCHATLAS_TOKEN

Да

JWT-токен из SearchAtlas

SEARCHATLAS_API_KEY

Альтернатива

Аутентификация по API-ключу

SEARCHATLAS_API_URL

Нет

Пользовательская конечная точка v2 MCP (по умолчанию: https://mcp.searchatlas.com/mcp)

Клиенты с нативной поддержкой Streamable-HTTP

Если ваш MCP-клиент поддерживает Streamable HTTP напрямую, вы можете пропустить этот npm-пакет и подключиться к удаленному серверу за один шаг:

  • URL: https://mcp.searchatlas.com/mcp/

  • Транспорт: Streamable HTTP (JSON-RPC + SSE)

  • Заголовок: Authorization: Bearer <SEARCHATLAS_TOKEN>


Устранение неполадок

Ошибка

Решение

spawn npx ENOENT / env: node: No such file

Используйте полные пути (см. Почему полные пути?) или повторно выполните searchatlas login

spawn npx ENOENT в Windows (Claude Code)

Используйте npx.cmd вместо npx — см. настройку Claude Code

No SearchAtlas credentials found

Выполните searchatlas login

Token expired on ...

Выполните searchatlas login для получения нового токена

Authentication failed (401)

Токен истек — выполните searchatlas login

fetch failed

Проверьте сеть; выполните searchatlas check

Инструменты не отображаются

Перезапустите ваш MCP-клиент после добавления конфигурации

Все еще не получается? Выполните searchatlas check, убедитесь, что установлена Node.js >= 18 (node --version), или создайте issue.


Разработка

git clone https://github.com/Search-Atlas-Group/searchatlas-mcp-server.git
cd searchatlas-mcp-server
npm install && npm run build

Тестирование с помощью MCP Inspector:

npx @modelcontextprotocol/inspector npx searchatlas-mcp-server

Требования

Лицензия

MIT

Available Tools

16 tools
searchatlas_authority_buildingC

Link building and digital PR — outreach, guest posts, and authority signals

Inputs: message (required), project_id, playbook_id, plan_mode.

searchatlas_contentC

AI content generation — blog posts, landing pages, and optimized copy

Inputs: message (required), project_id, playbook_id, plan_mode.

searchatlas_create_projectC

Create a new SearchAtlas project

Inputs: domain (required), country_code.

searchatlas_gbpC

Google Business Profile management — listings, reviews, and local SEO

Inputs: message (required), project_id, playbook_id, plan_mode.

searchatlas_keywordsC

Keyword research — search volume, difficulty, SERP analysis, and clustering

Inputs: message (required), project_id, playbook_id, plan_mode.

searchatlas_list_artifactsC

List artifacts (code, content, reports) across all sessions

Inputs: page, page_size, type, search, +1 more.

searchatlas_list_conversationsB

List conversation sessions, optionally filtered by agent

Inputs: agent_namespace, page, page_size, search.

searchatlas_list_playbooksB

List available playbooks (automation recipes), optionally filtered by agent or ownership

Inputs: filter, agent_namespace, search, page, +1 more.

searchatlas_list_projectsB

List SearchAtlas projects for the authenticated user

Inputs: page, page_size, search.

searchatlas_llm_visibilityC

LLM brand monitoring — tracks how AI models reference your brand and competitors

Inputs: message (required), project_id, playbook_id, plan_mode.

searchatlas_orchestratorB

Multi-agent coordinator — routes queries to the best specialized agent (SEO, content, PPC, etc.)

Inputs: message (required), project_id, playbook_id, plan_mode.

searchatlas_otto_seoC

On-page SEO automation — deploys technical fixes, schema markup, and content optimizations

Inputs: message (required), project_id, playbook_id, plan_mode.

searchatlas_ppcC

PPC / Google Ads management — campaign creation, bid strategy, and performance analysis

Inputs: message (required), project_id, playbook_id, plan_mode.

searchatlas_run_playbookC

Execute a playbook (automation recipe) on a project using the appropriate agent

Inputs: playbook_id (required), project_id (required), message, agent_namespace.

searchatlas_site_explorerC

Site audit and analysis — crawl data, backlink profiles, and competitive intelligence

Inputs: message (required), project_id, playbook_id, plan_mode.

searchatlas_website_studioC

Website builder — creates and edits pages, layouts, and site structure

Inputs: message (required), project_id, playbook_id, plan_mode.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 16 tools

    Disambiguation4/5

    Most tools have distinct purposes targeting specific SEO and marketing domains (e.g., keywords, content, PPC), but there is some overlap in scope between 'searchatlas_site_explorer' (site audit) and 'searchatlas_otto_seo' (on-page SEO), which could cause confusion as both involve site analysis and optimization. The descriptions help clarify, but boundaries are not perfectly sharp.

    Naming Consistency5/5

    All tool names follow a consistent 'searchatlas_' prefix with snake_case and clear verb_noun patterns (e.g., 'searchatlas_create_project', 'searchatlas_list_projects'), making them predictable and easy to parse. There are no deviations in naming conventions across the set.

    Tool Count4/5

    With 16 tools, the count is slightly high but reasonable for a comprehensive SEO and marketing platform, covering areas like content, keywords, PPC, and site management. It feels a bit heavy but not excessive, as each tool appears to serve a distinct function within the broad domain.

    Completeness4/5

    The tool set provides broad coverage for SEO and marketing tasks, including project management, content generation, keyword research, and automation. Minor gaps exist, such as no explicit tools for deleting projects or managing user settings, but core workflows are well-supported, and agents can likely work around these omissions.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that enables AI assistants to perform SEO automation tasks including keyword research, SERP analysis, and competitor analysis through Google Ads API integration.
      1
      ISC
    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that connects AI assistants to SEO platforms like Google Search Console, GA4, Bing Webmaster Tools, and Adobe Analytics, enabling natural language queries about SEO performance.
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Professional Google Search Console MCP server providing 40+ SEO tools for performance analysis, content decay, CTR opportunities, and more, enabling real search data in clients like Cursor and Claude.
      40
      18 npm
      6
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that gives AI assistants 23 SEO tools for rank tracking, Google Analytics, site audits, keyword research, competitive analysis, and more, accessible through natural language.
      25
      12
      MIT