Как установить OpenCode и подключить MCP-сервер: ИИ-помощник для SEO без кода

Об ИИ-агентах сейчас много говорят, но в России их не всегда просто использовать. Claude Code и Codex требуют API-ключи Anthropic или OpenAI, а оплатить их российской картой не получится. Эту проблеме частично решает OpenCode — бесплатный агент с открытым кодом, который можно подключать к разным ИИ-моделям.

Для подключения моделей можно использовать API Router PR-CY. Он дает доступ к моделям, принимает оплату в рублях и работает без VPN и зарубежной карты.

В этой инструкции разберем, как установить OpenCode, подключить недорогую модель и добавить MCP-сервер PR-CY. После настройки инструмент можно будет использовать для задач SEO: например, собрать запросы, посмотреть конкурентов или подготовить короткий отчет. Код писать не нужно, достаточно скопировать команды и один файл настроек.

Все шаги мы проверили на обычном компьютере. Команды и настройки из инструкции работают.

Что такое OpenCode и чем он отличается от ChatGPT

OpenCode — бесплатный ИИ-агент с открытым кодом. Он работает в терминале. У проекта 172 000 звезд на GitHub и лицензия MIT. За саму программу платить не нужно, оплачиваются только запросы к модели, которую вы подключите.

Программа работает на Windows, macOS и Linux. Также есть приложение для компьютера и расширения для редакторов кода.

Обычный чат-бот, например ChatGPT в браузере, отвечает на отдельные вопросы, а данные вы переносите вручную: копируете текст, загружаете файлы, вставляете таблицы. Агент работает иначе: вы ставите задачу, а он проходит нужные шаги и возвращает результат.

OpenCode запускается в папке, читает файлы, редактирует их и создает новые. Он даже может писать код и собирать сайты.

К примеру, вместо цепочки «открыть Вордстат, проверить частотность, перенести данные в чат, собрать таблицу» можно сразу поставить задачу: «Собери семантику по теме Х». Агент проверит запросы и вернет таблицу, которую можно перенести в ядро, бриф или файл для дальнейшей кластеризации.

OpenCode изначально делали для программистов, но в SEO-задачах писать код не придется, потому что работа похожа на обычный чат. Вы описываете задачу простыми словами и получаете ответ в формате, который запросили — текст, список или таблицу.

Почему API OpenAI не работает из России и что делать

России нет в списке стран, где официально работает OpenAI API. Причем Казахстан, Армения и Грузия в этом списке есть, а вот России нет. В документации OpenAI указано, что если заходить из неподдерживаемой страны, аккаунт могут заблокировать.

Есть и другие ограничения. Для регистрации нужен иностранный номер, для оплаты — зарубежная карта, для стабильных запросов — VPN. А покупать ключи у перекупщиков рискованно, потому что аккаунт также могут заблокировать.

Безопаснее использовать OpenAI-совместимый шлюз в России. API Router PR-CY принимает запросы в том же формате, что и OpenAI, и возвращает ответы моделей. Вы оплачиваете доступ рублями с российской карты и работаете без VPN.

Подробная инструкция по подключению

OpenCode подключается к API Router почти так же, как к OpenAI. Нужно только указать другой адрес сервера.

Шаг 1. Получите API-ключ PR-CY

Если у вас еще нет аккаунта PR-CY, зарегистрируйтесь и оплатите тариф. Стоимость — от 990 ₽ в месяц. PR-CY создаст ключ автоматически, просто откройте в кабинете раздел «Настройки API» и скопируйте его.

Один ключ открывает доступ к двум направлениям: API Router — к моделям, а MCP-сервер — к SEO-данным. Сохраните ключ, он понадобится для подключения модели и MCP-сервера.

Шаг 2. Установите OpenCode на Windows и macOS

OpenCode устанавливается через терминал. Это окно в операционной системе, где команды вводятся текстом.

Установка на Windows

