Communitygithub.com

azeemkafridi/bulkpublish-api

Die beste kostenlose API für Social-Media-Veröffentlichungen und -Planung. SDKs für Python & Node, MCP-Server für KI-Agenten, 11 Plattformen.

Was ist bulkpublish-api?

BulkPublish API ist eine headless Social-Media-API, die speziell für Automatisierung, KI-Agenten und LLMs entwickelt wurde. Mit einem einzigen API-Aufruf können Sie Beiträge auf 15 Plattformen wie Facebook, Instagram, X/Twitter, TikTok, YouTube, LinkedIn und vielen mehr veröffentlichen. Die API bietet SDKs für Python und Node.js, einen MCP-Server für nahtlose Integration in Claude, Cursor und Windsurf, sowie vorgefertigte Tool-Definitionen für GPT und LangChain. Zu den Kernfunktionen gehören Terminplanung mit Zeitzonenunterstützung, Medien-Uploads bis zu 100 MB, wiederkehrende Zeitpläne, detaillierte Analysen, Link-Tracking und Bulk-Operationen. Der Dienst ist für Entwickler und KI-Agenten konzipiert, die zuverlässige Social-Media-Automatisierung ohne Browser-Sitzungen oder manuelle Interaktion benötigen. Mit einem kostenlosen Konto können Sie API-Schlüssel erstellen, Kanäle verbinden und sofort mit der Automatisierung Ihrer Social-Media-Präsenz beginnen.

Funktioniert mit✓Claude Code✓Codex CLI✓Cursor✓Antigravity✓Windsurf
npx skills add https://github.com/azeemkafridi/bulkpublish-api/tree/main

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Vorschau

Aus dem Skill-README

bulkpublish-api preview
bulkpublish-api preview
bulkpublish-api preview
bulkpublish-api preview
bulkpublish-api preview
bulkpublish-api preview
bulkpublish-api preview
bulkpublish-api preview

Dokumentation

Programmatisch auf 15 Plattformen mit einem einzigen API-Aufruf veröffentlichen. Entwickelt für Entwickler, KI-Agenten, LLMs und agentische Workflows, die zuverlässige Social-Media-Automatisierung ohne Browser-Sitzungen oder manuelle Interaktion benötigen.

from bulkpublish import BulkPublish

bp = BulkPublish("bp_your_key_here")
bp.posts.create(
    content="Wir stellen heute unser neues Produkt vor!",
    channels=[{"channelId": 1, "platform": "x"}, {"channelId": 2, "platform": "linkedin"}],
    status="scheduled",
    scheduled_at="2026-04-10T09:00:00Z",
)

Warum BulkPublish?

Die meisten Social-Media-Tools sind für Menschen gebaut, die auf Schaltflächen klicken. BulkPublish ist für Code gebaut – ob dieser Code von einem Entwickler, einem KI-Agenten, einem LLM mit Tool-Nutzung oder einem autonomen Workflow geschrieben wurde.

  • Headless by design — Kein Browser, keine Benutzeroberfläche, keine OAuth-Pop-ups zur Laufzeit. Verbinden Sie Konten einmal im Dashboard und automatisieren Sie dann alles über die API.
  • KI-nativ — MCP-Server für Claude, Tool-Definitionen für GPT und LangChain, strukturierte JSON-Antworten, die LLMs zuverlässig parsen.
  • Agentisch bereit — Deterministische API mit klaren Fehlercodes. KI-Agenten können Beiträge erstellen, Status prüfen, Fehler wiederholen und Analysen autonom lesen.
  • 15 Plattformen, ein Endpunkt — Facebook, Instagram, X/Twitter, TikTok, YouTube, Threads, Bluesky, Pinterest, Google Business Profile, LinkedIn, Mastodon, Discord, Telegram, Tumblr, Snapchat.

Anwendungsfälle

  • KI-Social-Media-Manager — Lassen Sie Claude, GPT oder benutzerdefinierte Agenten Beiträge autonom planen und veröffentlichen
  • Content-Pipelines — RSS-zu-Social, Blog-zu-Social, Newsletter-zu-Social-Automatisierung
  • Massenplanung — Laden Sie eine CSV hoch oder füttern Sie einen Content-Kalender und planen Sie Wochen von Beiträgen programmatisch
  • Plattformübergreifende Syndizierung — Einmal veröffentlichen auf allen Plattformen mit plattformspezifischer Optimierung
  • Analyse-Dashboards — Ziehen Sie Engagement-Daten in Ihre eigenen Tools, Tabellenkalkulationen oder KI-Analysen
  • Zapier/n8n/Make-Alternativen — Direkter API-Zugriff ohne Middleware, geringere Latenz, mehr Kontrolle
  • LLM-gestützte Content-Erstellung — Erstellen Sie Inhalte mit KI, veröffentlichen Sie sie mit BulkPublish, verfolgen Sie die Leistung, iterieren Sie

