BulkPublish API

자동화, AI 에이전트 및 LLM을 위해 구축된 무료 소셜 미디어 API입니다.

단일 API 호출로 11개 플랫폼에 프로그래밍 방식으로 게시하세요. 브라우저 세션이나 수동 상호 작용 없이 안정적인 소셜 미디어 자동화가 필요한 개발자, AI 에이전트, LLM 및 에이전트 워크플로우를 위해 구축되었습니다.

from bulkpublish import BulkPublish

bp = BulkPublish("bp_your_key_here")
bp.posts.create(
    content="Launching our new product today!",
    channels=[{"channelId": 1, "platform": "x"}, {"channelId": 2, "platform": "linkedin"}],
    status="scheduled",
    scheduled_at="2026-04-10T09:00:00Z",
)

왜 BulkPublish인가요?

대부분의 소셜 미디어 도구는 버튼을 클릭하는 사람들을 위해 만들어졌습니다. BulkPublish는 코드를 위해 만들어졌습니다. 개발자가 작성한 코드든, AI 에이전트든, 도구를 사용하는 LLM이든, 자율 워크플로우든 상관없습니다.

• 헤드리스 설계 — 런타임 시 브라우저, UI, OAuth 팝업이 없습니다. 대시보드에서 계정을 한 번 연결하면 API를 통해 모든 것을 자동화할 수 있습니다.

• AI 네이티브 — Claude용 MCP 서버, GPT 및 LangChain용 도구 정의, LLM이 안정적으로 파싱할 수 있는 구조화된 JSON 응답을 제공합니다.

• 에이전트 준비 완료 — 명확한 오류 코드가 포함된 결정론적 API입니다. AI 에이전트가 자율적으로 게시물을 생성하고, 상태를 확인하고, 실패 시 재시도하고, 분석 데이터를 읽을 수 있습니다.

• 11개 플랫폼, 하나의 엔드포인트 — Facebook, Instagram, X/Twitter, TikTok, YouTube, Threads, Bluesky, Pinterest, Google Business Profile, LinkedIn, Mastodon을 지원합니다.

사용 사례

• AI 소셜 미디어 관리자 — Claude, GPT 또는 맞춤형 에이전트가 자율적으로 게시물을 예약하고 게시하도록 합니다.

• 콘텐츠 파이프라인 — RSS-to-social, 블로그-to-social, 뉴스레터-to-social 자동화

• 대량 예약 — CSV를 업로드하거나 콘텐츠 캘린더를 입력하여 몇 주 분량의 게시물을 프로그래밍 방식으로 예약합니다.

• 교차 플랫폼 배포 — 플랫폼별 콘텐츠 최적화를 통해 모든 플랫폼에 한 번에 게시합니다.

• 분석 대시보드 — 참여 데이터를 자체 도구, 스프레드시트 또는 AI 분석으로 가져옵니다.

• Zapier/n8n/Make 대안 — 미들웨어 없이 직접 API에 액세스하여 지연 시간을 줄이고 제어력을 높입니다.

• LLM 기반 콘텐츠 생성 — AI로 콘텐츠를 생성하고, BulkPublish로 게시하고, 성과를 추적하고, 반복 개선합니다.

빠른 시작

1. 가입하기

app.bulkpublish.com에서 무료 계정을 만드세요.

2. API 키 받기

대시보드의 Settings > Developer로 이동하여 API 키를 생성하세요. 키는 bp_로 시작하며 한 번만 표시되므로 안전하게 저장하세요.

3. 플랫폼 연결

대시보드의 Channels에서 소셜 계정을 연결하세요. API는 연결된 채널을 사용하여 게시합니다.

4. SDK 설치

Python

pip install bulkpublish

Node.js

npm install bulkpublish

또는 curl, fetch, requests 또는 기타 HTTP 클라이언트를 사용하여 REST API를 직접 호출하세요.

5. 첫 번째 API 호출하기

curl -X POST https://app.bulkpublish.com/api/posts \
  -H "Authorization: Bearer bp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from the BulkPublish API!",
    "channels": [{"channelId": 1, "platform": "linkedin"}],
    "status": "draft"
  }'

AI 에이전트 통합

MCP 서버 (Claude, Cursor, Windsurf, Claude Code)

BulkPublish는 AI 어시스턴트가 소셜 미디어를 직접 관리할 수 있도록 MCP 서버를 제공합니다:

{
  "mcpServers": {
    "bulkpublish": {
      "command": "npx",
      "args": ["-y", "@bulkpublish/mcp-server"],
      "env": {
        "BULKPUBLISH_API_KEY": "bp_your_key_here"
      }
    }
  }
}

create_post, list_channels, upload_media, get_analytics 등 12개의 도구를 사용할 수 있습니다. mcp-server/README.md를 참조하세요.

LLM 도구 사용 / 함수 호출

자율 AI 에이전트를 위한 즉시 사용 가능한 도구 정의:

• Claude tool_use 예제 — 게시물 예약을 위한 도구 정의가 포함된 Anthropic SDK

• OpenAI 함수 호출 예제 — 게시물 관리를 위한 함수가 포함된 GPT-4

• LangChain 도구 예제 — BulkPublish 도구가 포함된 LangChain 에이전트

모든 예제는 오류 처리가 포함된 완전하고 실행 가능한 스크립트입니다.

