Speakeasy CLI
CLI проверяет описание OpenAPI и создает клиентские библиотеки, MCP-серверы и другие интерфейсы для вашего API.
- 458 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- CLI генерирует и обновляет файлы, а настроенные задания могут публиковать пакеты; просматривайте изменения и ограничивайте полномочия CI.
Установка
- Работает в
Ручная установка
brew install speakeasy-api/tap/speakeasyПервый вариант официального руководства, на которое ссылается README: Homebrew для macOS. Для другой системы выберите ее вариант в руководстве.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI генерирует и обновляет файлы, а настроенные задания могут публиковать пакеты; просматривайте изменения и ограничивайте полномочия CI.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Speakeasy CLI помогает команде выпускать инструменты доступа к своему API из описания OpenAPI. Пользователь проверяет спецификацию, выбирает результат генерации и получает исходный код для дальнейшей разработки. Кроме клиентских библиотек поддерживаются MCP-серверы и провайдеры Terraform. В наборе есть средства сравнения и изменения спецификаций, генерации примеров кода и контрактных тестов. Для работы из кодинг-агента автор выпускает отдельные скиллы, которые описывают создание и обновление проекта.
Для кого. Командам публичных API, которые поддерживают клиентские библиотеки и хотят обновлять их вместе со спецификацией.
Подходит, если
- После изменения OpenAPI вы готовите новую версию клиентской библиотеки.
- Для своего API нужно создать MCP-интерфейс агента.
- Перед генерацией команда проверяет структуру и отличия спецификации.
- В документацию требуются согласованные примеры вызовов API.
Не подходит, если
- У API нет пригодного описания, а подготовить его сейчас невозможно.
- Вы ожидаете готовую бизнес-логику сервиса из одной схемы.
- Сгенерированный код нельзя просмотреть и протестировать перед выпуском.
Пример запроса к агенту
Проверь нашу спецификацию OpenAPI и подготовь клиентскую библиотеку в отдельной ветке, показав изменения до публикации.Ограничения
Генерация зависит от полноты OpenAPI: проверьте схемы, типы и описания операций до запуска. Начальная настройка требует входа в аккаунт Speakeasy и выбора рабочего пространства, поэтому подготовьте доступ заранее. CLI создает и обновляет файлы проекта; запускайте генерацию в отдельной ветке и просматривайте патч перед выпуском. Контрактные тесты проверяют заданное описание API, но не заменяют испытание реального сервиса и поведения клиента в вашем приложении.
Как отключить. Отключите задания генерации и публикации в CI, затем удалите CLI удобным для своего способа установки средством. Полученный код и настройки проекта останутся.
Частые вопросы
Как начать первый проект?
Запустите `speakeasy quickstart` и пройдите мастер.
Где посмотреть параметры команды?
Каждая команда и подкоманда поддерживает `--help`.
Можно ли подключить инструкции к агенту?
Да. Команда `npx skills add speakeasy-api/agent-skills` ставит отдельный набор скиллов.
Как попросить агента проверить спецификацию?
После установки скиллов используйте `/speakeasy:validate-openapi-spec`.
Что использовать при обновлении SDK?
В наборе агентских скиллов есть `/speakeasy:regenerate-sdk`. Перед применением результата просмотрите изменения.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI собирает готовый MCP-сервер на TypeScript из спецификации OpenAPI 3: инструменты, валидация и авторизация генерируются сами
MCP-сервер превращает операции OpenAPI в инструменты агента и отправляет реальные запросы к указанному REST API.
OpenMCP превращает любую OpenAPI-спецификацию в MCP-сервер и дает выбрать, какие инструменты показывать агенту
CLI, MCP-сервер и скилл для разработки по спецификациям: короткие спеки в markdown, доска задач и поиск, понятные агенту.
CLI превращает спецификацию OpenAPI в Agent Skill из markdown-файлов, которые агент читает по частям и экономит контекст.
LAP — компактные спецификации API для агентов
LAP (Lean API Platform)
CLI lapsh сжимает спецификации OpenAPI и GraphQL в короткий формат для агента и ставит навык в Claude Code, Cursor и Codex
Коротко о README
Инструментарий использует OpenAPI Overlays для изменений схем и Arazzo для контрактных сценариев. Поддерживаются несколько языков клиентских библиотек.