Hooklayer MCP

Интеллект вирусного контента для ИИ-агентов. Подключите MCP-сервер Hooklayer к Claude Desktop, Cursor, n8n или любому HTTP MCP-клиенту — и ваш агент получит 12 инструментов для короткоформатного контента в TikTok, Instagram и YouTube: анализ авторов, поиск видео по ключевым словам, поиск вирусных шаблонов и растущих трендов, оценка и переписывание хуков, ремиксы вирусных видео, подбор голоса автора, прогноз виральности черновика, превращение бренд-брифа в готовый к съёмке креативный план, а также мониторинг авторов с сохранёнными наблюдениями и историческими снимками.

12 tools · structured JSON · non-destructive creator monitoring · no external social-platform edits or deletes

v1.1.0 (2026-05-14): Слой доказательств запущен. Каждая оценка включает signals[] с цитируемыми доказательствами, контрафактический would_fail_because и поле здоровья quality. predict_virality выполняет независимую проверку на противодействие. Шаги analyze_account.recommended_chain теперь раскрывают confidence, cost, action_class (таксономия авторитетности) и expected_output. Полный список изменений — в CHANGELOG.md.

🚀 Быстрая установка

Claude Desktop

Claude Desktop не поддерживает удалённые HTTP MCP-серверы нативно — ему нужен мост mcp-remote. Два способа установки:

Вариант 1 — Пользовательский коннектор (самый простой, без правки конфигурационного файла)

В веб-интерфейсе или настольном приложении Claude: Настройки → Коннекторы → Добавить пользовательский коннектор → вставьте этот URL:

https://hooklayer.dev/api/mcp

Claude.ai проведёт вас через OAuth (без ручной вставки ключа). Готово.

Вариант 2 — Прямая настройка (для продвинутых пользователей, которым нужна аутентификация по ключу hl_live_)

Отредактируйте claude_desktop_config.json:

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

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

{
  "mcpServers": {
    "hooklayer": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.1.38",
        "https://hooklayer.dev/api/mcp",
        "--header",
        "Authorization:Bearer hl_live_..."
      ]
    }
  }
}

Получите бесплатный ключ hl_live_ на https://hooklayer.dev/auth/signup — 100 пожизненных кредитов, карта не требуется.

Перезапустите Claude Desktop. 12 инструментов Hooklayer появятся в списке коннекторов 🔌.

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "hooklayer": {
      "url": "https://hooklayer.dev/api/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer hl_live_..."
      }
    }
  }
}

n8n

В вашем рабочем процессе добавьте узел MCP Client и настройте его как удалённый HTTP MCP-сервер:

• URL: https://hooklayer.dev/api/mcp

• Транспорт: HTTP

• Заголовок: Authorization: Bearer hl_live_...

Все 12 инструментов появятся в выпадающем списке "Tool" узла.

OAuth 2.1 + PKCE (для коннектора Claude.ai и пользовательских приложений)

Hooklayer полностью соответствует OAuth 2.1 — обнаружение, динамическая регистрация клиентов, PKCE, ротация refresh-токенов. MCP-клиенты, предпочитающие OAuth вместо API-ключей, работают из коробки.

Конечные точки обнаружения (без аутентификации, машиночитаемые):

# Authorization server metadata (RFC 8414)
curl https://hooklayer.dev/.well-known/oauth-authorization-server

# Protected resource metadata (RFC 9728)
curl https://hooklayer.dev/.well-known/oauth-protected-resource

Динамическая регистрация клиентов (создание клиента без ручной формы регистрации):

curl -X POST https://hooklayer.dev/oauth/register \
  -H "Content-Type: application/json" \
  -d '{
    "client_name": "Your MCP client",
    "redirect_uris": ["https://yourapp.com/oauth/callback"]
  }'
# Returns: client_id, client_secret (for confidential clients)

Вызов tools/call без аутентификации возвращает 401 и заголовок WWW-Authenticate, указывающий на метаданные ресурса — Claude.ai, Cursor и другие MCP-клиенты используют это для автоматического обнаружения потока OAuth.

Другие клиенты

Любой HTTP MCP-клиент. Протокол согласовывает 2024-11-05 (максимальная совместимость) или 2025-06-18 (Streamable HTTP + structuredContent).

# Quick test — initialize handshake works without auth:
curl -X POST https://hooklayer.dev/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'

Related MCP server: tiktok-viral-factory

🧠 12 инструментов

Полные схемы + примеры curl: https://hooklayer.dev/docs

💡 Рекомендуемые следующие шаги

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

