Как установить 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. Подготовка (только для Windows)

На macOS и Linux заранее ставить ничего не нужно — команда из шага 3 сама установит OpenCode, если его ещё нет.

На Windows нужен только Node.js — через него ставится OpenCode:

1. Откройте nodejs.org и скачайте версию LTS.
2. Запустите установщик, на всех шагах нажимайте «Next», галочку «Add to PATH» оставьте включённой.
3. Закройте и заново откройте PowerShell — без перезапуска система не увидит новую команду.

Дальше команда из шага 3 сама поставит OpenCode и настроит подключение к PR-CY.

Шаг 3. Установите и подключите одной командой

Одна команда делает всё: ставит OpenCode (если его ещё нет), спрашивает API-ключ из шага 1, создаёт файл opencode.json, прописывает модели PR-CY и MCP-сервер с SEO-инструментами. Вручную ничего редактировать не нужно.

macOS / Linux — в терминале:

bash <(curl -fsSL https://a.pr-cy.ru/opencode/install.sh)

Windows — в PowerShell:

irm https://a.pr-cy.ru/opencode/install.ps1 | iex

Когда установщик попросит ключ — вставьте его и нажмите Enter. При вставке ключ не отображается, это нормально. В списке моделей останутся только модели PR-CY: посторонние провайдеры не подмешиваются, а по умолчанию выбрана GPT-5.4 mini.

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

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

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

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

Шаг 4. Что даёт MCP-сервер PR-CY

Установщик из шага 3 уже подключил MCP-сервер — отдельно настраивать ничего не нужно. Коротко, что это и зачем.

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

Сервер PR-CY дает доступ к 48 инструментам: частотность в Вордстате, выдача Яндекса и Google, позиции сайта, данные Метрики и Search Console, текст и структура страниц.

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

Ручная настройка (если установщик не подошёл)

Конфиг можно собрать и руками: создайте файл opencode.json (macOS/Linux — ~/.config/opencode/, Windows — C:\Users\ВашеИмя\.config\opencode\), вставьте конфиг ниже и замените ВАШ_КЛЮЧ на ключ из шага 1 в двух местах (для модели и для MCP — это один и тот же ключ).

{
  "$schema": "https://opencode.ai/config.json",
  "enabled_providers": ["prcy"],
  "model": "prcy/prcy-5.4-mini",
  "provider": {
    "prcy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "PR-CY",
      "options": {
        "baseURL": "https://api.pr-cy.ru/v1",
        "apiKey": "ВАШ_КЛЮЧ"
      },
      "models": {
        "prcy-5.4-mini": {
          "name": "GPT-5.4 mini",
          "limit": {
            "context": 200000,
            "output": 32000
          }
        },
        "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 ВАШ_КЛЮЧ"
      }
    }
  }
}

Если после изменения файла 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?

Да. На Windows заранее нужен только Node.js, дальше команда из шага 3 сама ставит OpenCode и настраивает подключение. На 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.