Schnellstart

1. Registrieren

Erstellen Sie ein kostenloses Konto unter app.bulkpublish.com.

2. API-Schlüssel abrufen

Gehen Sie im Dashboard zu Einstellungen > Entwickler und erstellen Sie einen API-Schlüssel. Schlüssel beginnen mit bp_ und werden nur einmal angezeigt – bewahren Sie ihn sicher auf.

3. Plattformen verbinden

Verbinden Sie Ihre Social-Media-Konten im Dashboard unter Kanäle. Die API verwendet Ihre verbundenen Kanäle zum Veröffentlichen.

4. SDK installieren

Python

pip install bulkpublish

Node.js

npm install bulkpublish

Homebrew (macOS/Linux)

brew tap azeemkafridi/bulkpublish && brew install bulkpublish

Oder rufen Sie die REST-API direkt mit curl, fetch, requests oder einem beliebigen HTTP-Client auf.

5. Ersten API-Aufruf tätigen

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

KI-Agenten-Integration

MCP-Server (Claude, Cursor, Windsurf, Claude Code)

BulkPublish liefert einen MCP-Server mit, damit KI-Assistenten Ihre Social-Media-Konten direkt verwalten können:

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

50 Werkzeuge verfügbar: create_post, list_channels, upload_media, get_analytics, der interaktive compose_post-Komponist (MCP Apps) und mehr. Läuft lokal (stdio) oder gehostet über Streamable HTTP unter https://mcp.bulkpublish.com/mcp. Siehe mcp-server/README.md.

Social-Media-Content-Fähigkeiten

BulkPublish enthält eine Bibliothek mit 24 Fähigkeiten für KI-Agenten, um Social-Media-Inhalte zu planen, anzupassen, zu überprüfen, zu planen und zu veröffentlichen: Social Media Content Skills.

LLM-Tool-Nutzung / Function Calling

Gebrauchsfertige Tool-Definitionen für autonome KI-Agenten:

Alle Beispiele sind vollständige, ausführbare Skripte mit Fehlerbehandlung.

Code-Beispiele

Einen Beitrag erstellen

from bulkpublish import BulkPublish

bp = BulkPublish("bp_your_key_here")

post = bp.posts.create(
    content="Sehen Sie sich unser neuestes Update an!",
    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: 'Sehen Sie sich unser neuestes Update an!',
  channels: [
    { channelId: 1, platform: 'facebook' },
    { channelId: 2, platform: 'x' },
    { channelId: 3, platform: 'linkedin' },
  ],
  status: 'draft',
});

Einen Beitrag planen

post = bp.posts.create(
    content="Dieser Beitrag wird morgen früh rausgehen.",
    channels=[{"channelId": 1, "platform": "instagram"}],
    status="scheduled",
    scheduled_at="2026-04-10T09:00:00Z",
    timezone="America/New_York",
)

Medien hochladen und veröffentlichen

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

post = bp.posts.create(
    content="Unser neuestes Produkt ist da.",
    channels=[{"channelId": 1, "platform": "instagram"}],
    media_files=[media["file"]["id"]],
    status="scheduled",
    scheduled_at="2026-04-10T12:00:00Z",
)

Automatisierungsbeispiel: Massenplanung aus 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",
        )

Weitere Beispiele in examples/ — darunter Python-Automatisierungsskripte, Node.js-Beispiele, curl-Referenz und KI-Agenten-Integrationen.

