Краткое саммари

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

Hermes Agent устанавливается на компьютер или сервер. Он помнит прошлые разговоры, запускает задачи по расписанию и отправляет результаты в терминал, на почту или в корпоративный чат. Ему можно поручить регулярную работу и получать готовый результат.

Однако для работы агенту нужна языковая модель. Можно использовать, например, OpenRouter или подписку Anthropic, но для них могут понадобиться зарубежная карта и VPN. Кроме того, Hermes Agent по умолчанию не знает данных вашего сайта. Он может читать файлы и выполнять команды в терминале, но не видит позиции, частотность запросов и данные Метрики.

Чтобы полноценно работать с Hermes Agent, можно подключить к нему языковые модели через PR-CY API Router и открыть доступ к данным сайта через MCP-сервер PR-CY. В материале разбираемся, как это сделать.

Кому пригодится статья:

SEO-специалистам, владельцам сайтов и маркетологам, которые хотят автоматизировать регулярные задачи с помощью Hermes Agent: анализировать позиции и спрос, получать данные Метрики и запускать работу по расписанию.

Что такое Hermes Agent

Hermes Agent — это открытый ИИ-агент от лаборатории Nous Research, который запускается на вашем устройстве или сервере и работает как постоянный фоновый процесс. Код лежит на GitHub под лицензией MIT: на август 2026 года у репозитория NousResearch/hermes-agent 226 853 звезды, последний релиз — v2026.8.3 от 3 августа.

Ключевое отличие от чат-бота — замкнутый цикл. Агент решает задачу, записывает, что сработало, и в следующий раз пользуется собственной записью вместо того, чтобы начинать с нуля.

Память между сессиями

Hermes хранит данные локально, в каталоге ~/.hermes/:

Что	Где	Зачем
Личность агента	SOUL.md	Кто он, как отвечает, что для него важно
Память	memories/	Факты о вас, проектах, договорённостях
Навыки	skills/	Процедуры, которые агент собрал сам
История	sessions/	Прошлые диалоги, по ним работает поиск
Настройки	config.yaml	Модель, инструменты, MCP-серверы
Секреты	.env	Ключи и токены

Документация называет память агента «ограниченной и отобранной». Hermes сохраняет не всю переписку, а только сведения, которые могут пригодиться позже. По прошлым сессиям работает поиск, поэтому можно спросить: «Что мы решили по структуре каталога в июне?» Искать нужный диалог вручную не придётся.

Навыки, которые агент создает сам

Навык, или skill, — это инструкция, которую Hermes загружает для конкретной задачи. Некоторые навыки доступны сразу после установки. Другие агент создаёт сам: если задача выполнена удачно, он сохраняет порядок действий и может повторить его в следующий раз.

При этом сама нейросеть не дообучается. Модель остаётся прежней. Меняются только память, набор навыков и история разговоров, доступная для поиска.

Расписание, каналы связи и субагенты

Hermes может выполнять задачи без команды пользователя:

• Планировщик. Задачу можно задать обычной фразой, например: «Каждый будний день в 9 утра пришли сводку». Также поддерживаются cron-выражения. Расписание можно изменить, приостановить или удалить.
• Каналы связи. Агент отправляет сообщения по почте, через Matrix, Mattermost, ntfy, вебхуки, SMS, Home Assistant, Telegram, Discord, Slack, WhatsApp, Signal и другие сервисы. Всего доступно почти 30 платформ.
• Субагенты. Hermes делит крупную задачу на части и передаёт их отдельным агентам. У каждого свой контекст и набор инструментов. Одновременно могут работать до трёх потоков.
• Терминал и браузер. Агент выполняет команды, читает и редактирует файлы, открывает сайты. Терминал можно изолировать в Docker или подключить к удалённому серверу по SSH. За это отвечает параметр terminal.backend.

Hermes, Claude Code, OpenClaw и n8n — в чем разница

Инструмент	Где работает	Помнит контекст между запусками	Работает автономно	Для каких задач подходит
Hermes Agent	На вашем компьютере или VPS	Да, использует память и навыки	Да, запускается по расписанию и пишет в мессенджеры	Мониторинг, регулярные сводки и другие повторяющиеся задачи
Claude Code, Codex, Cursor	На вашем компьютере, внутри проекта	Частично, в пределах проекта	Нет, их нужно запускать вручную	Работа с кодом в редакторе
OpenClaw	На вашем компьютере или сервере	Да	Да	Похож на Hermes, но отличается набором инструментов
n8n, Make	На сервере или в облаке	Нет, состояние хранится в сценарии	Да, запускается по триггерам	Заранее заданные сценарии по принципу «если А, то Б»

Выбор зависит от задачи. Если процесс можно один раз представить в виде блок-схемы и он редко меняется, подойдут n8n или Make. Если нужно оценить ситуацию — например, найти изменения и понять, требуют ли они внимания, — лучше использовать агента.

Какие задачи можно поручить Hermes Agent

В обзорах часто приводят бытовые примеры: составить список покупок, проверить погоду или свободное место на диске. Hermes с этим справляется, но в работе с сайтом полезнее другие сценарии.

Задачи, которые агент может выполнять сам

Регулярный мониторинг. Hermes проверяет позиции, сравнивает их с предыдущей неделей, находит просевшие страницы и присылает отчёт. Проверку можно назначить, например, на 8:00. Не придётся каждое утро тратить 20–40 минут на просмотр таблиц.

Обработка выгрузок. Агент разбирает несколько тысяч строк из Вордстата, отчёт Метрики или данные Search Console. Он группирует записи, ищет аномалии и готовит краткое резюме.

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

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

