SearchAtlas MCP Server
MCP-сервер SearchAtlas
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Это откроет ваш браузер. После входа в систему:
Нажмите F12 (или Cmd+Option+I на Mac), чтобы открыть инструменты разработчика (DevTools)
Перейдите на вкладку Console (Консоль)
Выполните:
localStorage.getItem("token")Скопируйте результат и вставьте его в терминал
CLI проверит ваш токен, сохранит его и выведет готовые к вставке конфигурации с автоматически определенными путями.
2. Добавление в ваш MCP-клиент
Claude Code
macOS / Linux:
claude mcp add searchatlas -e SEARCHATLAS_TOKEN=your-token -- npx -y searchatlas-mcp-serverWindows (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 автоматически определяет ваши пути и выводит конфигурации, которые можно скопировать и вставить.
Как найти ваши пути | Команда |
Полный путь к |
|
Директория глобальных npm-модулей |
|
Использование
Просто общайтесь естественным языком. ИИ сам выберет нужный инструмент:
"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
Команда | Описание |
| Войти, сохранить токен, вывести MCP-конфигурации |
| Проверить учетные данные + подключение к API |
| Вывести версию |
| Показать справку |
Все команды также работают через
npx searchatlas-mcp-server <команда>.
Инструменты
Инструменты обнаруживаются динамически с размещенного сервера v2 MCP — ваш клиент видит актуальный каталог (в настоящее время около 587 инструментов) без необходимости обновления пакета при появлении новых. Основные группы:
Префикс | Область | Примеры инструментов |
| OTTO SEO-автоматизация (70 инструментов) |
|
| Google Ads / PPC (76 инструментов) |
|
| Content Genius (74 инструмента) |
|
| Site Explorer (46 инструментов) |
|
| Профиль компании в Google (96 инструментов) |
|
| Тепловые карты локального SEO (19 инструментов) |
|
| Link Laboratory (24 инструмента) |
|
| Цифровой PR (20 инструментов) |
|
| Видимость для LLM (30 инструментов) |
|
| Отслеживание позиций ключевых слов (16 инструментов) |
|
| Brand Vault (25 инструментов) |
|
| Website Studio (8 инструментов) |
|
| Google Search Console (11 инструментов) |
|
| Social Hub (19 инструментов) |
|
| Контент-стратегия (12 инструментов) |
|
| Граф знаний (7 инструментов) |
|
| Сеть знаний о доменах (7 инструментов) |
|
| Индексатор (6 инструментов) |
|
| Конструктор отчетов (3 инструмента) |
|
| Пресс-релизы (14 инструментов) |
|
Выполните searchatlas check, чтобы увидеть актуальное количество, или попросите ваш MCP-клиент вывести список инструментов после подключения.
Конфигурация
Приоритет токена (побеждает первое совпадение)
Переменная окружения
SEARCHATLAS_TOKENПеременная окружения
SEARCHATLAS_API_KEYФайл
~/.searchatlasrc(создается командойsearchatlas login)
Переменные окружения
Переменная | Обязательно | Описание |
| Да | JWT-токен из SearchAtlas |
| Альтернатива | Аутентификация по API-ключу |
| Нет | Пользовательская конечная точка v2 MCP (по умолчанию: |
Клиенты с нативной поддержкой Streamable-HTTP
Если ваш MCP-клиент поддерживает Streamable HTTP напрямую, вы можете пропустить этот npm-пакет и подключиться к удаленному серверу за один шаг:
URL:
https://mcp.searchatlas.com/mcp/Транспорт: Streamable HTTP (JSON-RPC + SSE)
Заголовок:
Authorization: Bearer <SEARCHATLAS_TOKEN>
Устранение неполадок
Ошибка | Решение |
| Используйте полные пути (см. Почему полные пути?) или повторно выполните |
| Используйте |
| Выполните |
| Выполните |
| Токен истек — выполните |
| Проверьте сеть; выполните |
Инструменты не отображаются | Перезапустите ваш 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Требования
Node.js >= 18
Аккаунт SearchAtlas — зарегистрироваться здесь
Лицензия
MIT
Available Tools
16 toolssearchatlas_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
Scored across 16 tools
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.
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.
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.
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
Related MCP Connectors
Hosted MCP server for marketing agencies: connect Google Ads, GA4, Search Console, Meta, LinkedIn and more to Claude or ChatGPT. Pull reports and make changes via OAuth login, no setup.
Remote MCP server that gives Claude, ChatGPT, Cursor or any MCP client Google search volume, CPC, competition and similar keywords for 50+ countries. Works with no signup at 20 lookups a day; sign in with OAuth or an API key for higher limits, or $4.99 a month for unlimited.
Meta Ads and Google Ads MCP server: 250+ tools for Claude, ChatGPT, Cursor and Codex.
SEO research, Search Console, GA4 and PPC tools for Claude and ChatGPT.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server that enables AI assistants to perform SEO automation tasks including keyword research, SERP analysis, and competitor analysis through Google Ads API integration.1ISC
- AlicenseNot gradedqualityCmaintenanceAn 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
- AlicenseBqualityDmaintenanceProfessional 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.4018 npm6MIT
- AlicenseBqualityDmaintenanceAn 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.2512MIT