Откройте программу PowerShell от имени администратора и введите одну из команд. Какая подойдет, зависит от того, что уже установлено в системе:

npm install -g opencode-ai

или, если установлен пакетный менеджер Scoop:

scoop install opencode

Установка на macOS

Откройте «Терминал» с помощью Cmd+Пробел и введите команду установки:

brew install anomalyco/tap/opencode

Если Homebrew не установлен, используйте универсальный способ:

curl -fsSL https://opencode.ai/install | bash

Установка на Linux (Ubuntu, Debian и другие версии)

Откройте терминал через Ctrl+Alt+T и введите команду с сайта OpenCode:

curl -fsSL https://opencode.ai/install | bash

Если у вас уже установлен Node.js, OpenCode можно поставить так:

npm install -g opencode-ai

На Arch Linux пакет есть в репозитории:

sudo pacman -S opencode

Проверьте, что установка прошла нормально. Для этого выполните команду:

opencode --version

Терминал должен показать номер версии, например: 1.16.2. Если вы редко работаете с терминалом, не пропускайте проверку версии. Она сразу показывает, что команда установки отработала и система видит OpenCode.

А если появилась ошибка command not found, закройте терминал, откройте его заново и снова проверьте версию.

Шаг 3. Подключите модель через API Router

Теперь OpenCode нужно показать, к какому API обращаться за моделями. Для этого создайте файл opencode.json.

Путь к файлу:

• macOS/Linux: ~/.config/opencode/
• Windows: C:\Users\ВашеИмя\.config\opencode\

Вставьте в файл настройки:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "prcy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "PR-CY",
      "options": {
        "baseURL": "https://api.pr-cy.ru/v1"
      },
      "models": {
        "fast-mini": {
          "id": "prcy-5.4-mini",
          "name": "GPT-5.4 mini",
          "limit": { "context": 200000, "output": 32000 }
        },
        "flagship-5.5": {
          "id": "prcy-5.5",
          "name": "GPT-5.5",
          "limit": { "context": 200000, "output": 32000 }
        }
      }
    }
  }
}

Мы проверили этот файл на рабочем компьютере, его можно копировать целиком. После этого добавьте API-ключ:

1. Откройте терминал.
2. Выполните команду: opencode auth login.
3. В списке выберите Other.
4. Введите ID провайдера: prcy
5. Вставьте ключ из шага 1.

Какую модель выбрать

В API Router доступно пять моделей. Для задач SEO с агентом лучше начать с prcy-5.4-mini. Она подходит для работы с инструментами, поддерживает контекст 200 000 токенов и расходует меньше лимитов, чем prcy-5.4 и prcy-5.5.

В наших тестах prcy-5.4-mini хватило для семантики, проверки выдачи и коротких отчетов. Для длинных текстов и задач, где важны формулировки, можно переключиться на старшую модель.

Проверьте подключение. Запустите opencode, выберите модель GPT-5.4 mini через команду /models и задайте любой вопрос. Если ответ появился, API Router подключен правильно.

Шаг 4. Подключаем MCP-сервер PR-CY

Создатели стандарта сравнивают MCP с USB-C для ИИ-приложений. Один разъем USB-C подходит к разным устройствам. Точно так же MCP связывает агента с разными сервисами, которые поддерживают этот протокол: Claude, ChatGPT, Cursor, VS Code, OpenCode.

MCP-сервер — это точка подключения отдельного сервиса. Сервер PR-CY дает доступ к 48 инструментам: можно проверить частотность в Вордстате, посмотреть выдачу Яндекса и Google, узнать позиции сайта, получить данные Метрики и Search Console, забрать текст и структуру страницы.

OpenCode может сам обращаться к внешним инструментам, а не ждать, пока пользователь скопирует данные вручную. Без MCP нейросеть отвечает по памяти, то есть по данным, на которых ее обучили. Частотность, позиции и текущую выдачу она может просто придумать. С MCP инструмент получает реальные цифры и работает уже с ними. Каждый вызов виден в окне программы, поэтому можно проверить, откуда взялись данные.