코드 예제

게시물 생성

from bulkpublish import BulkPublish

bp = BulkPublish("bp_your_key_here")

post = bp.posts.create(
    content="Check out our latest update!",
    channels=[
        {"channelId": 1, "platform": "facebook"},
        {"channelId": 2, "platform": "x"},
        {"channelId": 3, "platform": "linkedin"},
    ],
    status="draft",
)

import { BulkPublish } from 'bulkpublish';

const bp = new BulkPublish({ apiKey: 'bp_your_key_here' });

const post = await bp.posts.create({
  content: 'Check out our latest update!',
  channels: [
    { channelId: 1, platform: 'facebook' },
    { channelId: 2, platform: 'x' },
    { channelId: 3, platform: 'linkedin' },
  ],
  status: 'draft',
});

게시물 예약

post = bp.posts.create(
    content="This will go out tomorrow morning.",
    channels=[{"channelId": 1, "platform": "instagram"}],
    status="scheduled",
    scheduled_at="2026-04-10T09:00:00Z",
    timezone="America/New_York",
)

미디어 업로드 및 게시

media = bp.media.upload("./product-photo.jpg")

post = bp.posts.create(
    content="Our newest product is here.",
    channels=[{"channelId": 1, "platform": "instagram"}],
    media_files=[media["file"]["id"]],
    status="scheduled",
    scheduled_at="2026-04-10T12:00:00Z",
)

자동화 예제: CSV에서 대량 예약

import csv
from bulkpublish import BulkPublish

bp = BulkPublish("bp_your_key_here")
channels = bp.channels.list()["channels"]

with open("content-calendar.csv") as f:
    for row in csv.DictReader(f):
        bp.posts.create(
            content=row["content"],
            channels=[{"channelId": ch["id"], "platform": ch["platform"]} for ch in channels],
            status="scheduled",
            scheduled_at=row["scheduled_at"],
            timezone="America/New_York",
        )

examples/에서 더 많은 예제를 확인하세요. Python 자동화 스크립트, Node.js 예제, curl 참조, AI 에이전트 통합 등이 포함되어 있습니다.

기능

• 11개 플랫폼 — Facebook, Instagram, X/Twitter, TikTok, YouTube, Threads, Bluesky, Pinterest, Google Business Profile, LinkedIn, Mastodon

• 예약 — 시간대 지원을 통해 미래의 모든 시간에 게시물을 예약하거나, 대기열 슬롯을 통해 최적의 시간을 선택하세요.

• 미디어 업로드 — 최대 100MB의 이미지(JPEG, PNG, WebP, GIF) 및 동영상(MP4, MOV, WebM)

• 반복 예약 — cron 표현식을 사용하여 매일, 매주, 격주 또는 매월 게시물을 반복합니다.

• 분석 — 모든 플랫폼에서 노출수, 좋아요, 댓글, 공유 및 참여도를 추적합니다.

• 웹훅 — 게시물이 게시되거나, 실패하거나, 예약될 때 알림을 받습니다.

• 라벨 — 색상 코드가 지정된 라벨로 게시물과 미디어를 정리합니다.

• 대량 작업 — 단일 요청으로 여러 게시물을 삭제하거나 재시도합니다.

• 스레드 — X, Threads, Bluesky 및 Mastodon을 위한 다중 게시물 스레드

• 자동 첫 댓글 — 모든 플랫폼에서 게시 후 자동으로 댓글을 추가합니다.

• 플랫폼별 콘텐츠 — 단일 게시물 내에서 플랫폼별로 텍스트와 옵션을 사용자 지정합니다.

• 플랫폼별 옵션 — Instagram 공동 작업자, TikTok 개인정보 보호, YouTube 카테고리, Pinterest 보드 등

API 참조

전체 대화형 API 문서: app.bulkpublish.com/docs

기본 URL

https://app.bulkpublish.com

인증

Authorization: Bearer bp_your_key_here

핵심 엔드포인트

전체 엔드포인트 목록은 OpenAPI 사양을 참조하세요.

지원되는 플랫폼

SDK

Python

pip install bulkpublish

동기 및 비동기 방식을 지원합니다. IDE 및 LLM 사용을 위해 모든 메서드에 풍부한 독스트링이 포함되어 있습니다.

Node.js / TypeScript

npm install bulkpublish

전체 TypeScript 타입, 제로 의존성, 네이티브 fetch(Node 18+)를 지원합니다.

REST API

SDK가 필요하지 않습니다. 모든 HTTP 클라이언트에서 작동합니다:

curl https://app.bulkpublish.com/api/channels \
  -H "Authorization: Bearer bp_your_key_here"

속도 제한

헤더, 백오프 전략 및 모범 사례는 속도 제한 가이드를 참조하세요.

가이드

• 인증 — API 키, 권한 부여, 키 관리

• 예약 — 예약된 게시물, 대기열 슬롯, 반복 예약, 시간대

• 미디어 업로드 — 파일 업로드, 지원되는 형식, 게시물에서 미디어 사용

• 플랫폼 옵션 — 플랫폼별 구성 및 특이 사항

• 웹훅 — 실시간 이벤트 알림, 페이로드, 서명 확인

• 속도 제한 — 버스트 제한, 일일 할당량, 모범 사례

링크

라이선스

MIT