DEV Community: arti1984

Social-Media-Uploads ohne API: ein Uploader, der den Browser bedient

arti1984 — Fri, 06 Nov 2026 16:47:35 +0000

Jede Plattform möchte für automatische Uploads eine eigene API-App: Developer-Konto, Review, Scopes, Tokens, und bei TikTok zusätzlich eine Freigabe, die man als Einzelperson praktisch nicht bekommt. Ich wollte einfach nur ein Video auf YouTube, Facebook, Instagram und TikTok veröffentlichen. Also habe ich das Gegenteil gebaut: ein Tool, das gar keine API benutzt, sondern den Browser steuert.

Die Idee: der Browser ist die Schnittstelle

Statt mit einer API zu sprechen, öffnet das Tool die ganz normale Webseite, wählt die Datei aus, tippt Titel und Text ein und klickt auf „Posten". Es macht exakt das, was ich mit der Maus machen würde — nur reproduzierbar und per Kommandozeile.

Das klingt primitiv, hat aber einen handfesten Vorteil: Es funktioniert überall dort, wo es keine Upload-API gibt. Und es braucht keine Zugangsdaten im Klartext, weil es eine bereits angemeldete Sitzung weiterbenutzt.

Technisch steckt patchright bzw. Playwright darunter, also ein fernsteuerbarer Chromium oder Firefox. Die Sitzung liegt entweder als Cookie-Datei (cookies/….json) oder als persistentes Browserprofil (profiles/<browser>/<account>) auf der eigenen Platte.

Was zur Laufzeit passiert

Der Ablauf ist bewusst langweilig und deterministisch:

sau facebook upload-video --account creator --file video.mp4 --title "Titel"

Die CLI liest die Argumente und wählt Plattform, Browser und Sitzung.
Der Uploader öffnet die Startseite, wartet auf die Selektoren des Composers und legt die Datei in das input[type=file] — ohne Datei-Dialog, direkt über das DOM.
Titel, Beschreibung und Hashtags werden eingetippt.
Der Publish-Button wird über seine Beschriftung gesucht (mehrsprachig, weil die Oberfläche je nach Konto Deutsch, Englisch oder Chinesisch ist).
Danach schreibt der Lauf sein Ergebnis als JSON: Instagram übernimmt die Media-ID aus der finalen Antwort des Create-Endpunkts, Facebook wartet auf den exakten Erfolgs-Toast, und der Facebook-Pages-Ablauf öffnet die Liste der veröffentlichten Beiträge und sucht den Post über die Content-ID.

Kein Agent, kein LLM, keine Entscheidungen zur Laufzeit: ein Befehl, eine feste Abfolge von Klicks. Genau das macht Fehlersuche erträglich — wenn etwas bricht, ist es ein Selektor und keine Laune eines Modells.

Captions ohne KI-Dienst

Beschreibungen und Hashtags kann das Tool selbst vorschlagen (--auto-desc, --auto-tags, sau caption). Das ist absichtlich regelbasiert: Text aus Titel und Notizen, ein fester Call-to-Action pro Plattform, Hashtags aus den signifikanten Wörtern, alles gekürzt auf die Zeichenlimits der Plattform. Gleiche Eingabe, gleiche Ausgabe, kein Netzwerkaufruf, keine Kosten.

Für meinen Zweck reicht das. Wer wirklich kreative Texte will, hängt dort ein Modell dran — die Stelle ist klar abgegrenzt.

Loslegen

uv venv
source .venv/bin/activate        # Windows: .venv\Scripts\Activate.ps1
uv pip install -e .
patchright install chromium
cp conf.example.py conf.py
sau --help

Dann einmal anmelden — das Fenster geht sichtbar auf, Captcha und 2FA macht man selbst:

sau youtube login --account creator
sau youtube check --account creator
sau youtube upload-video --account creator --file videos/demo.mp4 --title "Titel" --visibility public

--account ist nur ein lokaler Alias für eine gespeicherte Sitzung. Für Facebook, Facebook Pages und Instagram gibt es dieselben drei Schritte (login, check, upload-video bzw. upload-note). TikTok hat keinen CLI-Befehl, sondern einen eigenen Python-Uploader, der auf Wunsch einen bereits laufenden Browser über CDP übernimmt.

Wo es weh tut

Ehrlich gehört das in einen solchen Artikel:

