Интеграция через AI
Если интеграцию пишет AI-агент, дайте ему наш скилл. Это один файл: модель данных, все методы, ловушки и правила — то, что нельзя вывести из справочника, но без чего интеграция получается неверной. За подробностями (тела ответов, коды отказов, форматы ссылок) скилл сам отправляет агента в нужное руководство на этом портале.
Сам файл — docs.rewio.ru/skill/SKILL.md
(32 КБ, обычный markdown). Этот адрес можно и открыть, и дать агенту.
Как подключить
Пусть агент поставит его сам
Самый быстрый способ: отправьте агенту в чат это сообщение.
Скачай https://docs.rewio.ru/skill/SKILL.md и сохрани как
~/.claude/skills/rewio-api/SKILL.md. Дальше работай с Rewio по этому файлу.Агент скачает файл и положит куда сказано. Если ваш инструмент не умеет ходить в сеть — откройте ссылку выше, сохраните файл и приложите его к разговору.
Положить руками
Сохраните файл по ссылке выше под именем SKILL.md:
| Куда положить | Путь |
|---|---|
| Для всех ваших проектов | ~/.claude/skills/rewio-api/SKILL.md |
| Только для одного репозитория | .claude/skills/rewio-api/SKILL.md в его корне — тогда скилл попадёт и к коллегам |
Дальше агент подключает скилл сам, как только речь заходит об отзывах; позвать
вручную — /rewio-api.
Другие инструменты
Формат скиллов понимают не все, но текст годится и так — это обычный markdown.
| Инструмент | Куда положить |
|---|---|
| Claude в браузере и приложении | Настройки → «Навыки» (Skills), загрузить файл |
| ChatGPT | Проект → файлы проекта; для своего GPT — раздел Knowledge |
| Gemini | Gem → файлы знаний |
| Cursor | .cursor/rules/rewio-api.mdc |
| Всё остальное | вставить текст в AGENTS.md, в файл правил или прямо в системный промпт |
Где взять ключ и как его передать
Ключ выпускается в личном кабинете app.rewio.ru, раздел «API-ключи». Скилл ключа не содержит и никуда его не сохраняет.
Проще всего — назвать ключ агенту в разговоре:
Мой ключ от Rewio: hrev_…Этого достаточно на всю сессию. Если не хотите повторять это каждый раз,
положите ключ файлом key.txt рядом со скиллом — ~/.claude/skills/rewio-api/key.txt,
одной строкой. Скилл знает про этот файл и прочитает ключ оттуда сам.
Ключ в файле — это ключ на диске. Если кладёте скилл в репозиторий проекта,
key.txt туда попасть не должен: держите его в домашней папке
(~/.claude/skills/…) или добавьте в .gitignore. И не отдавайте ключ со
скоупом full в браузер или в клиентский код — им можно удалить что угодно в
аккаунте.
Попробовать без своего ключа
Демо-ключ (только чтение, только демо-данные):
hrev_FaDGMKJEDDeCR5BCBgEg0aEjMogI7O7hOzE53YY4T1M, демо-объект group_id=20.
Машиночитаемые адреса
Их можно давать агенту напрямую — он выкачает документацию сам.
| Адрес | Что внутри |
|---|---|
docs.rewio.ru/skill/SKILL.md | Скилл целиком: модель данных, методы, ловушки, правила. |
docs.rewio.ru/llms-full.txt | Вся документация одним файлом (обзор, быстрый старт, руководства, справочник). |
docs.rewio.ru/llms.txt | Карта разделов со ссылками — если контекст ограничен, агент выберет нужное. |
api.rewio.ru/v2/openapi.json | OpenAPI 3.1: все эндпоинты, параметры и схемы. Источник истины для любых спорных деталей. |
Проверьте, что агент понял
Прежде чем принимать код, задайте агенту эти вопросы. Ответы должны совпасть —
если нет, он импровизирует: подключите скилл заново или дайте ему SKILL.md
целиком.
| Вопрос | Правильный ответ |
|---|---|
| Как аутентифицироваться? | Заголовок X-API-Key, префикс /v2. |
| Как выглядит список? | {data, total, limit, offset, has_next}, элементы всегда в data. |
| Как узнать, что появилось новое? | Вебхук — не опрос в цикле и не выборка по времени изменения. |
Чем review_date отличается от created_at? | Публикация в местном времени площадки против UTC-времени захвата. |
| Пользователь просит «четвёрки» — какой фильтр? | min_rating=4&max_rating=4.9: это корзина, а не число. |
В какой шкале rating? | 1–5, нормализованная, дробная; исходная — в rating_original. |
| Повторный сбор создаёт дубли? | Нет: отзыв опознаётся по паре «ссылка + его id на площадке» и обновляется. |
| Что делать сразу после создания объекта? | Ждать scrape_status = success / partial / failed, потом читать отзывы. |
| Какие ошибки повторять? | rate_limited, 5xx, сетевые. 402 и квотные — никогда. |
Что означает 202 при публикации ответа? | Приняли в работу; результат — только через GET /v2/reviews/{id}/reply. |
| Откуда берётся формат ссылки? | Из «Где взять ссылку» — адреса не конструируются самостоятельно. |
Скилл описывает API на дату публикации. Если ответ расходится с описанием —
верьте openapi.json и напишите нам:
info@rewio.ru или
@const_rewio. Агент со скиллом умеет сообщить
об этом сам.