Типовые технические проверки. Hermes проверит, отвечает ли сервер, доступен ли robots.txt, не изменилась ли каноническая ссылка и не появился ли noindex во всём разделе.

Что не стоит поручать агенту

Hermes может ошибиться, поэтому действия с серьёзными последствиями должны оставаться под контролем человека.

• Необратимые операции. Не разрешайте агенту самостоятельно удалять файлы, редактировать сайт в продакшене, менять robots.txt или настраивать редиректы.
• Операции с деньгами. Ставки в рекламе, платежи и смену тарифов лучше подтверждать вручную.
• Публикации от вашего имени. Агент может подготовить статью, ответ клиенту или комментарий, но отправлять их следует после проверки.
• Изменения с высокой ценой ошибки. Смену структуры сайта, склейку доменов и массовое редактирование шаблонов нельзя проводить без участия специалиста.

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

Что меняется в работе

Задача	Что делает агент	Как это делали раньше
Утренняя сводка по позициям	Получает свежие данные, сравнивает их с предыдущим срезом и отправляет отчёт в чат или на почту	Открывали сервис, просматривали таблицы и самостоятельно отслеживали динамику
Проверка контента конкурентов	Собирает заголовки и объём страниц из топа, отмечает изменения	Открывали десять вкладок и сравнивали страницы вручную
Сбор семантики	Получает частотность из Вордстата, удаляет неподходящие запросы и группирует остальные	Выгружали данные в Excel и размечали вручную
Анализ просадки	Сопоставляет позиции, клики и визиты за выбранный период, указывает возможные причины	Сверяли три отчёта в разных интерфейсах
Черновик статьи	Собирает структуру по ключевым словам и поисковой выдаче, затем готовит первый вариант текста	Тратили около часа на план и начало статьи

Что понадобится для запуска

Для работы Hermes Agent нужны три компонента. Навыки программирования не обязательны, но несколько команд в терминале выполнить придётся.

1. Компьютер или сервер

Hermes можно установить на ноутбук с macOS, Windows или Linux. В этом случае агент будет работать, пока компьютер включён.

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

2. Языковая модель

Сам Hermes не генерирует ответы. На каждом шаге он обращается к языковой модели, поэтому понадобится API-ключ OpenAI-совместимого сервиса.

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

3. Инструменты

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

Эти данные агент будет получать через MCP-сервер PR-CY. Его подключение разберём в отдельном разделе.

Установка Hermes Agent

Рассмотрим три варианта: десктопное приложение, установку одной командой и развёртывание на VPS. Во всех случаях в системе появится глобальная команда hermes.

Способ 1. Десктопное приложение

Это самый простой вариант для macOS и Windows. Скачайте установщик на сайте проекта и запустите его. Он добавит и графическое приложение, и консольную версию Hermes — вводить команды для установки не потребуется.

На macOS может появиться предупреждение о приложении от неизвестного разработчика. Разрешить его запуск можно в разделе «Системные настройки» → «Конфиденциальность и безопасность».

Способ 2. Установка одной командой

Для Linux, macOS, WSL2 и Android с Termux выполните:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Для Windows откройте PowerShell и выполните:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Установщик загрузит зависимости, клонирует репозиторий, создаст виртуальное окружение и зарегистрирует команду hermes.

Файлы размещаются в следующих каталогах:

Вариант установки	Код агента	Исполняемая команда	Данные
Для текущего пользователя	~/.hermes/hermes-agent/	~/.local/bin/hermes	~/.hermes/
Общесистемный	/usr/local/lib/hermes-agent/	/usr/local/bin/hermes	/root/.hermes/

После установки перезапустите терминал: source ~/.bashrc

Способ 3. Установка на VPS

На сервере действует та же схема, но запускать агента от root не стоит. Создайте для Hermes отдельного пользователя:

sudo adduser hermes
sudo usermod -aG sudo hermes
su - hermes

После переключения на нового пользователя выполните команду установки:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Отдельная учётная запись ограничивает доступ агента к системе. Даже при ошибке он не получит права администратора на весь сервер. Выдавайте пользователю hermes только те разрешения, которые нужны для конкретных задач.

Проверка установки

Запустите встроенную диагностику: hermes doctor

Команда проверит окружение и покажет отсутствующие зависимости или ошибки конфигурации.

Если терминал отвечает: hermes: command not found, сначала перезапустите оболочку: source ~/.bashrc (или source ~/.zshrc). Если это не помогло, проверьте, добавлен ли каталог ~/.local/bin в переменную PATH: 

echo $PATH

При необходимости добавьте его вручную:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Для Zsh замените .bashrc на .zshrc. После этого повторно выполните: hermes doctor

Подключение моделей через PR-CY API Router

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

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

Где получить API-ключ

Ключ автоматически создаётся после регистрации. Найти его можно в кабинете PR-CY в разделе «Настройки API».

Для обращения к моделям понадобится платный тариф. На бесплатном тарифе ключ доступен, но запросы через API Router не выполняются.

Основные адреса:

Base URL: https://api.pr-cy.ru/v1
Chat Completions: https://api.pr-cy.ru/v1/chat/completions

API-ключ даёт доступ к вашему балансу, поэтому не публикуйте его, не вставляйте в скриншоты и не храните в открытых файлах проекта.

Способ 1. Мастер настройки

Запустите мастер: hermes setup

В списке провайдеров выберите Custom Endpoint и укажите следующие параметры:

Поле	Значение
Base URL	https://api.pr-cy.ru/v1
API Key	ключ из раздела «Настройки API»
Model	prcy-5.6-luna
Context window	300000