Откройте тот же файл opencode.json и добавьте блок mcp рядом с блоком provider. Обратите внимание, что добавлять нужно не внутрь provider, а на верхний уровень файла.

"mcp": {
  "pr-cy": {
    "type": "remote",
    "url": "https://mcp-server.pr-cy.ru",
    "enabled": true,
    "headers": {
      "Authorization": "Bearer ВАШ_API_КЛЮЧ"
    }
  }
}

Замените ВАШ_API_КЛЮЧ на ключ из шага 1. Это тот же ключ, который вы указали для API Router.

Вот что у вас должно получиться:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "prcy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "PR-CY",
      "options": {
        "baseURL": "https://api.pr-cy.ru/v1"
      },
      "models": {
        "fast-mini": {
          "id": "prcy-5.4-mini",
          "name": "GPT-5.4 mini",
          "limit": {
            "context": 200000,
            "output": 32000
          }
        },
        "flagship-5.5": {
          "id": "prcy-5.5",
          "name": "GPT-5.5",
          "limit": {
            "context": 200000,
            "output": 32000
          }
        }
      }
    }
  },
  "mcp": {
    "pr-cy": {
      "type": "remote",
      "url": "https://mcp-server.pr-cy.ru",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer ВАШ_API_КЛЮЧ"
      }
    }
  }
}

Если после изменения файла OpenCode не запускается, сначала проверьте opencode.json в любом JSON-валидаторе. Часто причина в лишней или пропущенной запятой.

Перезапустите OpenCode, после этого вам станут доступны инструменты PR-CY.

Что доступно после подключения

Можно работать с несколькими типами данных:

• Вордстат и выдача: проверить частотность запроса и посмотреть топ Яндекса или Google.
• Позиции: узнать, где находится ваш сайт или конкурент по нужным ключам.
• Метрика, Search Console и Вебмастер: собрать данные по визитам, кликам, показам, CTR и страницам.
• Контент страниц: получить текст, title, description и структуру заголовков.
• Статьи и изображения: подготовить черновик материала или сгенерировать изображение по описанию.

Инструменты с данными ваших проектов, например позиции, Метрика и Search Console, работают для сайтов, которые вы добавили в PR-CY. Вордстат, выдача и разбор страниц работают с любыми доменами, и проект для них не нужен.

Несколько сценариев использования

Мы проверили каждый пример на практике. В этом разделе вы найдете готовые промпты, которые можно адаптировать под свой сайт или задачу. Запустите opencode, скопируйте подходящий промпт и подставьте свои данные.

1. SEO-отчет по сайту

Через MCP pr-cy сделай отчет по проекту site.ru: визиты из Метрики за последние 7 дней и сводка по позициям ключевых слов. Выведи короткую сводку с цифрами.

Инструмент обращается к Метрике и данным по позициям, затем собирает короткую сводку. В отчете отдельно видны запросы с просадкой и размер изменения.

Такой ответ можно использовать как черновик для клиентского отчета или внутреннего статуса по проекту. Если нужен готовый файл, следующим сообщением попросите оформить результат в HTML или Markdown.

2. Запросы из Вордстата

Собери мини-семантику по теме «ремонт стиральных машин»: проверь в Вордстате частотность 5 запросов с этой фразой и выведи таблицу «запрос — показов в месяц» по убыванию.

За один вызов агент проверяет несколько запросов и возвращает таблицу с частотностью. Тему можно заменить на свою и использовать результат как черновик для дальнейшей проработки семантики.

После этого можно попросить сгруппировать запросы по интентам: информационные, коммерческие, брендовые, локальные. Так таблица станет основой для структуры страницы или контент-плана.

3. Статья по топу выдачи

