← Все проекты
Проект / Python

fendoushaonian/WindSurf-gRPC-API: WindSurf-gRPC-API — Python SDK для полного контроля над Windsurf IDE

Получите доступ ко всем 560+ внутренним API популярного AI-редактора Windsurf через простой Python-клиент.

Это reverse-engineering проект, который превращает закрытый протокол AI-редактора Windsurf в открытый Python SDK. Автор извлёк все gRPC-сервисы из бинарника Language Server, предоставив полный доступ к пользовательским данным, управлению командами, вызову...

★ 13 Python Форки 7 Issue 0 Оценка 5/10 Карточка проверена

Для кого это

Для Python-разработчиков и DevOps-инженеров, которые хотят автоматизировать работу с Windsurf IDE, создавать ботов или исследовать его внутреннюю архитектуру.

Проблема / задача

Windsurf — мощный AI-редактор, но его официальный API ограничен или отсутствует, что мешает интеграции и автоматизации.

Как это работает

Проект реверсит бинарный файл Language Server от Windsurf, извлекая все gRPC-протоколы общения клиента с сервером. Полученные 13 сервисов и 560+ методов упаковываются в чистый Python SDK без внешних зависимостей. Используется Connect-protocol (gRPC поверх HTTP/1.1 с JSON), что позволяет работать только со стандартной библиотекой Python.

Что видно по README

Это reverse-engineering проект, который превращает закрытый протокол AI-редактора Windsurf в открытый Python SDK. Автор извлёк все gRPC-сервисы из бинарника Language Server, предоставив полный доступ к пользовательским данным, управлению командами, вызову AI-моделей, работе с плагинами MCP и даже экспериментальным функциям.

Ключевые возможности

Полный доступ к 560+ API-методам WindsurfУправление пользователями и командамиПросмотр доступных AI-моделей (Claude, GPT, Gemini)Работа с MCP-плагинами и OAuth-даннымиВнедрение экспериментальных функций в локальный Language Server

Технологии

Python 3.12+gRPC Connect-protocolPythonOpenAI APIgRPCProtobuf

Интересный факт

В SDK обнаружены и доступны OAuth-ключи для GitHub Copilot, которые Windsurf использует для интеграции с плагинами MCP.

С чего начать

  • Клонируйте репозиторий и установите через pip
  • Получите API-ключ через аутентификацию (GitHub/Google/email)
  • Используйте WindsurfClient для вызова любого из 560+ методов

Оценка GitRadar

Удобство
6/10
Свежесть
8/10
Перспектива
4/10
Монетизация
3/10
Общая оценка
5/10

Вердикт GitRadar

Стоит пробовать разработчикам, интересующимся reverse-engineering или создающим инструменты для AI-редакторов. Проект технически интересен, но имеет этические и юридические риски из-за работы с закрытыми API.

Наблюдения по обновлениям

Проект активно развивается (версия 3.0.0), есть CLI-интерфейс, но звёзд пока мало (11), что говорит о нишевой аудитории.

Что мы проверили

Карточка собрана по данным GitHub, README и структуре репозитория. Это не официальная документация проекта.

Исходный репозиторий
https://github.com/fendoushaonian/WindSurf-gRPC-API
Лицензия
MIT
Создан на GitHub
20 апреля 2026 г.
Последнее обновление репо
20 апреля 2026 г.
Последняя проверка GitRadar
20 апреля 2026 г.
Изученные файлы
README.md, pyproject.toml, windsurf_api/cli.py, windsurf_api/services/__init__.py, windsurf_api/services/plugins.py, windsurf_api/services/analytics.py

FAQ

Что это такое?

Python-библиотека, которая даёт полный доступ к внутренним API редактора Windsurf через reverse-engineering его протокола.

Для кого подходит?

Для разработчиков, которые хотят автоматизировать Windsurf, исследовать его архитектуру или создавать интеграции.

Источники

  • GitHub исходный код и активность
  • README описание, ссылки, стартовые материалы

Нужна помощь с fendoushaonian/WindSurf-gRPC-API?

Если проект подходит под ваш сценарий, можем помочь с установкой, интеграцией, доработкой или аккуратным форком под вашу инфраструктуру.