Как это работает
-
Скачайте
claude-agent.mdкнопкой ниже ИЛИ установите через one-shot скрипт:curl -fsSL https://recca.ru/integration/install.sh | sh - Положите файл в
.claude/agents/recca-integration.mdвашего репозитория. - В вашем Claude Code:
@recca-integration "подключи мой сайт partner-site.example.com к Recca, slug=<your-org-slug>, key=rtk_live_..." -
Агент пройдётся по семи шагам setup-а: установит SDK
(если ещё не установлен), вкомпонует
<recca-login-button>и<recca-referral-input>в layout, напишет Express webhook receiver с HMAC-проверкой, прогонит smoke-curl проверки и отчитается.
Что внутри
Агент универсальный — собирает встроенный кабинет на любом стеке (Astro / Vue / React / Express, любой провайдер логина: VK / Yandex / Telegram / SMS / email). Не делает запросов во внешнюю документацию — весь inventory эндпоинтов, code patterns и «грабли» inline в самом файле (~28 KB). Знает все ловушки, на которые наступали клиенты до вас.
- Context: что такое Recca, кто end-user, какие surface'ы (Federation / JSON / SDK / Webhooks)
- Endpoints inventory: 5 GET + 1 POST embed + 3 federation routes + OAuth
- Setup steps: 10 шагов от credentials до verification
- Code patterns: Astro page, Vue 3 SFC, Express webhook handler, users.upsert call
- Verification: 4 curl-проверки (cabinet 200+ACAO, foreign-origin 403, users.upsert, iframe widget)
- Troubleshooting: матрица «симптом → причина → фикс» на 8 типичных проблем
- Conventions: жёсткие правила (никогда не выдумывать endpoints; никогда не хардкодить ключи; defaults to visitka theme)
Скачать
Размер ~28 KB. Версия обновляется при каждом изменении API Recca — пересохраните при следующей крупной интеграции.
Альтернативы
Если вы не используете Claude Code — те же знания доступны в рецепте встроенного кабинета + граблях + API Reference. Интеграция руками займёт 30-60 минут вместо одного промпта.