Если соединение установлено, Hermes сообщит, что выбранная модель поддерживает вызов инструментов. Это обязательная возможность: без неё агент не сможет работать с терминалом, файлами и MCP-сервером.

Интерфейс и порядок вопросов могут немного отличаться в зависимости от установленной версии Hermes.

Почему нужно указать 300 000

Для моделей в API Router объём контекста указывается в символах и у большинства составляет около миллиона символов. Hermes запрашивает размер контекстного окна в токенах. В грубом пересчёте миллион символов соответствует примерно 300 тысячам токенов, поэтому в настройках указываем: 300000.

Если поставить миллион, Hermes будет рассчитывать на окно большего размера, чем доступно в действительности. На длинной задаче агент может получить ошибку вместо того, чтобы заранее сжать историю.

При вводе API-ключа проверьте, нет ли пробелов в начале или конце строки. Даже один лишний символ приведёт к ошибке авторизации. Чтобы сменить модель, не проходя весь мастер заново, выполните: hermes model

Способ 2. Настройка через файлы

Те же параметры можно задать вручную. Секреты храните в файле:

~/.hermes/.env<code></code>

Добавьте в него:

OPENAI_API_KEY=ваш_ключ_из_настроек_api
OPENAI_BASE_URL=https://api.pr-cy.ru/v1

Остальные параметры укажите в файле:

~/.hermes/config.yaml

Пример конфигурации:

model:
  default: "prcy-5.6-luna"
  provider: "custom"
  base_url: "https://api.pr-cy.ru/v1"
  api_key: "${OPENAI_API_KEY}"

Запись ${OPENAI_API_KEY} означает, что Hermes подставит значение из файла .env или переменной окружения.

Защитите файл с ключом

На Linux, macOS и VPS ограничьте доступ к .env:

chmod 600 ~/.hermes/.env

В результате читать и изменять файл сможет только его владелец. Не добавляйте .env в Git и не отправляйте его вместе с архивом проекта.

Два правила упрощают настройку:

1. Секреты храните в .env, остальные параметры — в config.yaml.
2. Фактический адрес шлюза определяет base_url. Если он задан, Hermes будет отправлять запросы по этому адресу, даже если в поле provider осталось другое значение.

Параметры применяются в следующем порядке — от самого высокого приоритета к самому низкому:

1. аргументы командной строки;
2. config.yaml;
3. .env;
4. значения по умолчанию.

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

hermes --model prcy-deepseek-chat

Посмотреть итоговую конфигурацию можно командой: hermes config. Изменить отдельный параметр:

hermes config set model prcy-5.6-luna

Названия параметров и синтаксис точечной настройки могут различаться между версиями Hermes. Если команда не принимается, проверьте встроенную справку: hermes config --help

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

В PR-CY API Router доступно несколько моделей. Расход рассчитывается в лимитах PR-CY: отдельно учитываются входные данные в символах и выходной текст в токенах.

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

Что выбрать:

prcy-5.6-luna — подходящая модель для первого запуска. Она сравнительно экономна, поддерживает изображения и может готовить развёрнутые ответы.

prcy-deepseek-chat — вариант для экономных и несложных задач. Обычно отвечает короче и не работает с изображениями.

prcy-deepseek-reasoner — модель для задач, требующих последовательного анализа. При выборе учитывайте, что её контекстное окно меньше, чем у большинства остальных моделей роутера.

prcy-5.6-sol и prcy-5.6-terra — модели для сложных разборов, где особенно важна аккуратность. Постоянно держать их основной моделью агента может быть дороже, поэтому лучше делать так:

• для повседневных задач — prcy-5.6-luna;
• для сложного разового анализа — запуск с параметром --model.

Например: hermes --model prcy-5.6-sol

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

Hermes нужна поддержка function calling, или вызова инструментов. Без неё модель сможет отвечать текстом, но не сможет давать агенту команды для работы с терминалом, файлами и MCP.

Сначала поместите API-ключ в переменную окружения, чтобы не вставлять секрет прямо в команду:

export PRCY_API_KEY='ваш_ключ'

Затем отправьте тестовый запрос:

curl -s https://api.pr-cy.ru/v1/chat/completions \
  -H "Authorization: Bearer $PRCY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "prcy-5.6-luna",
    "messages": [
      {
        "role": "user",
        "content": "Какая погода в Москве? Используй инструмент."
      }
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_weather",
          "description": "Погода в городе",
          "parameters": {
            "type": "object",
            "properties": {
              "city": {
                "type": "string"
              }
            },
            "required": ["city"]
          }
        }
      }
    ]
  }'

В правильном ответе должны присутствовать:

"finish_reason": "tool_calls"

и блок tool_calls с функцией get_weather.

После проверки удалите ключ из текущей сессии терминала: unset PRCY_API_KEY

Проверка подключения в Hermes

Запустите агента командой hermes. Откроется терминальный интерфейс. В его шапке проверьте:

• выбранную модель;
• адрес API-шлюза;
• доступность вызова инструментов;
• количество подключённых MCP-инструментов, если MCP уже настроен.

В шапке видно главное: какая модель подключена, через какой шлюз и сколько инструментов подтянулось из MCP

Задайте простой вопрос, например:

Напиши три пункта, которые нужно проверить после установки Hermes.

Если агент ответил, модель подключена.

Что делать при ошибке авторизации

Если Hermes сообщает об ошибке 401, Unauthorized или Invalid API key, проверьте:

