코드에서 바로 게시하세요. 같은 흐름을 프로그래밍으로.

대시보드의 모든 작업이 REST 엔드포인트예요. 게시, 예약, 계정, 분석, 웹훅. 공식 TypeScript SDK. Claude Desktop, Cursor, ChatGPT용 MCP 서버. 워크스페이스별로 범위가 정해진 API 키라 아무것도 새지 않아요.

예측 가능한 리소스로 구성된 깔끔한 REST API
npm의 TypeScript SDK와 독립형 MIT PHP 라이브러리
Claude, Cursor, ChatGPT용 MCP 서버(도구 14개)
워크스페이스별, 작업별로 범위가 정해진 API 키
실제 API 모습

코드 세 줄. 플랫폼 세 곳에 예약 완료.

실제 게시 호출 구조예요. 워크스페이스를 고르고, 캡션과 플랫폼을 넘기면, 게시물 id와 플랫폼별 전송 상태가 돌아와요. TypeScript, PHP, curl 어디서든 같은 호출이에요.

POST/v1/posts
TypeScript
PHP
curl
import { FoPost } from '@fopost/sdk';

const client = new FoPost({ apiKey: process.env.FOPOST_API_KEY });

const accounts = await client.accounts.list({ workspaceId });

const post = await client.posts.create({
  workspaceId,
  status:     'scheduled',
  scheduleAt: '2026-09-01T09:00:00Z',
  content:    [{ text: 'Stop launching on Tuesday.', position: 0 }],
  accounts:   accounts.map((a) => ({ id: a.id })),
});
응답200 OK · 142ms
게시물 IDpst_01H7K3MRGB8YZ4QVW
전송(3)
X예약됨 · 월요일 오전 9:00 UTC
LinkedIn예약됨 · 월요일 오전 9:00 UTC
Bluesky예약됨 · 월요일 오전 9:00 UTC
직접 관리하는 공식 TypeScript SDK
키별 범위: 게시물, 계정, 분석
모든 이벤트에 웹훅 콜백
플랫폼 API 33개를 직접 연결하는 대가

Twitter 연동을 만들었더니 LinkedIn이 전부 바꿔 버렸어요.

Twitter 게시 기능은 주말 하루 만에 만들었어요. 그런데 LinkedIn에 3일, OAuth 흐름에 일주일이 걸렸고, Instagram API는 세상에서 제일 불편하고, TikTok은 시작도 못 했어요.

플랫폼마다 같은 날 다른 방식으로 망가져요. Bluesky는 속도 제한을 바꾸고, Threads는 미디어 유형 제한을 추가하고, Hashnode는 GraphQL 버전을 바꿔요. 연동은 불타는데 제품도 만들어야 해요.

플랫폼 5개의 OAuth를 직접 만들고 리프레시 토큰을 DB에 저장했어요. 이제 토큰 갱신, 암호화 저장, SOC 2 수준의 키 관리까지 책임져야 해요. 원래 하려던 사업이 아니잖아요.

나에게 맞을까요?

API가 필요한가요?

이런 분께 맞아요

  • 사용자 대신 소셜에 게시해야 하는 제품을 만들고 있다
  • CI, CRM, 자체 백엔드에서 실행되는 콘텐츠 운영 파이프라인을 운영한다
  • MCP로 FoPost를 Claude Desktop, Cursor, ChatGPT에 연결해 에이전트가 대신 게시하게 하고 싶다
  • 에이전시용 도구를 만들면서 플랫폼 연동 33개를 직접 관리하지 않고 클라이언트에게 소셜 게시 기능을 제공하고 싶다

이런 분께는 맞지 않아요

  • 대시보드에서 직접 게시만 한다면 API는 과해요. 편집기가 맞는 도구예요.
  • 완전한 화이트 라벨 API 호스팅(your-brand.api.com)이 필요하다면 엔터프라이즈 계약에 대해 문의해 주세요.
포함된 기능

API 하나. 플랫폼 32개. 장애 대응은 저희 몫이에요.

