RepoRadar Social SDK: TypeScript SDK для интеграции с социальными платформами
Social SDK — это TypeScript SDK для интеграции с социальными платформами с возможностью проверки функционала и тестирования. Проект предназначен для разработчиков, которые хотят просто и быстро добавить социальные функции в свои приложения, такие как публикация контента, чтение данных и получение аналитики на платформах вроде X, Threads, TikTok, Instagram, LinkedIn, YouTube и Bluesky.
Ключевое отличие от других решений — типизированный интерфейс и возможность выбора между прямым доступом к платформам или управляемыми бэкендами, такими как Zernio и Buffer. SDK поддерживает не только прямые адаптеры, но и предоставляет единые результаты по каждой цели, что упрощает обработку запросов и диагностику. Если работаешь на Node.js 22.12+ или Bun, интеграция происходит через npm или bun, что обеспечивает безопасность работы с токенами и секретами.
Обрати внимание, что SDK пока не поддерживает другие языки и платформы, и может хорошо подойти для малых команд и стартапов, ищущих простое решение для интеграции социальных функций.
Проект Social SDK — это открытый инструмент для разработчиков на TypeScript, который помогает добавлять социальные функции в приложения. Он ориентирован на индивидуальных разработчиков и небольшие команды, стремящиеся интегрировать возможности различных социальных платформ, таких как X, Threads, Bluesky, YouTube, TikTok, Instagram и LinkedIn, через единый интерфейс.
Social SDK предлагает два подхода для работы с социальными платформами: можно использовать прямой доступ к платформам или управляемые бекенды, такие как Zernio, Post for Me, PostFast, Postiz и Buffer. Таким образом, разработчики могут выбрать наиболее подходящий способ интеграции для своих нужд.
Установка
Проект требует Node.js версии 22.12+ или Bun и не рекомендуется использовать в браузере для хранения токенов и секретов. Установить Social SDK можно с помощью следующих команд:
npm install @opencoredev/social-sdk
# или
bun add @opencoredev/social-sdk
Для получения подробной информации о настройке приложения и интеграции загляни в руководство по установке.
Использование
Для проверки интеграции без необходимости вводить учетные данные или расходовать запросы к платформе, можно начать с мок-бекенда. Например:
import { createSocial, connectedAccountRef } from "@opencoredev/social-sdk";
import { mockBackend } from "@opencoredev/social-sdk/testing";
const social = createSocial({
backend: mockBackend({ scenario: "immediate-text-success" }),
});
const result = await social.posts.publish({
targets: [
{
account: connectedAccountRef({
backend: "default",
platform: "x",
accountId: "mock-account-1",
}),
},
],
content: { text: "Hello from Social SDK" },
idempotencyKey: "quickstart-1",
});
console.log(result.status, result.outcomes[0]?.state);
// complete published
Ты можешь использовать тот же клиент с прямым адаптером платформы или управляемым бекендом, импортируя только нужный адаптер из документации.
Ограничения и возможности
Social SDK предлагает адаптеры для различных платформ, включая Bluesky, Instagram, LinkedIn, Threads, TikTok, X и YouTube. Также доступны управляемые маршруты выполнения через указанные бекенды. Обрати внимание, что выбор адаптера зависит от возможностей, которые описаны в матрице возможностей платформы.
CLI
CLI Social SDK работает в оффлайн-режиме и не требует аутентификации учетных записей или выполнения скрытых сетевых запросов. Чтобы запустить команду, используй:
npm exec -- social-sdk adapters --json
npm exec -- social-sdk capabilities --adapter youtube --json
npm exec -- social-sdk doctor --adapter zernio --json
npm exec -- social-sdk examples --json
npm exec -- social-sdk validate --adapter mock --file request.json --json
Установка пакета добавляет бинарные файлы в ваш проект в `node_modules/.bin`, и для выполнения команд нужно находиться в директории проекта.
Документация
Полная документация доступна на сайте social-sdk.dev/docs. Хорошие места для начала:
Открыть на GitHub: opencoredev/social-sdk →