1. активен ли платный тариф;
2. остались ли лимиты на балансе;
3. правильно ли скопирован ключ;
4. нет ли пробелов или кавычек в его значении;
5. указан ли адрес https://api.pr-cy.ru/v1;
6. перечитал ли Hermes обновлённые настройки после изменения .env.

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

if [ -n "$OPENAI_API_KEY" ]; then
  echo "Ключ задан"
else
  echo "Ключ не найден"
fi

После изменения конфигурации закройте Hermes, запустите его заново и повторите тест. Если обычный текстовый ответ приходит, но инструменты не вызываются, повторите проверку chat/completions с блоком tools.

Подключение MCP-сервера PR-CY: 48 инструментов внутри агента

Модель дала Hermes «мозг». Теперь подключим «руки» — инструменты, с помощью которых агент сможет получать реальные данные о сайте, поисковой выдаче и спросе.

Что такое MCP

MCP (Model Context Protocol) — стандарт, по которому ИИ-агенты взаимодействуют с внешними сервисами. MCP-сервер описывает доступные функции, а Hermes видит их как обычные инструменты и вызывает по мере необходимости.

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

MCP-сервер PR-CY предоставляет 48 инструментов, в том числе:

• проверку позиций;
• получение частотности из Вордстата;
• анализ выдачи Яндекса и Google;
• работу с данными Яндекс Метрики;
• получение статистики из Google Search Console;
• работу с Яндекс Вебмастером;
• извлечение контента и структуры страниц;
• создание и редактирование статей.

Благодаря этому Hermes становится не просто чат-ботом, а полноценным помощником по работе с сайтом.

Настройка MCP-сервера

Добавить сервер можно через интерактивную команду: hermes mcp add pr-cy. Следуйте подсказкам мастера и укажите адрес сервера: https://mcp-server.pr-cy.ru. Для авторизации используется тот же ключ из раздела «Настройки API», который применялся при подключении API Router.

Ручная настройка

Сервер можно добавить непосредственно в файл: 

~/.hermes/config.yaml

Пример:

mcp_servers:
  pr-cy:
    url: "https://mcp-server.pr-cy.ru"
    headers:
      Authorization: "Bearer ВАШ_КЛЮЧ_PR_CY"

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

~/.hermes/.env

Содержимое файла:

PRCY_API_KEY=ваш_ключ_из_настроек_api

А в config.yaml сослаться на переменную:

mcp_servers:
  pr-cy:
    url: "https://mcp-server.pr-cy.ru"
    headers:
      Authorization: "Bearer ${PRCY_API_KEY}"

На Linux, macOS и VPS ограничьте доступ к файлу с секретом:

chmod 600 ~/.hermes/.env

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

Если агент уже запущен, перечитайте список MCP-серверов прямо в текущей сессии: /reload-mcp. Посмотреть подключённые серверы можно командой: hermes mcp. Если синтаксис отличается в вашей версии Hermes, откройте встроенную справку: hermes mcp --help

Какие инструменты получает агент

MCP-сервер PR-CY разделяет инструменты на несколько категорий:

Категория	Количество	Что становится доступно
Аккаунт	5	Проекты, лимиты и регионы
Ключевые слова	9	Запросы проекта, позиции, история и сводки по страницам
Группы	4	Создание и редактирование групп запросов
Поиск	3	Выдача Яндекса и Google, Вордстат и позиции домена
GSC и Яндекс Вебмастер	3	Клики, показы, запросы и страницы
Метрика	11	Визиты, источники, цели, конверсии, устройства и география
Контент	3	Текст страницы, структура заголовков и скриншот
Статьи	10	Создание и редактирование статей в редакторе PR-CY
Всего	48	Полный набор инструментов MCP-сервера

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

Что доступно без проекта

Набор возможностей зависит от тарифа и наличия проекта в PR-CY.

С базовым API-ключом доступны:

• Вордстат;
• выдача Яндекса и Google;
• получение и разбор контента страниц.

Этого достаточно, чтобы:

• собирать семантику;
• оценивать спрос;
• анализировать конкурентов;
• изучать структуру страниц;
• готовить планы и черновики статей.

Если в PR-CY создан проект и подключён соответствующий тариф, агент дополнительно получает доступ к данным конкретного сайта:

• текущим позициям;
• истории изменения позиций;
• Google Search Console;
• Яндекс Вебмастеру;
• Яндекс Метрике.

Ограничьте набор инструментов

Все 48 функций не обязательно передавать модели одновременно. Описание каждого инструмента занимает часть контекстного окна и увеличивает объём входных данных при обращениях к модели.

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

Hermes позволяет оставить только необходимый набор через include:

mcp_servers:
  pr-cy:
    url: "https://mcp-server.pr-cy.ru"
    headers:
      Authorization: "Bearer ${PRCY_API_KEY}"
    tools:
      include:
        - get_wordstat
        - get_serp
        - get_page_content
        - get_keywords_summaries
        - get_metrika_visits

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

tools:
  include:
    - get_wordstat
    - get_serp
    - get_page_content

Можно действовать наоборот и убрать отдельные функции через exclude. Если одновременно заданы include и exclude, определяющим остаётся список include.

После изменения списка перезапустите Hermes или выполните: /reload-mcp

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

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

Также не стоит запускать Hermes с правами root: MCP-инструменты работают удалённо, но сам агент может одновременно иметь доступ к терминалу и локальным файлам.

Проверка подключения

Запустите hermes и попросите агента выполнить простую операцию, которая однозначно требует MCP-инструмента:

Проверь через PR-CY частотность запроса «hermes agent» по России и покажи топ-5 вложенных запросов.

