TL;DR

  • Social SDK는 Bluesky, Instagram, LinkedIn, Threads, TikTok, X, YouTube용 타입 안전(TypeScript) 통합 툴킷으로, 직접 어댑터 또는 선택형 관리형 백엔드를 사용하면서 계정 선택, 기능, 콘텐츠, 전송 결과를 명시적으로 처리함.
  • Zernio, Post for Me, PostFast, Postiz 관리형 백엔드는 선택 사항이며, 직접 플랫폼 통합에는 Social SDK 계정이 필요하지 않음.
  • 기능 매니페스트와 플랫폼 고유 작업은 타입으로 정의되며, 독립적인 목적지별 결과에 완료, 처리 중, 불확실, 실패 상태가 포함됨.
  • 로컬 개발과 계약 테스트를 위한 결정론적 모의 백엔드와 어댑터 탐색, 기능 확인, 진단, 요청 검증을 지원하는 오프라인 CLI를 제공함.
  • Node.js 22.12 이상 또는 Bun의 신뢰할 수 있는 서버 측 코드에서 실행하며, 플랫폼 토큰과 비밀 키를 브라우저 번들에서 제외해야 함.

설치

  • Social SDK는 Node.js 22.12 이상 또는 Bun을 사용하는 신뢰할 수 있는 서버 측 코드에서 실행함.
  • 플랫폼 토큰, 관리형 제공업체 키, OAuth 비밀 키, 웹훅 비밀 키를 브라우저 번들에 포함하지 않아야 함.
  • npm install @opencoredev/social-sdk 또는 bun add @opencoredev/social-sdk로 설치함.
  • 애플리케이션 설정과 통합 옵션은 설치 가이드에서 확인할 수 있음.

사용법

  • 자격 증명, 플랫폼 호출, 비용이 청구되는 제공업체 요청 없이 통합을 검증하려면 모의 백엔드부터 사용함.
  • 예제는 mockBackend({ scenario: "immediate-text-success" })로 모의 백엔드를 설정하고, connectedAccountRef로 X의 모의 계정을 지정한 뒤 social.posts.publish로 텍스트 콘텐츠를 게시함.
  • 요청에 idempotencyKey를 전달하며, 결과 상태와 첫 번째 목적지의 결과 상태를 출력함. 예제에서 출력되는 값은 complete published임.
  • 직접 플랫폼 어댑터와 관리형 백엔드 모두 같은 클라이언트 형태를 사용하며, 사용하는 어댑터만 문서화된 하위 경로에서 가져옴.

플랫폼과 백엔드

  • 직접 플랫폼 어댑터는 Bluesky, Instagram, LinkedIn, Threads, TikTok, X, YouTube를 지원함.
  • 호스팅 실행 경로는 Zernio, Post for Me, PostFast, Postiz 어댑터를 통해 제공됨.
  • 관리형 서비스는 선택 사항이며, 직접 통합에는 Social SDK 계정이 필요하지 않음.
  • 어댑터를 선택하기 전에 플랫폼 기능 매트릭스를 확인함. 매트릭스는 통합별로 구현된 정규화 작업을 설명하며, 제공업체 권한, 계정 적격성, 실제 환경 검증을 대체하지 않음.

CLI

  • social-sdk CLI는 오프라인으로 동작하며, 계정 인증, 미디어 업로드, 콘텐츠 게시 또는 숨겨진 네트워크 요청을 수행하지 않음.
  • social-sdk adapters --json으로 어댑터를 확인함.
  • social-sdk capabilities --adapter youtube --json으로 YouTube 기능을 확인함.
  • social-sdk doctor --adapter zernio --json으로 Zernio 진단을 수행함.
  • social-sdk examples --json으로 예제를 확인함.
  • social-sdk validate --adapter mock --file request.json --json으로 요청을 검증함.
  • 명령 출력, 검증 제한, 종료 코드는 CLI 참조 문서에서 확인할 수 있음.

문서

  • 전체 문서는 social-sdk.dev/docs에서 제공함.
  • 시작하기 좋은 문서는 설치, 모의 백엔드 빠른 시작, 통합 선택, 콘텐츠 게시, 결과 처리와 조정임.

후원사

  • Social SDK는 플랫폼 통합을 실용적이고 유지 관리 가능한 상태로 지원하는 기업의 후원을 받음.
  • PostFast: 공개 API를 제공하는 소셜 미디어 일정 관리 서비스임.
  • Postiz: 호스팅 또는 자체 호스팅 방식의 오픈소스 소셜 미디어 일정 관리 서비스임.
  • MIT 라이선스이며 @leodev가 구축함.