스키마 하나에 맞춰 쓰면, 저희가 32개 플랫폼으로 보내고, 토큰을 갱신하고, 속도 제한을 처리하고, 게시물을 전달하고, 오류를 알려 드려요. 기능 출시에만 집중하세요.

깔끔하고 예측 가능한 REST

예측 가능한 리소스(게시물, 계정, 워크스페이스, 전송, 웹훅). 모든 엔드포인트에서 요청과 응답 형태가 일관되고, /v1 아래에서 버전이 관리돼요.

TypeScript SDK와 독립형 PHP 라이브러리

TypeScript(npm install @fopost/sdk)는 이 REST API를 감싸요. PHP(composer require fopost/social-core, MIT 라이선스)는 독립형이라 FoPost 계정 없이 직접 보유한 인증 정보로 11개 플랫폼에 바로 게시해요.

AI 어시스턴트용 MCP 서버

npx -y @fopost/mcp로 FoPost 워크스페이스를 Claude Desktop, Cursor, ChatGPT 등 MCP 호환 에이전트에 연결해요. 게시, 예약, 분석, 계정 관리 등 도구 14개를 쓸 수 있어요. 인증은 API 키로 해요.

워크스페이스별 범위 지정 키

작업 범위가 있는 워크스페이스별 키: posts, accounts, workspaces, labels, publish, deliveries, webhooks, analytics, automations. UI에는 JWT, 코드에는 API 키. 에이전시 전체를 다루는 슈퍼 키는 없어요.

모든 이벤트에 발신 웹훅

publish.success, publish.failed, account.disconnected, account.reconnected, automation.triggered 등을 구독하세요. 모든 페이로드에 서명이 있어 저희가 보낸 것인지 확인할 수 있고, 실패한 전송은 지수 백오프로 재시도해요.

실제 작업에 맞춘 속도 제한

한도는 게시 연동에 필요한 양보다 훨씬 넉넉하고, 계정을 더 연결할수록 자동으로 올라가요. 한도를 넘으면 조용히 버려지거나 키가 정지되는 게 아니라, 기다릴 시간을 알려 주는 Retry-After와 함께 깔끔한 429를 받아요.

작동 방식

발급하고. 설치하고. 게시하세요.

01

API 키 발급

게시할 워크스페이스에서 필요한 범위로 API 키를 만드세요(시작은 posts와 accounts면 충분해요). 키는 한 번만 복사할 수 있어요. 비밀번호처럼 다루세요.

02

SDK 설치

npm install @fopost/sdk. SDK 없이 REST 엔드포인트를 바로 호출해도 되고, 둘 다 건너뛰고 Claude에서 MCP 서버를 써도 돼요.

03

호출하기

import, 인스턴스 생성, create. 세 줄이면 돼요. 게시 호출은 게시물 id와 플랫폼별 전송 상태를 돌려줘요. 게시물은 대시보드 대기열에 들어가 예약한 시간에 나가요.

04

웹훅 구독(선택)

워크스페이스 설정에서 웹훅 URL을 추가하고 publish.success와 publish.failed를 구독하세요. 전송이 성공하거나 실패할 때마다 엔드포인트로 서명된 POST가 와요. 이제 시스템이 항상 동기화돼요.

다른 도구와 비교

플랫폼 연동 33개를 직접 만드는 것보다 나은 이유.

개발자가 멀티 플랫폼 게시에 접근하는 세 가지 방법. SDK와 MCP 서버를 갖춘 진짜 API에, 장애 대응까지 남이 맡아 주는 방법은 하나뿐이에요.

DIY: 플랫폼 API 33개를 직접

개발자 출신 창업자가 시도하는 방식

  • 플랫폼마다 OAuth 흐름. 토큰 저장. 토큰 갱신. 비밀 정보 암호화 처리.
  • 플랫폼마다 다른 속도 제한, 다른 오류 형태, 다른 미디어 제약.
  • LinkedIn이 API를 바꾸면 내 코드도 바꿔야 해요. Bluesky, Threads, Hashnode도 마찬가지예요.
  • Twitter와 LinkedIn 이후로 플랫폼 추가를 멈춰요. 나머지 29개는 위시리스트에 남아요.

