Communitygithub.com

publora/tiktok-post

Verwenden Sie dies, wenn der Benutzer ein TikTok-Video über Publora hochladen oder planen möchte, mit Einstellungen für Privatsphäre, Kommentare, Duett, Stitch und kommerzielle Offenlegung. Das Video läuft 3 Sekunden bis 10 Minuten bei 23+ FPS; Karussells akzeptieren bis zu 35 Bilder. Nicht geprüfte Apps können nur private Videos veröffentlichen. Nicht für Reels (verwenden Sie instagram-post).

Was ist tiktok-post?

Diese Fähigkeit ermöglicht es KI-Agenten, Videos über den Publora MCP-Server auf TikTok hochzuladen und zu planen. Sie bietet umfassende Kontrolle über die Sichtbarkeit des Beitrags (öffentlich, nur Follower, nur gegenseitige Freunde, privat), Interaktionseinstellungen (Kommentare, Duette, Stitch) und die Kennzeichnung kommerzieller Inhalte (Markenpartnerschaften, gesponserte Beiträge). Unterstützt wird Claude Code (über MCP), Claude Desktop, Cursor, Codex und andere MCP-fähige Clients. Die Einrichtung erfordert ein kostenloses Publora-Konto, die Verbindung des TikTok-Kontos über OAuth und das Einrichten eines API-Keys. Die Fähigkeit stellt mehrere Tools zur Verfügung: `create_post` für die einstufige Veröffentlichung von Beiträgen (mit optionaler Planung und Medien-URLs), `get_upload_url` und `complete_media` für das zweistufige Hochladen großer Dateien sowie `list_connections` zum Abrufen von Plattform-IDs. Wichtige Einschränkungen sind, dass TikTok eine ungenehmigte App auf private Beiträge beschränkt (nur `SELF_ONLY`), dass Medien erforderlich sind (Video oder Bildkarussell, kein reiner Text), und dass eine Mindestbildrate von 23 FPS eingehalten werden muss. Die Tabelle der Plattformlimits zeigt Abweichungen zur nativen App, z. B. maximal 10 Minuten Videolänge (API) gegenüber 60 Minuten (App) und 2.200 Zeichen Bildunterschrift gegenüber 4.000 Zeichen. Bei Fehlern wird empfohlen, auf die REST-API auszuweichen, die unter `api.publora.com/v1` mit dem Header `x-publora-key` verfügbar ist.

Funktioniert mit✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/publora/skills/tree/main/skills/tiktok-post
Original anzeigen→Alle Skills durchsuchen

In Ihrer bevorzugten KI fragen

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

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Dokumentation

Was macht tiktok-post?

Laden Sie Videos mit dem Publora MCP-Server auf TikTok hoch und planen Sie sie. Unterstützt Privatsphäre-Einstellungen, Interaktionsoptionen (Kommentare, Duett, Stitch) und die Kennzeichnung kommerzieller Inhalte.

Voraussetzungen

Tarife: Funktioniert mit dem kostenlosen Starter-Plan. Aktuelle Limits und Preise: publora.com/pricing

Erste Schritte

  1. Konto erstellen unter publora.com/register (kostenlos)
  2. TikTok verbinden via OAuth im Publora Dashboard
  3. API-Key abrufen unter app.publora.com/dashboard/api
  4. Verbinden Sie Ihren Agenten mit dem MCP-Server unter https://mcp.publora.com, authentifiziert mit Authorization: Bearer sk_YOUR_API_KEY. In Claude Code:
claude mcp add publora --transport http https://mcp.publora.com \
  --header "Authorization: Bearer sk_YOUR_API_KEY"

Claude Desktop, Cursor, Codex, OpenClaw und der claude.ai-Connector benötigen jeweils eine andere Konfigurationsdatei oder einen anderen Ablauf: siehe Client-Einrichtung für den genauen Pfad und Codeausschnitt.

REST-API-Fallback

Falls der MCP-Server nicht verfügbar ist oder Fehler zurückgibt, verwenden Sie direkt die REST-API:

Basis-URL: https://api.publora.com/api/v1

Authentifizierung: Verwenden Sie den Header x-publora-key (NICHT Authorization: Bearer):

# Ihre verbundenen Plattformen abrufen
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_your_api_key"

