MCP Server

Unihra поставляется со встроенным MCP (Model Context Protocol) сервером, который позволяет AI-ассистентам — Cursor, Claude Desktop или любому MCP-совместимому клиенту — запускать SEO-анализы и читать результаты без ручной настройки.

Установка

pip install "unihra[mcp]"   # требует Python 3.10+

Конфигурация для Cursor / Claude Desktop

Добавьте в свой MCP-конфиг:

Claude Desktop

{
  "mcpServers": {
    "unihra": {
      "command": "python",
      "args": ["-m", "unihra.mcp_server"],
      "env": {
        "UNIHRA_API_KEY": "ВАШ_КЛЮЧ"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "unihra": {
      "command": "python",
      "args": ["-m", "unihra.mcp_server", "--key", "ВАШ_КЛЮЧ"]
    }
  }
}

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

Инструмент	Описание
unihra_health	Проверка доступности API
unihra_get_limits	Баланс ключа и дневные лимиты
unihra_analyze	Запуск SEO-анализа (стандартный или расширенный)
unihra_list_results	Список сохранённых результатов
unihra_delete_result	Удалить сохранённый результат
unihra_get_gaps	Получить пробелы зонтичного анализа с фильтрами
unihra_get_anchors	Анализ якорей
unihra_get_word_actions	Действия по словам TF-IDF (add/increase/decrease)
unihra_get_ngrams	Шаблоны фраз
unihra_get_triplets	Сущности и пробелы графа знаний (расширенный режим)
unihra_get_page_structure	Структура заголовков и meta-тегов

Как это работает

1. Вы говорите AI: «Сравни мою страницу X с конкурентами Y и Z»
2. AI вызывает unihra_analyze — анализ выполняется на сервере (30–120 секунд)
3. Сразу возвращается компактная сводка с result_id
4. AI вызывает специфические unihra_get_* для получения нужных срезов данных

Результаты сохраняются локально в ~/.unihra_mcp/results/ и сохраняются между сессиями.

Контроль расходов

AI инструктирован использовать стандартный режим (1 кредит) по умолчанию и переключаться на расширенный режим (5 кредитов) только когда вы явно просите анализ графа знаний или бриф контента на уровне фактов. Используйте unihra_get_limits для проверки баланса.

Запуск вручную

UNIHRA_API_KEY=ваш_ключ python -m unihra.mcp_server

# С опциями:
python -m unihra.mcp_server \
  --key ВАШ_КЛЮЧ \
  --retries 3 \
  --results-dir /tmp/unihra_results

Примеры запросов

"Сравни https://mysite.com/product с https://comp1.com и https://comp2.com"
"Какие слова добавить на страницу для запроса 'купить матрас онлайн'?"
"Сделай аудит покрытия фактов — какие сущности конкуренты освещают, а я нет?"
"Покажи структуру заголовков всех проанализированных страниц"