MCP-сервер SurfRank

Позвольте вашему ИИ-агенту запускать отчеты о видимости в ИИ, исследовать ключевые слова и отслеживать конкурентов на SurfRank — прямо из окна чата.

Этот пакет предоставляет публичный API SurfRank в виде инструментов Model Context Protocol (MCP), поэтому любой ИИ-ассистент с поддержкой MCP — Claude Desktop, Claude Code, Cursor, Windsurf, коннекторы ChatGPT MCP и другие — может вызывать SurfRank от вашего имени.

Что такое SurfRank?

SurfRank измеряет, насколько заметен ваш бренд в ответах ИИ (ChatGPT, Perplexity, Gemini, Claude, Grok, DeepSeek, Meta AI). Он проверяет ваши отслеживаемые ключевые слова в каждой системе, оценивает упоминания вашего бренда по сравнению с конкурентами и выявляет возможности для контента, которые дадут максимальный результат.

Related MCP server: DataForSEO MCP Server

Что такое MCP?

Model Context Protocol — это открытый стандарт от Anthropic, который позволяет ИИ-агентам обнаруживать и вызывать внешние инструменты. Установите этот сервер один раз, и ваш агент получит 24 новые возможности — никаких API плагинов, никакой сложной настройки OAuth, никакого связующего кода.

Что можно попросить у агента после подключения

💬 "Создай проект SurfRank для surfrank.ai в индустрии SaaS, а затем отслеживай эти 10 ключевых слов…"

💬 "Что показал мой последний отчет о видимости в ИИ? В каких системах отсутствует мой бренд?"

💬 "Запусти быструю проверку для competitor.com и сравни ее с моим показателем."

💬 "Перечисли мои 5 лучших возможностей для контента и напиши черновики статей для самых эффективных из них."

Агент выбирает нужный инструмент, вызывает API SurfRank с вашим ключом и отвечает на естественном языке. Кредиты списываются с вашего аккаунта SurfRank по тем же тарифам, что и при прямых вызовах API.

Требования

• Node.js 18 или новее (требуется для MCP SDK).

• API-ключ SurfRank на тарифном плане Pay As You Go. Создайте его на app.surfrank.ai/api-management.

• Клиент с поддержкой MCP (см. раздел Конфигурация).

Установка

Запуск «на лету» с помощью npx — установка не требуется:

npx -y @surfrank/mcp-server

Или установите глобально:

npm install -g @surfrank/mcp-server

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

Выберите свой клиент ниже и вставьте фрагмент в его конфигурационный файл MCP.

Claude Desktop

Отредактируйте конфигурационный файл Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": {
        "SURFRANK_API_KEY": "sr_your_key_here"
      }
    }
  }
}

Перезапустите Claude Desktop. Вы должны увидеть surfrank в меню MCP-серверов.

Cursor

Отредактируйте ~/.cursor/mcp.json (или используйте Settings → MCP → Add server):

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": {
        "SURFRANK_API_KEY": "sr_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add surfrank -- npx -y @surfrank/mcp-server
export SURFRANK_API_KEY=sr_your_key_here

Windsurf

Отредактируйте ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "surfrank": {
      "command": "npx",
      "args": ["-y", "@surfrank/mcp-server"],
      "env": { "SURFRANK_API_KEY": "sr_your_key_here" }
    }
  }
}

Доступные инструменты

Сервер предоставляет каждый эндпоинт публичного API SurfRank в качестве инструмента (всего 24). Ваш агент обнаруживает их автоматически — вам не нужно перечислять их в своем промпте.

Каждый инструмент соответствует 1:1 REST-эндпоинту по адресу https://api.surfrank.ai/api/v1/public/*.

API-ключи с ограниченной областью действия

Если вы создадите API-ключ с ограничением по проекту, MCP-сервер сможет работать только с этим проектом. Любой вызов инструмента, ссылающийся на другой ID проекта, будет отклонен с ошибкой 403 от API SurfRank, и эта ошибка появится дословно в ответе агента.

Это рекомендуемая настройка, если вы подключаете одну рабочую область или одного члена команды к одному бренду.

Использование кредитов

Кредиты списываются с вашего аккаунта SurfRank согласно тем же тарифам, что и при прямых вызовах API:

Каждый ответ инструмента включает объект credits, чтобы ваш агент (и вы) могли отслеживать использование в режиме реального времени.

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

Отладка

Используйте официальный инспектор MCP для прямого взаимодействия с сервером — это полезно при подключении нового клиента или диагностике проблем с соединением:

SURFRANK_API_KEY=sr_your_key_here \
  npx @modelcontextprotocol/inspector npx @surfrank/mcp-server

Инспектор открывает браузерный интерфейс, где вы можете просматривать список инструментов и вызывать их вручную, точно так же, как это делал бы ИИ-агент.

Примечания по безопасности

• API-ключи отображаются один раз при создании и хранятся в виде SHA-256 хешей на серверах SurfRank. Если вы потеряли ключ, аннулируйте его и создайте новый — восстановить его невозможно.

• Учетные данные остаются в вашем локальном конфигурационном файле MCP. Этот пакет никогда не записывает их на диск и не отправляет данные на сторонние серверы.

• Каждый API-ключ ограничен лимитом в 60 запросов в минуту. Превышение лимита возвращает HTTP 429.

Ссылки

• 🌐 SurfRank — surfrank.ai

• 🔑 Управление API — app.surfrank.ai/api-management

• 📘 Документация публичного API — во вкладке API Management → Documentation

• 🐛 Проблемы — github.com/SurfRankAI/mcp-server/issues

• 📦 npm — @surfrank/mcp-server

Лицензия

MIT © SurfRank Pte. Ltd. — см. LICENSE.