# Einen Beitrag erstellen
curl -X POST "https://api.publora.com/api/v1/create-post" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["tiktok-99887766"],
    "content": "Videobeschreibung hier #hashtag",
    "scheduledTime": "2026-03-25T10:00:00Z",
    "platformSettings": {
      "tiktok": {
        "viewerSetting": "PUBLIC_TO_EVERYONE",
        "allowComments": true
      }
    }
  }'

Plattform-ID-Format: tiktok-{id}, wobei {id} aus der Antwort von /platform-connections stammt.

Beispiel-IDs: tiktok-99887766, tiktok-123456789

📖 Vollständige API-Dokumentation: docs.publora.com

Plattformlimits (API vs. native App)

Kritische API-Limits, die sich von der nativen TikTok-App unterscheiden:

Videoanforderungen

SpezifikationAPI-LimitNative App
Max. Dauer10 Minuten60 Minuten
Min. Dauer3 Sekunden3 Sekunden
Max. Dateigröße4 GB4 GB
Min. Bildrate23 FPS23 FPS
FormateMP4, MOV, WebMMP4, MOV, WebM

Bildunterschriftenlimits

ElementAPI-LimitNative App
Länge der Bildunterschrift2.200 Zeichen4.000 Zeichen
HashtagsIn der Zeichenanzahl enthaltenIn der Zeichenanzahl enthalten

Ratenlimits

LimitWert
Beiträge pro Tag15–20
Videos pro Minutemax. 2

Verfügbare Tools

create_post

Erstellen Sie einen neuen TikTok-Beitrag.

Parameter:

  • platforms: Array mit Ihrer TikTok-Verbindungs-ID (z. B. ["tiktok-99887766"])
  • content: Videobeschreibung (bis zu 2.200 Zeichen)
  • scheduledTime: ISO 8601 UTC-Datumszeit. Optional: Wenn weggelassen, wird der Beitrag als Entwurf erstellt. Senden Sie eine zukünftige Zeit, um ihn zu planen. Eine Zeit, die fünf oder mehr Minuten in der Vergangenheit liegt, wird mit SCHEDULED_TIME_IN_PAST abgelehnt. Für eine sofortige Veröffentlichung verwenden Sie die aktuelle Zeit plus eine Minute.
  • mediaUrls: bis zu 10 öffentliche https-Bild- oder Video-URLs. Publora lädt sie serverseitig herunter und fügt sie vor der Validierung hinzu, sodass Medien und Planung in einem Aufruf erfolgen. Dies ist die einmalige Alternative zum Ablauf „Entwurf, dann get_upload_url, dann complete_media“. Der Import ist auf 60 URLs pro Stunde beschränkt.

get_upload_url

Ruft eine vorab signierte URL für den Video-Upload ab.

Parameter:

  • postGroupId: Post-ID, an die das Video angehängt werden soll
  • fileName: Name der Videodatei (z. B. "video.mp4")
  • contentType: video/mp4, video/quicktime oder video/webm
  • type: "video"

complete_media

Schließt eine Datei ab, die über get_upload_url hochgeladen wurde, nachdem der vorab signierte PUT erfolgreich war. Optional, da die Planung ebenfalls ausstehende Medien abschließt, aber ein frühzeitiger Aufruf zeigt Format- und Probenfehler vor der Veröffentlichung an. Nicht erforderlich für Medien, die mit mediaUrls angehängt wurden.

Parameter:

  • mediaId: die von get_upload_url zurückgegebene ID

list_connections

Listet Ihre verbundenen Konten mit ihren Plattform-IDs auf. Rufen Sie dies zuerst auf und kopieren Sie die IDs wörtlich; sie sind niemals erratbar.

list_posts / get_post / update_post / delete_post

Verwalten Sie geplante Beiträge und Entwürfe. update_post ändert auch content und platforms in einem Entwurf oder geplanten Beitrag, sodass das Beheben eines Tippfehlers oder die Neuausrichtung nicht mehr Löschen und Neuerstellen bedeutet. delete_media und prune_media_reference bereinigen hochgeladene Dateien.

Plattformeinstellungen (über REST-API)

TikTok verfügt über 7 plattformspezifische Einstellungen, die über platformSettings gesteuert werden:

{
  "platformSettings": {
    "tiktok": {
      "viewerSetting": "PUBLIC_TO_EVERYONE",
      "allowComments": true,
      "allowDuet": false,
      "allowStitch": false,
      "commercialContent": false,
      "brandOrganic": false,
      "brandedContent": false
    }
  }
}

Zuschauereinstellungen (Erforderlich)

WertBeschreibung
PUBLIC_TO_EVERYONEJeder kann ansehen (Standard)
MUTUAL_FOLLOW_FRIENDSNur gegenseitige Freunde
FOLLOWER_OF_CREATORNur Ihre Follower
SELF_ONLYNur Sie (entwurfsähnlich)

Interaktionseinstellungen

EinstellungStandardBeschreibung
allowCommentstrueOb Zuschauer kommentieren können
allowDuetfalseOb Zuschauer Duette erstellen können
allowStitchfalseOb Zuschauer Stitch verwenden können

Einstellungen für kommerzielle Inhalte

EinstellungStandardBeschreibung
commercialContentfalseHandelt es sich um kommerzielle Inhalte?
brandOrganicfalseOrganische Markenwerbung
brandedContentfalseBezahlte Partnerschaft/Sponsoring

Hinweis: Wenn commercialContent auf true gesetzt ist, muss mindestens eines von brandOrganic oder brandedContent ebenfalls true sein.

Hinweis: platformSettings wird sowohl vom MCP create_post- und update_post-Tool als auch über REST akzeptiert. Das Schema ist streng: Eine falsch geschriebene Plattform oder ein falscher Schlüssel wird mit einem Validierungsfehler abgelehnt, nicht stillschweigend ignoriert.

Kritische Einschränkungen

1. Nicht geprüfte Apps = NUR PRIVAT

KRITISCH: Wenn Ihre TikTok-App den Prüfprozess von TikTok nicht bestanden hat, können Sie NUR PRIVATE Videos posten (SELF_ONLY). Alle anderen viewerSetting-Werte werden auf SELF_ONLY überschrieben.

Um öffentliche Videos zu posten, muss Ihre App von TikTok geprüft werden.

2. Medien erforderlich, Video oder Bildkarussell

TikTok unterstützt KEINE reinen Textbeiträge: Jeder Beitrag benötigt Medien.

Es akzeptiert jedoch Bildkarussells: bis zu 35 Bilder, JPEG, PNG oder WebP, je 20 MB. Ein Beitrag ist entweder ein Karussell oder ein einzelnes Video, niemals beides.

3. Mindestens 23 FPS

Videos mit weniger als 23 Bildern pro Sekunde werden von TikTok abgelehnt.

Beispiele

Einfacher Videobeitrag

Poste dieses Video auf TikTok:
"Wie wir unser Startup in 60 Sekunden aufgebaut haben #startup #tech #coding"

Privater Entwurf (Testen)

Lade dieses Video als privaten Entwurf auf TikTok hoch (nur ich kann es sehen):
"Teste neues Content-Format"

Verwenden Sie viewerSetting: "SELF_ONLY" zum Testen, bevor Sie es öffentlich machen.

Markeninhalt

Poste dieses gesponserte Video auf TikTok mit ordnungsgemäßer Offenlegung:
"Ich liebe dieses neue Produkt von @brand! #ad #sponsored"

Setzen Sie commercialContent: true und brandedContent: true für bezahlte Partnerschaften.

Geplanter Beitrag

Plane dieses TikTok-Video für morgen um 18:00 Uhr:
"Wochenend-Vibes kommen! #weekend #fun"

Unterstützte Videoformate

FormatEmpfohlenHinweise
MP4JaZuverlässigstes Format
MOVJaApple-Format
WebMJaWeb-Format
AVIVon Publora akzeptiertKann von TikTok abgelehnt werden
MKVVon Publora akzeptiertKann von TikTok abgelehnt werden

Empfehlung: Verwenden Sie MP4 für beste Kompatibilität.

Best Practices

Inhalt

  1. Hook in den ersten 3 Sekunden: Aufmerksamkeit sofort erregen
  2. Optimale Länge: 15–60 Sekunden für beste Interaktion
  3. Trending Sounds: Verwenden Sie nach Möglichkeit trendige Audiodateien
  4. Hashtag-Strategie: 3–5 relevante Hashtags

