socialkit (s-socialkit)

Общий слой домена соцсетей — то, что одинаково у Telegram, VK, Instagram, TikTok, Threads, YouTube, Rutube, Дзена, vc.ru, ok.ru, Boosty, Reddit, Pinterest и MAX. Аналог aichatkit для ИИ-чатов.

Зачем

Соцсети работают так же, как ИИ-чаты: навык объявляет способности видами, а оркестратор зовёт вид, а не сервис. Тогда веер («найти конкурентов во всех соцсетях») получается сам собой — спросили всех, кто объявил вид, — а новая соцсеть подключается установкой пакета, без правки ядра.

До этого единицей подключения была ВСЯ СЕТЬ: маршрут веера лежал таблицей CROSSPOST_ROUTES, перечень сетей — закрытым NetworkId на шестнадцать значений, а способность выяснялась двумя десятками булевых флагов уже ПОСЛЕ загрузки адаптера.

Состав 0.0.1

Виды

Ядро (веерится): publish · content · media · comments · feed · metrics · search · profile · session · export.

Второй эшелон (объявлен, волну не блокирует): engagement · schedule · members · messages · collection · events.

Порог объявления — повторяемость намерения (умеют трое и больше), а не похожесть кода. Уникальное (market ВКонтакте, star revenue Телеграма, протокол MAX) остаётся своей командой навыка: вид с одним носителем — это переименованный сервис.

Правила контракта

• вид и метод зовутся ОДНИМ словом — помнить соответствие не приходится;
• имя сервиса живёт ТОЛЬКО в координате точки входа <сервис>_<вид>;
• вызов однороден: ctx есть у любого вида и везде со значением по умолчанию. У чатов это разъехалось, и наивный вызов падал TypeError на первом же сервисе. Проверяется машиной: socialkit.uniformity_problems(навык);
• сырой ответ сервиса всегда лежит в raw;
• «не знаю» говорится прямо: None, а не ноль и не выдуманный вердикт.

Чего в ките нет и не будет

Транспорта (netkit), браузера, минта и хранилища сессий (librarykit), пула аккаунтов (accountpoolkit), троттлинга и реестра адресов (adapterkit), веера (это оркестратор). Кит про ЗНАНИЕ домена, а не второй фреймворк.

Установка

pip install s-socialkit

Использование

from socialkit import CAPABILITY_METHOD, CORE_KINDS, capability_id, uniformity_problems
from socialkit import ContentItem, ContentType, Visibility

# навык объявляет точку входа
capability_id("vk", "publish")            # → "vk_publish"

# оркестратор зовёт вид, не зная имени сервиса
метод = getattr(навык, CAPABILITY_METHOD["publish"])
метод(ContentItem(service="vk", type=ContentType.POST, visibility=Visibility.PUBLIC))

# навык проверяет себя сам: объявленное обязано быть позываемым
assert uniformity_problems(навык) == []

Разработка

python -m pytest -q     # 41 тест
python -m ruff check .