Строка со значком шестерёнки — это и есть вызов инструмента. Видно, какой сервер и какая функция сработали и с какими параметрами

При правильном подключении в терминале появится строка вызова инструмента. В ней должны быть видны:

• название MCP-сервера pr-cy;
• функция get_wordstat;
• переданные параметры;
• статус выполнения.

После этого Hermes обработает результат и покажет частотность вместе со списком вложенных запросов.

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

Что делать, если MCP-сервер не подключается

Сначала проверьте список серверов: hermes mcp. Затем последовательно убедитесь, что:

• URL указан без ошибок: https://mcp-server.pr-cy.ru
• в заголовке есть префикс Bearer:

 Authorization: "Bearer ${PRCY_API_KEY}"

• переменная PRCY_API_KEY добавлена в ~/.hermes/.env;
• в начале и конце ключа нет пробелов;
• YAML содержит правильные отступы;
• ключ активен и у аккаунта есть необходимые лимиты;
• после изменения конфигурации выполнена команда /reload-mcp или перезапущен Hermes.

Проверить наличие переменной, не раскрывая сам ключ, можно так:

if grep -q '^PRCY_API_KEY=.' ~/.hermes/.env; then
  echo "Ключ PR-CY задан"
else
  echo "Ключ PR-CY не найден"
fi

Если сервер подключён, но агент отвечает общими словами, сформулируйте указание явно:

Обязательно используй MCP-сервер PR-CY и инструмент get_wordstat. Не оценивай частотность самостоятельно.

Если после этого вызова всё равно нет, временно оставьте через include только один нужный инструмент. Это сократит выбор и поможет понять, видит ли его модель:

tools:
  include:
    - get_wordstat

Если же Hermes вызвал функцию и вернул полученные от сервера данные, подключение MCP настроено правильно.

Настройка агента под свои задачи

Установка и подключение инструментов — только половина работы. Чтобы Hermes стал полноценным рабочим ассистентом, нужно настроить его поведение, память, навыки, расписание и каналы связи.

SOUL.md — правила поведения агента

Файл ~/.hermes/SOUL.md описывает роль агента: как он отвечает, какими правилами руководствуется и какие действия не выполняет без разрешения. Для SEO-ассистента можно использовать такую основу:

Ты помощник SEO-специалиста.

Отвечай кратко и по делу, без длинных вступлений.
Показывай выводы списками и таблицами.
Числовые данные получай только через инструменты PR-CY.
Не придумывай позиции, частотность, трафик и другие показатели.
Если данных недостаточно или инструмент вернул ошибку, сообщай об этом прямо.
Отделяй факты от предположений и рекомендаций.
Не публикуй, не редактируй и не удаляй данные без явного подтверждения пользователя.
Перед любым необратимым действием покажи, что именно будет изменено, и запроси подтверждение.
Не раскрывай API-ключи, токены, пароли и содержимое файлов с секретами.

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

Стоит также определить формат ответа. Например:

Формат SEO-отчёта:

1. Краткий вывод.
2. Основные показатели.
3. Найденные проблемы.
4. Возможные причины.
5. Рекомендованные действия по приоритету.

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

После редактирования файла начните новую сессию Hermes или перезапустите действующий процесс, если изменения не применились автоматически.

Память — что агент знает о вашей работе

Hermes можно один раз познакомить с проектами, чтобы затем не повторять одни и те же вводные:

• основной домен;
• приоритетные регионы;
• поисковые системы;
• конкуренты;
• важные категории сайта;
• целевые запросы;
• предпочитаемый формат отчётов;
• допустимые и запрещённые действия.

Передать эти сведения можно прямо в диалоге:

Запомни: основной проект — example.ru. Приоритетный регион — Москва. Основные конкуренты — competitor-a.ru и competitor-b.ru. Проверяй Яндекс и Google на компьютерах и мобильных устройствах. Сводки присылай списком, без вступления. Все изменения на сайте сначала согласовывай со мной.

Не передавайте в память пароли, API-ключи, резервные коды и другие секреты. Для них предназначены переменные окружения и отдельный файл .env.

Проверьте, что агент правильно сохранил вводные:

Перечисли, что ты запомнил о проекте example.ru. Не проводи анализ и не вызывай инструменты.

Если проект изменился, лучше прямо заменить старое правило:

Обнови сведения о проекте example.ru: теперь основной регион — Санкт-Петербург. Москву больше не считай приоритетной.

Память полезна для постоянных настроек, но текущие числовые показатели в ней хранить не следует. Позиции, трафик и частотность устаревают — агент должен каждый раз получать их из PR-CY или подключённой системы аналитики.

Первые навыки SEO-ассистента

Навык — это повторяемый сценарий работы. Вместо длинного задания вы называете навык, а агент выполняет заранее определённую последовательность действий.

В первый день SEO-специалисту пригодятся пять базовых навыков.

1. Утренняя сводка

Сценарий может включать:

1. проверку доступности проекта и источников данных;
2. сравнение позиций с предыдущим днём;
3. поиск запросов, потерявших заданное число позиций;
4. проверку поискового трафика;
5. выявление страниц с заметным снижением кликов;
6. просмотр недавних изменений в проекте;
7. подготовку краткого списка отклонений.

Пример правила:

Считай поводом для внимания падение запроса минимум на пять позиций или снижение поискового трафика более чем на 20% относительно сопоставимого предыдущего периода. Если данных недостаточно, не делай вывод о просадке.

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

2. Разбор нового ключевого запроса

Хорошая последовательность:

1. получить общую, фразовую и точную частотность;
2. найти вложенные и связанные запросы;
3. определить поисковый интент;
4. посмотреть первую десятку выдачи;
5. определить преобладающий тип страниц;
6. изучить структуру основных конкурентов;
7. оценить, нужна ли новая страница или можно расширить существующую;
8. предложить структуру материала.

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

3. Проверка страницы перед публикацией

Навык может проверять:

• title и description;
• наличие одного понятного H1;
• структуру H2–H3;
• соответствие поисковому интенту;
• раскрытие основных подтем;
• естественность употребления запросов;
• внутренние и внешние ссылки;
• изображения и подписи к ним;
• совпадение с другими страницами сайта;
• отличия от материалов из топа;
• фактические утверждения и источники.

Агент не должен оценивать страницу только по количеству вхождений. Важнее полнота ответа, соответствие намерению пользователя и отсутствие искусственно повторённых ключей.

4. Отчёт клиенту

Заранее определите структуру отчёта:

1. Что изменилось за период.
2. Динамика поискового трафика.
3. Динамика видимости и позиций.
4. Страницы и запросы с наибольшим ростом.
5. Основные просадки.
6. Выполненные работы.
7. План на следующий период.
8. Ограничения данных и важные примечания.

Попросите агента разделять:

• показатели из инструментов;
• интерпретацию этих показателей;
• выполненные действия;
• предложения на следующий период.

Так клиенту будет проще понять, где находятся объективные данные, а где — профессиональная оценка.

5. Реакция на просадку

Порядок диагностики может быть таким:

1. проверить корректность периода и источника данных;
2. определить масштаб падения;
3. разделить проблему по поисковикам, регионам и устройствам;
4. найти пострадавшие запросы и страницы;
5. проверить индексацию;
6. посмотреть технические изменения;
7. проверить robots.txt, sitemap.xml, канонические адреса и редиректы;
8. изучить изменения контента и шаблонов;
9. проверить динамику конкурентов и состав выдачи;
10. сформировать гипотезы по вероятности и приоритету проверки.

Корреляцию нельзя автоматически считать причиной. Если падение совпало с обновлением страницы, агент должен назвать это гипотезой, пока связь не подтверждена дополнительными данными.

Как создать навык

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

1. сформулируйте цель;
2. согласуйте источники данных;
3. пройдите последовательность действий;
4. скорректируйте результат;
5. попросите сохранить окончательный процесс.

Пример:

Сохрани выполненный порядок как навык «Разбор нового ключа». При запуске сначала спрашивай запрос, поисковую систему и регион. Числовые показатели всегда получай через PR-CY. Перед созданием статьи или изменением данных запрашивай подтверждение.

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

Команды управления навыками могут различаться между версиями Hermes. Актуальный синтаксис лучше уточнить во встроенной справке: hermes --help

Расписание регулярных задач

Hermes можно поручить выполнение задач по расписанию. Формулировать их можно обычным языком:

Каждый будний день в 9:00 собирай сводку по позициям проекта example.ru и отправляй её на почту.

Перед сохранением расписания уточните:

• часовой пояс;
• дни выполнения;
• проект;
• источник данных;
• период сравнения;
• критерии тревоги;
• канал доставки;
• действия при ошибке.

Планировщик также может принимать cron-выражения. Это удобно, когда требуется точный график, однако нужно отдельно проверить, в каком часовом поясе работает служба.

Перед автоматизацией запустите задачу вручную. Убедитесь, что:

1. выбирается правильный проект;
2. вызываются нужные инструменты;
3. отчёт не содержит вымышленных показателей;
4. сообщение приходит в выбранный канал;
5. при ошибках отправляется понятное уведомление;
6. задача не выполняет никаких изменений без разрешения.

Созданные задания можно приостанавливать и редактировать — удалять и настраивать их заново обычно не требуется.

Выбор канала связи

Работать с Hermes можно не только через терминал. Шлюз поддерживает разные платформы, поэтому канал выбирают с учётом назначения, доступности и требований к контролю данных.

Канал	Что потребуется	Для каких задач подходит
Терминал	Команда hermes	Интерактивная работа за компьютером; отдельный шлюз не нужен
Электронная почта	Почтовый ящик	Регулярные отчёты, сводки, вложения и переписка
Mattermost	Собственный сервер или облачная версия	Командные обсуждения, треды, файлы и изображения
Matrix	Собственный homeserver или публичный сервер	Контролируемая инфраструктура и сквозное шифрование
ntfy	Свой сервер или ntfy.sh	Односторонние push-уведомления и срочные сигналы
Вебхуки	Собственный обработчик	Интеграция с корпоративным порталом, CRM или внутренней системой
SMS	SMS-шлюз	Критические уведомления, требующие максимальной заметности
Мессенджеры и корпоративные платформы	Бот и учётная запись соответствующего сервиса	Повседневное общение, если платформа стабильно доступна вашей команде

Лучше не пытаться решить все задачи одним каналом:

• терминал использовать для ручной работы;
• почту — для регулярных отчётов;
• Mattermost или Matrix — для командного диалога;
• ntfy или SMS — для срочных уведомлений;
• вебхуки — для передачи результатов во внутренние системы.

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

Подключение шлюза

1. Запустите мастер настройки: hermes gateway setup. Он покажет поддерживаемые платформы и уже настроенные подключения.
2. После настройки установите шлюз как системную службу: hermes gateway install.
3. Запустите её: hermes gateway start.
4. Проверьте состояние: hermes gateway status.
5. Для остановки используйте: hermes gateway stop.