Buffer나 Hootsuite API

기존 업체가 제공하는 것

  • 공개 API는 있지만 뒷전인 느낌이에요. SDK는 커뮤니티가 관리하고, 그나마도 가끔이에요.
  • MCP 서버가 없어요. Claude나 Cursor에 연결하려면 맞춤 연동을 만들어야 해요.
  • 좌석당 요금 때문에 에이전시에게 API는 비용 부담이에요.
FoPost

FoPost API + SDK + MCP

실제로 원하는 것

  • REST 스키마 하나로 32개 플랫폼을 다루고, 쓰기 API가 없는 Substack은 브라우저 확장 프로그램이 맡아요.
  • 직접 관리하는 TypeScript SDK와 MIT PHP 라이브러리.
  • MCP 서버는 지금 바로 사용 가능: npx -y @fopost/mcp로 Claude Desktop, Cursor, ChatGPT에 연결.
  • 워크스페이스별 범위 키, 서명된 웹훅, 기본 재시도. 장애 대응은 저희 몫이에요.

모든 주요 네트워크에 게시

자주 묻는 질문

API가 포함되어 있나요?

네. 모든 계정에 읽기와 쓰기 권한이 전부 주어져요. 엔드포인트, 범위, SDK는 누구에게나 같아요. 요청 한도는 계정을 더 연결할수록 자동으로 올라가요.

API 레퍼런스는 어디에 있나요?

fopost.com/docs/api에 모든 엔드포인트에 대한 TypeScript, PHP, curl 코드 예시와 함께 전체 레퍼런스가 있어요.

SDK는 유료인가요?

아니요. TypeScript(@fopost/sdk)는 npm에서 무료로 제공되며, 모든 계정에 포함된 이 API와 통신해요. PHP 라이브러리(composer require fopost/social-core, MIT 라이선스)는 무료 독립형이라 직접 보유한 인증 정보로 11개 플랫폼에 바로 게시하고, FoPost 계정이 전혀 필요 없어요. 저희 Laravel 패키지도 이 라이브러리로 동작해요.

Claude, Cursor, ChatGPT용 MCP는요?

npm의 @fopost/mcp로 지금 바로 쓸 수 있어요. npx -y @fopost/mcp를 실행하면 stdio MCP 서버가 뜨고, MCP 호환 클라이언트(Claude Desktop, Cursor, ChatGPT 데스크톱, Goose, Continue)에 연결해 FOPOST_API_KEY로 인증하면 게시, 예약, 게시물 목록, 분석 조회, 계정 관리 등 도구 14개를 쓸 수 있어요.

API 키 범위는 어떻게 작동하나요?

키는 워크스페이스 하나에 묶이고, 만들 때 고른 작업 범위 목록을 가져요: posts, workspaces, accounts, labels, publish, deliveries, webhooks, analytics, automations. "accounts" 범위가 없는 키는 사용자가 해당 작업을 승인했더라도 계정을 조회하거나 수정할 수 없어요. 범위는 매 호출마다 서버에서 확인해요.

속도 제한은 어느 정도로 예상해야 하나요?

일반적인 게시 트래픽은 어떤 요금제에서도 한도 근처에 가지 않아요. 한도는 키에 연결된 요금제에 따라 달라지고, API로 가장 많이 자동화하는 등급인 Business가 가장 높은 한도를 써요. 429는 다른 API와 똑같이 처리하면 돼요. 모든 응답에 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset이 있고 429에는 Retry-After가 추가되니, 잠시 기다렸다 재시도하면 더 신경 쓸 일이 없어요. 정확한 기준값은 약속이 아니라 계속 바뀌는 남용 방지 장치라서 공개하지 않아요.

웹훅 페이로드에 서명하나요?

네. 모든 웹훅 POST에는 본문과 웹훅 시크릿으로 만든 서명 헤더가 있어서, 신뢰하기 전에 저희가 보낸 페이로드인지 확인할 수 있어요. 확인 방법은 문서에 있어요. 실패한 전송은 포기하기 전에 지수 백오프로 여러 번 재시도해요.