{
  "viral_dna_score": 87,
  "steal_map": [...],
  "recommended_chain": [
    {
      "tool": "match_voice",
      "params": {
        "draft": "<<<USER_DRAFT>>>",
        "reference_samples": ["https://tiktok.com/...", "...", "..."]
      },
      "reason": "High-signal voice DNA — consistent across top 5 videos"
    },
    {
      "tool": "trend_pulse",
      "params": { "niche": "challenge_videos" },
      "reason": "Verify their formula maps to current trends"
    },
    {
      "tool": "viral_remix",
      "params": { "source_url": "https://tiktok.com/..." },
      "reason": "Their #2 video has the highest copyable structure"
    }
  ]
}

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

📦 Примеры

• examples/typescript-example.ts — использование TypeScript через MCP SDK

• examples/python-example.py — использование Python через клиент anthropic-mcp

• examples/curl-test.sh — сырые curl-тесты для каждой конечной точки

💵 Цены

• Бесплатно — 100 пожизненных кредитов при регистрации, без карты

• Starter — $49/мес, 5 000 кредитов, 60 запросов/мин

• Pro — $149/мес, 25 000 кредитов, 300 запросов/мин, память голоса бренда

• Agency — $499/мес, 150 000 кредитов, 1 000 запросов/мин, white-label, 10 мест

• Pay-as-you-go — $25 за 5 000 кредитов, не сгорают

Полные цены: https://hooklayer.dev/pricing

🛠 Архитектура

Хостируемый MCP-сервер (установка через stdio не требуется):

Your agent (Claude/Cursor/n8n)
        │
        │  JSON-RPC 2.0 over HTTP
        ▼
https://hooklayer.dev/api/mcp
        │
        ├── initialize / ping / tools/list  (no auth)
        └── tools/call                       (Bearer hl_live_*)
                │
                └── Routes internally to /v1/* REST endpoints
                    100K+ analyzed viral videos
                    ScrapeCreators + Whisper + Sonnet pipeline

Исходный код хостируемого сервера находится на hooklayer.dev (закрытый исходный код — конвейер анализа является ключевым преимуществом). В этом репозитории — публичная документация для клиентов, примеры и фрагменты конфигурации.

📚 Ссылки

• Страница установки: https://hooklayer.dev/mcp

• Полная документация: https://hooklayer.dev/docs

• Playground (без регистрации): https://hooklayer.dev/playground

• Цены: https://hooklayer.dev/pricing

• Метаданные OAuth: /.well-known/oauth-authorization-server

• Проблемы и отчёты об ошибках: GitHub Issues

🔒 Безопасность

Hooklayer использует явные аннотации безопасности MCP для всех 12 инструментов. Большинство инструментов — это исследовательские и аналитические инструменты, которые могут списывать кредиты Hooklayer и записывать использование сервиса. list_watches — только для чтения. Мониторинг авторов добавляет неразрушающее постоянство: watch_account сохраняет наблюдение за автором и базовый снимок, а get_changes сохраняет исторические снимки при проверке изменений. Все инструменты помечены destructiveHint: false; у Hooklayer нет MCP-инструмента, который удаляет пользовательские данные или редактирует/удаляет данные на внешних социальных платформах.

Аутентификация: tools/call требует Bearer-токен (API-ключ hl_live_* или access-токен OAuth 2.1). Публичные методы (initialize, ping, tools/list) работают без аутентификации, чтобы MCP-клиенты могли выполнить рукопожатие и обнаружить инструменты до аутентификации.

recommended_chain — только рекомендация. Ответ analyze_account включает предложенные дополнительные инструменты с предзаполненными параметрами. Это данные — агент и пользователь решают, выполнять ли их. Ни один вызов инструмента никогда не запускает дополнительные вызовы на стороне сервера.

Обработка данных: Hooklayer обрабатывает отправленные вами входные данные (хэндлы, хуки, сценарии, URL) для возврата результатов анализа. Мониторинг авторов хранит сохранённые метаданные наблюдений и исторические снимки, чтобы пользователи могли сравнивать изменения с течением времени. Hooklayer также записывает использование сервиса, необходимое для аутентификации, биллинга, кредитов и операционной телеметрии.

Чтобы сообщить о проблеме безопасности: GitHub Issues или по электронной почте security@hooklayer.dev.

📄 Лицензия

MIT — см. LICENSE.

Примеры MCP-клиентов и фрагменты конфигурации в этом репозитории распространяются по лицензии MIT. Хостируемый сервис Hooklayer на hooklayer.dev — коммерческий продукт с указанными выше тарифными планами.