На Linux служба управляется через systemd, а на macOS — через launchd. Точное поведение зависит от версии Hermes и способа установки. Проверить доступные команды можно так: hermes gateway --help

Пример подключения Matrix

Секретные параметры поместите в:

~/.hermes/.env

Пример:

MATRIX_HOMESERVER=https://matrix.example.org
MATRIX_ACCESS_TOKEN=ваш_токен
MATRIX_ALLOWED_USERS=@ivan:matrix.example.org

Ограничьте доступ к файлу:

chmod 600 ~/.hermes/.env

Параметры поведения задайте в:

~/.hermes/config.yaml

Пример конфигурации:

matrix:
 require_mention: true
 allowed_users:
  - "@ivan:matrix.example.org"
 auto_thread: true
 max_message_length: 16000

Здесь:

• require_mention заставляет бота отвечать только при явном упоминании;
• allowed_users задаёт белый список пользователей;
• auto_thread переносит обсуждение в отдельный тред;
• max_message_length ограничивает размер одного сообщения.

Названия параметров могут зависеть от версии шлюза, поэтому перед запуском сверьте пример со справкой установленной версии.

Ограничение доступа к агенту

Особое внимание уделите allowed_users и аналогичным параметрам других каналов. Без белого списка боту потенциально сможет написать посторонний пользователь, обнаруживший его адрес или добавленный в общий чат.

Правила безопасности:

1. разрешайте доступ только конкретным пользователям;
2. в групповых чатах включайте ответ по упоминанию;
3. не принимайте команды от неизвестных отправителей;
4. не отправляйте секреты в сообщения;
5. используйте отдельные токены для каждого канала;
6. выдавайте агенту только необходимые инструменты;
7. запретите изменения без подтверждения;
8. регулярно просматривайте журналы работы шлюза.

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

Несколько каналов одновременно

К одному агенту можно подключить несколько каналов и распределить задачи между ними. Например:

• ежедневную сводку отправлять по электронной почте;
• сообщения о падении видимости — через ntfy;
• клиентский отчёт сохранять в почтовом треде;
• обсуждение рекомендаций вести в Mattermost;
• ручной анализ запускать из терминала.

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

Пять сценариев для сайта

Формулировки можно скопировать и заменить домен, запросы и канал отправки.

1. Утренняя сводка по позициям

Задание:

Каждый будний день в 9:00 получай позиции сайта example.ru из PR-CY и сравнивай их с данными за прошлую неделю. Присылай на почту пять запросов с наибольшим ростом, пять запросов с наибольшим падением и изменение средней позиции. Если запрос потерял больше 10 позиций, добавляй его отдельно с пометкой «Проверить страницу».

Вместо почты можно указать Mattermost или Matrix.

Использует: данные о текущих и прошлых позициях по запросам, сводки по страницам.
Нужен: проект в PR-CY.

Пример утренней сводки Hermes в мессенджере: средняя позиция, выросшие и просевшие запросы, предупреждение о странице, которую стоит проверить. В почте и Mattermost данные будут те же, изменится только оформление. Агент запомнит выбранный формат и будет использовать его дальше. 2. Отслеживание контента конкурентов

Задание:

Раз в неделю снимай топ-10 Яндекса по Москве для запросов из группы «Коммерческие». Для доменов, которых не было в предыдущей выборке, получай структуру заголовков и объём текста. Присылай список доменов, которые появились в топе или выбыли из него, а также заголовки новых участников.

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

3. Сбор и анализ семантики

Задание:

Собери общую частотность и частотность в кавычках по России для запросов из файла keys.txt. Удали запросы с точной частотностью ниже 30. Оставшиеся запросы сгруппируй по смыслу. Для каждой группы предложи одну целевую страницу и проверь, есть ли такая страница на example.ru.

Использует: Вордстат, поисковую выдачу и контент сайта.
Нужен: базовый ключ.

4. Черновик статьи по ключевым запросам

Задание:

Тема статьи: «Как выбрать беговые кроссовки». Проверь частотность связанных запросов, изучи топ-10 Яндекса и собери структуру заголовков конкурентов. Предложи план, который раскрывает тему полнее каждого из рассмотренных материалов, и напиши первые два раздела. Требования к тону возьми из навыка «Редполитика».

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

5. Анализ падения трафика

Задание:

На прошлой неделе трафик на example.ru снизился. Сопоставь данные за последние 30 дней: визиты из Метрики, клики из Search Console и позиции из PR-CY. Найди страницы с самым сильным падением и определи, что начало снижаться раньше: позиции, показы или кликабельность.

Использует: Метрику, Google Search Console и историю позиций.
Нужен: проект в PR-CY с подключёнными счётчиками.

Первые задачи лучше запускать вручную. Проверьте, какие инструменты выбирает агент и сколько шагов тратит. Если результат вас устраивает, сохраните задачу как навык и настройте расписание.

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

Hermes распространяется бесплатно по лицензии MIT. Расходы зависят от места запуска агента и количества обращений к модели.

Место запуска. На своём компьютере агент работает без дополнительных расходов. Для круглосуточной работы понадобится VPS. Подходящая конфигурация обычно стоит от 300 до 500 ₽ в месяц.

Модель. Обращения расходуют лимиты PR-CY. Эти лимиты общие для всех инструментов сервиса.

Одна задача обычно требует нескольких обращений к модели. Агент анализирует запрос, вызывает инструмент, получает данные и продолжает работу. За одну задачу он может обратиться к модели 5–15 раз. При каждом обращении передаётся накопленный контекст.

Ниже приведён примерный расход лимитов для модели prcy-5.6-luna. Фактические значения зависят от объёма данных и количества шагов.