Funktionen

  • 15 Plattformen — Facebook, Instagram, X/Twitter, TikTok, YouTube, Threads, Bluesky, Pinterest, Google Business Profile, LinkedIn, Mastodon, Discord, Telegram, Tumblr, Snapchat
  • Planung — Planen Sie Beiträge für jeden zukünftigen Zeitpunkt mit Zeitzonenunterstützung, oder lassen Sie Warteschlangenplätze optimale Zeiten wählen
  • Medien-Uploads — Bilder (JPEG, PNG, WebP, GIF) und Videos (MP4, MOV, WebM) bis zu 100 MB
  • Wiederkehrende Zeitpläne — Wiederholen Sie Beiträge täglich, wöchentlich, zweiwöchentlich oder monatlich zu einer festgelegten Tageszeit
  • Analysen — Verfolgen Sie Impressionen, Likes, Kommentare, geteilte Inhalte und Engagement. Jede Plattform meldet eine andere Teilmenge von Metriken, und die Antwort gibt an, welche (supportedMetrics / supportedTotals), sodass eine 0 nie mit einer Messung verwechselt wird – siehe Metriken nach Plattform
  • Link-Tracking — Optional pro Organisation oder pro Beitrag über linkTrackingOverride, um Links durch bulkpubli.sh umzuleiten und die Klicks zu zählen. Gemeldet als linkClicks / totalLinkClicks und von BulkPublish gemessen, nicht von der Plattform, sodass es auch funktioniert, wenn die Plattform nichts meldet – siehe Zeichenlimits
  • Labels — Organisieren Sie Beiträge und Medien mit farbcodierten Labels
  • Bulk-Operationen — Löschen oder wiederholen Sie mehrere Beiträge in einer einzigen Anfrage
  • Threads — Mehrteilige Thread-Beiträge für X, Threads, Bluesky und Mastodon
  • Automatischer erster Kommentar — Fügen Sie nach der Veröffentlichung auf jeder Plattform automatisch einen Kommentar hinzu
  • Alle Beitragstypen — Reels, Stories, Karussells, Threads, Shorts, Video — pro Plattform über postTypeOverrides einstellbar
  • Plattformspezifischer Inhalt — Passen Sie Text und Optionen pro Plattform in einem einzigen Beitrag an
  • Plattformspezifische Optionen — Instagram-Mitarbeiter, TikTok-Datenschutz, YouTube-Kategorien, Pinterest-Boards und mehr

API-Referenz

Vollständige interaktive API-Dokumentation: app.bulkpublish.com/docs

Basis-URL

https://app.bulkpublish.com

Authentifizierung

Authorization: Bearer bp_your_key_here

Kern-Endpunkte

MethodeEndpunktBeschreibung
POST/api/postsEinen Beitrag erstellen (Entwurf, geplant oder sofort)
GET/api/postsBeiträge auflisten (paginiert, filterbar nach Status/Datum/Kanal/Label)
GET/api/posts/:idEinen Beitrag mit Plattformstatus und Metriken abrufen
PUT/api/posts/:idEinen Entwurf oder geplanten Beitrag aktualisieren
DELETE/api/posts/:idEinen Beitrag löschen
POST/api/posts/:id/publishEinen Entwurf sofort veröffentlichen
POST/api/posts/:id/retryFehlgeschlagene Plattformen wiederholen
POST/api/posts/:id/approveEinen Beitrag genehmigen, der auf Team-Genehmigung wartet (Rollen mit post:approve)
POST/api/posts/:id/rejectEinen ausstehenden Beitrag mit optionalem Grund zurück in den Entwurfsstatus versetzen
POST/api/posts/bulkMassenlöschen oder -wiederholen
GET/api/channelsVerbundene Social-Media-Kanäle auflisten
GET/api/channels/:id/healthKanal-Token-Integrität prüfen
GET/api/channels/:id/optionsPlattformoptionen abrufen (Pinterest-Boards, YouTube-Playlists)
GET/api/channels/:id/mentionsBenutzer für @-Erwähnungen durchsuchen (X, Bluesky)
GET/POST/api/channel-setsGespeicherte Kanalgruppen für One-Click-Targeting (Update/Delete über /api/channel-sets/:id)
GET/POST/api/rss-feedsRSS/Atom-Autopost-Feeds – neue Elemente werden zu Beiträgen (Update/Delete über /api/rss-feeds/:id)
POST/api/mediaEine Mediendatei hochladen (Multipart-Formular, bis zu 100 MB)
POST/api/media/multipart/createEinen chunked Upload für große Medien starten (Videos bis zu 1 GB, 10 MB Teile)
POST/api/media/multipart/completeHochgeladene Teile zusammenfügen und die Mediendatei aufzeichnen
GET/api/mediaHochgeladene Medien auflisten
GET/api/analytics/summaryAnalysezusammenfassung für einen Datumsbereich
GET/api/analytics/engagementEngagement-Daten, gruppiert nach Tag/Woche/Monat
POST/api/schedulesEinen wiederkehrenden Zeitplan erstellen
GET/api/quotas/usageAktuelle Planlimits und Nutzung prüfen

Siehe die OpenAPI-Spezifikation für die vollständige Liste der Endpunkte.

Unterstützte Plattformen

PlattformBeitragstypenMedien
FacebookBeitrag, StoryBilder, Videos
InstagramFeed, Reel, Story, KarussellBilder (JPEG), Videos (MP4, MOV)
X / TwitterTweet, ThreadBilder, Videos, GIFs
TikTokVideo, Foto-DiashowVideos (MP4, MOV), Bilder
YouTubeVideo, ShortVideos (MP4, MOV, WebM, AVI, WMV, FLV)
ThreadsBeitrag, Thread, Zitat-BeitragBilder, Videos
BlueskyBeitrag, ThreadBilder

[... für die Übersetzung abgeschnitten ...]

Verwandte Skills