На этой странице

CLI и скиллы: подключение одной командой

Два способа дать агенту доступ к срезAI без ручной интеграции: поставить скилл (агент сам знает, что делать) или выполнять команды CLI из терминала. Оба работают с тем же API и ключом, что MCP и REST.

Если вы уже пользуетесь MCP-сервером, CLI и скиллы не заменяют его, а дополняют: MCP удобен готовым клиентам, а CLI дешевле по контексту - в модель попадает только короткое описание навыка, а не описания всех 13 инструментов.

Самый короткий путь: скилл для агента

Скилл - это инструкция для агента: какие инструменты есть, в каком порядке их вызывать, как экономить контекст и что делать при ошибке. Установка - одна команда, обновление - та же команда. Работает в Claude Code, Cursor, Codex и других агентах, которые читают SKILL.md.

bash
npx skills add srezai-team/srezai-web-search-pro-skill

После установки достаточно попросить агента по-человечески: «поищи в интернете», «прочитай эту страницу», «проверь факт по источникам». Команду npx srezai-cli агент подставит сам.

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

Три команды работают без ключа и без регистрации: поиск, чтение страницы и субтитры. Лимит пробного режима - 25 запросов в сутки с одного IP, поэтому «попробовать» ничего не стоит.

bash
# ничего устанавливать не нужно
npx srezai-cli search "изменения в законах об ИИ 2026" --num 5
npx srezai-cli read https://srezai.ru/docs
npx srezai-cli transcript https://youtu.be/VIDEO_ID --languages ru

Поставьте пакет глобально, если CLI нужен постоянно:

bash
npm install -g srezai-cli

srezai whoami          # версия, адрес API и есть ли ключ
srezai search "запрос" --num 5

Пакет опубликован в npm: https://www.npmjs.com/package/srezai-cli. Исходники открыты: https://github.com/srezai-team/srezai-cli.

Ключ и 20 стартовых кредитов

Остальные команды (карта сайта, чтение разделов, извлечение по схеме, проверка утверждений, ответы, deep research, картинки) требуют ключ. Агентский аккаунт создаётся прямо из консоли - это быстрее, чем идти в кабинет:

bash
srezai register --email you@example.com

# вернёт ключ (показывается один раз) и ссылку на оплату без входа
export SREZAI_API_KEY=srz_live_...

Ключ можно хранить в переменной окружения SREZAI_API_KEY или в файле ~/.config/srezai/config.json с правами 600. Второй вариант удобнее для агента: ключ переживает перезапуск терминала и не попадает в историю команд.

bash
mkdir -p ~/.config/srezai
cat > ~/.config/srezai/config.json <<'JSON'
{ "apiKey": "srz_live_ВАШ_КЛЮЧ" }
JSON
chmod 600 ~/.config/srezai/config.json

Что умеет CLI

Двенадцать команд и локальная проверка ключа. Формат вывода - компактный JSON (удобно агенту), флаги --pretty и --human меняют вид вывода, а --help показывает все параметры команды.

search1 кредит

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

read1 кредит

Текст страницы в Markdown, включая PDF и Office. Длинный документ читается окнами через --offset.

map1 кредит / 10 адресов

Карта адресов сайта с разбивкой по разделам: видно, где что лежит.

crawl1 кредит / страница

Карта плюс чтение выбранного раздела - весь раздел за один вызов.

extract2 кредита / ссылка

Извлечение данных по вашей JSON-схеме: в ответ приходят только поля, а не вся страница.

fetch3 кредита

Скриншот страницы в полноценном браузере: когда важно увидеть вёрстку.

verify8 кредитов

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

answer3 / 5 / 10 кредитов

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

deep20 кредитов + токены

Многошаговое исследование. --async возвращает талон, deep status - результат.

transcript1 кредит

Субтитры YouTube с таймкодами и языками.

media1 кредит

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

registerбесплатно

Создать агентский аккаунт и получить ключ (показывается один раз).

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

bash
srezai read https://example.com/long --offset 4000
srezai map https://docs.example.com --search api --limit 30
srezai crawl https://docs.example.com --select-paths /api/ --limit 10
srezai extract https://example.com/card --schema '{"title":"string","price":"number?"}'
srezai verify "Node.js 22 - LTS" --language ru
srezai answer "чем отличается SSE от WebSocket" --depth balanced
srezai deep "сравни Exa и Tavily"          # вернёт id
srezai deep status <id>
srezai media "схема метро Москвы" --num 3

Пробный режим и лимиты

  • Без ключа: search, read, transcript - 25 запросов в сутки на IP, всплеск до 5 запросов за 10 секунд.
  • С ключом: лимиты привязаны к ключу. Точные цифры и заголовки X-RateLimit-* - на странице лимитов.
  • 1 кредит = 0,10 ₽; цены и стартовые 20 кредитов - на странице тарифов. Оплата картой РФ или через СБП, без подписки.

Когда CLI, а когда MCP

MCP-сервер отдаёт агенту описания всех инструментов в каждом запросе - у срезAI это около 10,8 тыс. токенов постоянно. Скилл с CLI держит в контексте только короткое описание нужного навыка: типичная задача стоит 0,3-1,7 тыс. токенов.

  • MCP - клиент уже его умеет (Claude Desktop, Cursor, n8n), не хочется ставить Node, нужен максимум готовых инструментов сразу.
  • CLI + скилл - агент умеет запускать команды, важна экономия контекста и воспроизводимость (скрипты, CI, bash-пайплайны).

Обновление

bash
npm update -g srezai-cli      # обновить CLI
npx skills add srezai-team/srezai-web-search-pro-skill   # обновить скилл (перезапишет старую версию)

Версии выходят по тегам через GitHub Actions и npm trusted publishing (OIDC), с provenance-аттестацией. Каталог скиллов: https://skills.sh/srezai-team/srezai-web-search-pro-skill; исходники скиллов: https://github.com/srezai-team/srezai-web-search-pro-skill.

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

  • CLI ходит только на https://srezai.ru - адрес API зашит в сборке и не переопределяется переменными окружения.
  • У пакета ноль зависимостей; публикация - с provenance, исходники открыты.
  • CLI не читает локальные файлы и не исполняет ничего из аргументов: все проверки (SSRF, права, лимиты) выполняются на сервере.
  • Телеметрии и записи ключа в логи нет.

Что дальше