Selektoren brechen. Baut eine Plattform ihr Web-UI um, findet das Tool den Button nicht mehr. Dann wird gestoppt und angepasst, nicht geraten.
Die Nutzungsbedingungen. Cookie-Automatisierung ist bei den meisten Plattformen nicht vorgesehen. Risk-Control, Captchas und im schlimmsten Fall Sperren sind reale Risiken. Wer das produktiv einsetzt, sollte wissen, was er tut.
„Unklar" ist nicht „fehlgeschlagen". Die Ergebnisdatei wird mit submission_unknown geschrieben, bevor der Submit-Klick passiert — ein Absturz hinterlässt also einen Eintrag, und nichts wird automatisch erneut gesendet. Ein stummer Composer ist in beide Richtungen kein Beweis: sau instagram verify und sau facebook verify öffnen den Live-Post und prüfen ID, Autor und Caption — dieser Check ist verlässlicher als jeder Toast.
Planen ist Plattform-Sache. Facebook Pages terminieren über den Zeitplan-Dialog der Seite, Instagram und Facebook-Profile können gar nicht planen.

Fazit

Wer für ein paar eigene Konten regelmäßig postet und keine Lust auf vier API-Integrationen hat, kommt mit Browser-Automatisierung erstaunlich weit. Es ist kein Produkt für Kundenkonten, sondern ein Werkzeug für den eigenen Account — mit allen Ecken und Kanten, die dazugehören.

Code, Handbuch und alle Schalter: github.com/arti1984-collab/social-auto-upload-international (MIT).

Social media uploads without an API: an uploader that drives the browser

arti1984 — Fri, 06 Nov 2026 16:42:28 +0000

Every platform wants its own API app for automated uploads: a developer account, a review, scopes, tokens — and on TikTok an approval an individual practically never gets. I just wanted to publish one video to YouTube, Facebook, Instagram and TikTok. So I built the opposite: a tool that uses no API at all and drives the browser instead.

The idea: the browser is the interface

Instead of talking to an API, the tool opens the ordinary website, picks the file, types the title and the text and clicks "Post" — exactly what I would do with a mouse, just reproducible and from the command line.

That sounds primitive, but it has one solid advantage: it works wherever there is no upload API. And it needs no plaintext credentials, because it reuses a session that is already signed in.

Under the hood it is patchright and Playwright, so a remote-controlled Chromium or Firefox. The session lives either as a cookie file (cookies/….json) or as a persistent browser profile (profiles/<browser>/<account>) on your own disk.

What happens at runtime

The flow is intentionally boring and deterministic:

sau facebook upload-video --account creator --file video.mp4 --title "Title"

The CLI reads the arguments and picks the platform, the browser and the session.
The uploader opens the home page, waits for the composer selectors and attaches the file to the input[type=file] — no file dialog, straight through the DOM.
Title, description and hashtags are typed in.
The publish button is found by its label (in several languages, because the UI is German, English or Chinese depending on the account).
Afterwards the run writes its result as JSON: Instagram uses the media id from the final create response, Facebook waits for the exact success toast, and the Facebook Page flow opens the published list and looks the post up by content id.

No agent, no LLM, no decisions at runtime: one command, a fixed sequence of clicks. That is what makes debugging bearable — when something breaks, it is a selector, not the mood of a model.

Captions without an AI service

The tool can suggest descriptions and hashtags by itself (--auto-desc, --auto-tags, sau caption). That is deliberately rule-based: text from the title and the notes, one fixed call to action per platform, hashtags from the significant words, everything trimmed to the platform's character limits. Same input, same output, no network call, no cost.

That is enough for my use case. If you want genuinely creative copy, plug a model in there — the seam is clearly defined.

Getting started

uv venv
source .venv/bin/activate        # Windows: .venv\Scripts\Activate.ps1
uv pip install -e .
patchright install chromium
cp conf.example.py conf.py
sau --help

Then sign in once — the window opens visibly, and you solve captchas and 2FA yourself:

sau youtube login --account creator
sau youtube check --account creator
sau youtube upload-video --account creator --file videos/demo.mp4 --title "Title" --visibility public

--account is only a local alias for a stored session. Facebook, Facebook Pages and Instagram have the same three steps (login, check, upload-video or upload-note). TikTok has no CLI command but its own Python uploader, which can take over an already running browser over CDP.

Where it hurts

Honesty belongs in an article like this:

Selectors break. When a platform redesigns its web UI, the tool no longer finds the button. Then it stops and gets adjusted — it does not guess.
The terms of service. Cookie automation is not something most platforms provide for. Risk control, captchas and, in the worst case, bans are real risks. If you run this in production, you should know what you are doing.
"Unknown" is not "failed". The result file is written with submission_unknown before the submit click, so a crash leaves a record and nothing is re-sent automatically. A silent composer proves nothing either way: sau instagram verify and sau facebook verify reopen the live post and check id, author and caption — the check I trust more than any toast.
Scheduling is the platform's job. Facebook Pages schedule through the page's own scheduling dialog; Instagram and Facebook profiles cannot schedule at all.

Conclusion

For posting regularly to a handful of your own accounts without wiring up four API integrations, browser automation gets you surprisingly far. It is not a product for client accounts, it is a tool for your own account — with all the rough edges that come with it.

Code, handbook and every flag: github.com/arti1984-collab/social-auto-upload-international (MIT).