Technisch

  1. Vertikales Video: Seitenverhältnis 9:16 funktioniert am besten
  2. Hohe Qualität: Mindestens 720p Auflösung
  3. 23+ FPS: Sorgen Sie für flüssige Wiedergabe
  4. MP4-Format: Zuverlässigstes Format

Timing

  • Beste Zeiten: 7–9 Uhr, 12–15 Uhr, 19–23 Uhr in der Zielzeitzone
  • Häufigkeit: 1–3 Beiträge pro Tag für Wachstum
  • Konsistenz: Regelmäßiger Veröffentlichungsplan hilft dem Algorithmus

Fehlerbehebung

FehlerUrsacheLösung
unaudited_client_can_only_post_to_private_accountsApp nicht genehmigtApp zur TikTok-Prüfung einreichen oder SELF_ONLY verwenden
spam_risk_too_many_postsTageslimit erreicht24 Stunden warten
duration_check_failedVideo zu lang/kurzStellen Sie sicher, dass es 3 Sekunden bis 10 Minuten lang ist
file_format_check_failedFalsches VideoformatVerwenden Sie MP4, MOV oder WebM
"23 FPS erforderlich"Niedrige BildrateVideo mit 23+ FPS neu codieren
"TikTok erfordert die Auswahl, wer ansehen kann"Fehlende viewerSettingFügen Sie immer viewerSetting in platformSettings ein

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

publora/bluesky-post

Use when the user wants to post or schedule to Bluesky through Publora. Handles the 300-character cap, auto-detected hashtags and links, up to 4 images, and videos. Alt text cannot be set through the API. Needs a Bluesky app password, never the main password. Not for Mastodon (use social-post).

publora/instagram-post

Use when the user wants to post or schedule to Instagram through Publora: a single image, a 2-10 image carousel, a Reel or a Story. Requires a Business account and an image or video; text-only posts are rejected by the API. Not for Threads (use threads-post).

publora/linkedin-analytics

Analyze LinkedIn performance and manage engagement through Publora. Use when the user asks how a LinkedIn post or account performed (impressions, reach, reactions, comments, reshares, follower growth) or wants to react, comment, reshare or resolve an @mention. Statistics run over the REST API, engagement over MCP tools. Not for creating posts (use linkedin-post).

publora/linkedin-post

Use when the user wants to publish or schedule a LinkedIn post through Publora: text, a multi-image grid, a video, a PDF document, or @mentions. Not for analytics, reactions, comments or reshares (use linkedin-analytics), and not for other platforms.

publora/social-post

Use when the user wants to post or schedule to YouTube, a Facebook Page or Mastodon through Publora. YouTube needs a video on every post, Facebook publishes to Pages only, Mastodon caps at 500 characters. Not for the platforms that have their own skill.

publora/telegram-post

Use when the user wants to post or schedule to a Telegram channel or group through Publora, using a bot. Covers Telegram markdown, silent delivery, link previews and forward protection. Bot API caps media captions at 1,024 characters and videos at 50 MB. Not for other platforms (each has its own skill).

publora/threads-post

Create and schedule Threads posts with image carousels and reply control via Publora MCP. Use when the user wants to post to Meta's Threads. Multi-part threading is currently disabled by the platform, so long content stays a single post. Not for Instagram (use instagram-post) or X threads (use x-post).

publora/x-post

Use when the user wants to post or schedule to X (Twitter) through Publora, including threads auto-split past 280 characters, up to 4 images, or a video up to 140 seconds. X needs a paid Publora plan. Not for Threads or Bluesky (each has its own skill).

Verwandte Skills

steipete/video-frames

Extract frames or short clips from videos using ffmpeg.

community

steipete/summarize

Summarize or transcribe URLs, YouTube/videos, podcasts, articles, transcripts, PDFs, and local files.

community

openclaw/openclaw

Use when testing, fixing, or extending the OpenClaw Control UI GUI with Vitest + Playwright end-to-end checks, mocked Gateway WebSocket flows, mocked dashboard runs, screenshots/videos, or agent-verifiable browser proof.

community

obra/superpowers

Obra superpowers agent skills.

community

affaan-m/ECC

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio...

community

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

community