Сценарий	Прогонов в месяц	Примерный расход лимитов
Утренняя сводка по позициям	22	350–450
Еженедельное отслеживание конкурентов	4	150–250
Анализ семантики на 500 запросов	2	200–300
Черновик статьи	4	300–400

Стоимость в рублях зависит от тарифа. Рассчитать её можно по цене лимита в личном кабинете.

Тариф. Роутер и MCP доступны на платных тарифах PR-CY от 990 ₽ в месяц. Тариф также включает SEO-инструменты, проекты и мониторинг. Лимиты у них общие, отдельная плата за API не требуется.

Как сократить расходы

• Начните с prcy-5.6-luna или prcy-deepseek-chat. Более дорогие модели подключайте только для отдельных задач.
• Ограничьте доступный набор MCP-инструментов через include.
• Не передавайте агенту большие выгрузки целиком. Сначала попросите отфильтровать данные, затем проанализировать результат.
• В первые недели проверяйте остаток лимитов в личном кабинете. Так вы сможете оценить расход на своих задачах.

Безопасность: агент с доступом к серверу

Hermes выполняет команды в терминале и обращается к интернету. Поэтому его доступ к серверу нужно ограничить так же, как доступ отдельного сотрудника.

Создайте отдельного пользователя без прав root. Не запускайте агента от имени администратора. Тогда ошибка в команде или неточно поставленная задача не затронет всю систему.

Выпустите отдельный ключ PR-CY. Не используйте ключ от других интеграций. Если понадобится, ключ агента можно будет отозвать отдельно.

Храните секреты в закрытых каталогах. У агента не должно быть доступа к паролям от хостинга, базе данных и платёжным данным. Исключение — файл .env Hermes: рабочие ключи хранятся в нём.

Запускайте терминал в контейнере. Чтобы изолировать команды агента, укажите Docker как среду выполнения:

terminal:
  backend: docker
  timeout: 180

Сделайте резервную копию перед правками. Не разрешайте агенту менять файлы сайта без бэкапа. Это правило касается любых автоматических изменений.

Проверяйте логи в первые две недели. Следите, какие инструменты вызывает агент и что делает с данными. Так вы поймёте, какие задачи можно автоматизировать, а какие лучше проверять вручную.

Распространенные проблемы

Симптом	Возможная причина	Что делать
hermes: command not found	Оболочка не перезагружена или ~/.local/bin отсутствует в PATH	Выполнить source ~/.bashrc или source ~/.zshrc, затем проверить PATH
API key not set	Ключ не сохранился	Запустить hermes model или выполнить hermes config set OPENAI_API_KEY ваш_ключ
Модель не выбрана или не найдена	В конфигурации не указано имя модели	Выполнить hermes config set model prcy-5.6-luna
Ошибка авторизации при верном ключе	В ключ попал пробел или перенос строки	Ввести ключ заново и проверить командой hermes config get OPENAI_API_KEY
Агент отвечает, но не вызывает инструменты	Модель не получила их описания или MCP не подключился	Запустить hermes mcp, затем выполнить /reload-mcp в сессии
MCP возвращает пустые данные о позициях	Используется базовый ключ без проекта	Подключить проект в PR-CY. Нужен тариф от 990 ₽ в месяц
Запросы завершаются по тайм-ауту	Задача требует много времени или накопился длинный контекст	Увеличить providers.*.request_timeout_seconds в config.yaml
После обновления пропали настройки	Изменился формат конфигурации	Выполнить hermes config check, затем hermes config migrate
Причина ошибки неясна	—	Запустить общую диагностику: hermes doctor

Итоговый чек-лист

1. Установите Hermes через десктопный установщик или командную строку. Запустите проверку: hermes doctor.
2. Получите ключ в личном кабинете PR-CY, в разделе «Настройки API».
3. Подключите модель через hermes setup. Выберите Custom Endpoint и укажите: https://api.pr-cy.ru/v1. Модель: prcy-5.6-luna. Те же параметры можно задать вручную в .env и config.yaml.
4. Добавьте MCP-сервер с адресом: https://mcp-server.pr-cy.ru. Укажите заголовок авторизации. Через include оставьте только те инструменты, которые нужны агенту.
5. Добавьте в SOUL.md сведения о себе и своих проектах. Остальной рабочий контекст сохраните в памяти агента.
6. Запустите первую задачу вручную. Проверьте результат и действия агента. Если всё работает как нужно, сохраните сценарий как навык.
7. Настройте расписание и канал связи: например, почту, Mattermost или Matrix.

Часто задаваемые вопросы

Нужны ли VPN и зарубежная карта?

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

Можно ли работать без сервера?

Да, Hermes можно запустить на ноутбуке, но агент будет доступен только при включённом компьютере. VPS нужен для постоянной работы и задач по расписанию. Например, чтобы отправить сводку в 9:00, агент должен быть запущен в это время.

Чем Hermes отличается от Claude Code, Codex и Cursor?

Claude Code, Codex и Cursor обычно запускают для конкретной задачи во время работы в редакторе. Hermes может постоянно работать в фоне, хранить сведения о прошлых задачах и запускать их по расписанию. Эти инструменты решают разные задачи и могут использоваться вместе.

Нужно ли уметь программировать?

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

Что произойдёт с памятью после переустановки?

Память, навыки и сессии хранятся в каталоге ~/.hermes/. Скопируйте его перед переустановкой, чтобы затем восстановить данные. Так же можно перенести агента с ноутбука на сервер.

Можно ли одновременно подключить PR-CY и другого провайдера?

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