Получи топ-10 Яндекса по запросу «как выбрать робот-пылесос», изучи тайтлы конкурентов и предложи структуру статьи: H1 и 5 разделов H2.

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

Не копируйте структуру конкурентов один в один, вытащите из нее данные: что поисковая выдача уже считает важным, какие блоки повторяются у нескольких сайтов и где можно добавить свой опыт или данные.

Тут MCP полезен потому, что структура строится по текущей выдаче, а не по данным из обучения модели.

4. Разбор страницы конкурента

Получи структуру страницы https://конкурент.ру/статья в формате structure и ответь, какой у нее title, сколько заголовков H2 и о чем текст.

Вы получите метатеги, заголовки и статистику страницы. Этого хватит, чтобы сравнить H2, title и общий охват темы.

Проанализируйте не только количество заголовков, но и логику раскрытия темы. Например, конкурент может подробно закрывать выбор товара, но почти не объяснять ошибки при покупке. Это можно использовать при доработке своей статьи.

5. Отчет по трафику из Метрики

Через MCP pr-cy покажи по проекту site.ru динамику визитов за месяц, топ-5 источников и страницы-лидеры по трафику.

Данные подтягиваются из Метрики, а результат собирается в таблицу: динамика визитов, основные источники и страницы с самым большим трафиком. Такой отчет можно использовать для еженедельной проверки. Видно, где меняется трафик и какие страницы дают основной объем визитов.

Если трафик просел, не стоит сразу думать, что проблема в SEO. Попросите сравнить периоды, отдельно посмотреть органику и проверить страницы, где падение сильнее всего. Так вам будет проще отделить сезонность, рекламные изменения и реальные просадки в поиске.

Сколько это стоит

Подписка на OpenCode не нужна, он бесплатный. Вы оплачиваете только тариф PR-CY. Стоимость — от 990 ₽ в месяц.

Лимиты расходуются на запросы к модели и вызовы SEO-инструментов. Один лимит стоит около 0,5 ₽, точная цена зависит от тарифа.

Разберем пример со сбором семантики на prcy-5.4-mini.

Запрос со служебными подсказками для агента занимает примерно 10 000 символов на входе. Это 4 лимита. Ответ с таблицей занимает около 1000 токенов, еще 1 лимит. Итого получается примерно 5 лимитов, то есть 2–3 ₽ за задачу.

Длинные задачи стоят дороже. Например, черновик статьи по топу может потребовать десятки лимитов, потому что агент передает модели тексты конкурентов, а это большой объем данных.

Частые проблемы и как их решить

Подробности о моделях и ценах смотрите на странице API Router. Полный список инструментов есть на странице MCP-сервера.

Вопросы и ответы

OpenCode бесплатный?

Да, у проекта открытый код и лицензия MIT. Вы платите только за запросы к модели. В этой схеме расходуются лимиты тарифа PR-CY.

Нужен ли VPN?

Нет, API Router и MCP-сервер PR-CY работают из России напрямую.

Работает ли OpenCode на Windows?

Да, OpenCode ставится через npm или Scoop в PowerShell. macOS и Linux тоже поддерживаются.

Можно ли подключить MCP PR-CY к Claude Desktop или Cursor?

Да, тот же адрес сервера и тот же ключ работают в Claude Desktop, Cursor, Windsurf и других клиентах. Меняется только формат файла настроек. Подробнее можно узнать в статье Подключаем MCP к Cursor IDE и Claude: пошаговый гайд.

Безопасно ли указывать API-ключ в файле настроек?

Ключ хранится на вашем компьютере и передается по HTTPS. Сервер не пишет его в логи. Если ключ попал не в те руки, отзовите его в настройках API и создайте новый.

Какая модель лучше для задач SEO?

Начните с prcy-5.4-mini: она подходит для работы с инструментами и расходует меньше лимитов, чем старшие модели. Для сложных текстов можно переключаться на prcy-5.5 командой /models.