tiktok-publish-flow
Post/publish TikTok videos and photos with TikTok music, edit captions, delete posts via Playwright on TikTok Studio web — no official API, no paid services. Use for TikTok automation, scheduled posting crons, photo posts with sound, caption edits.
TikTok publish flow — postare automată pe TikTok Studio via Playwright
Corpul skill-ului e în română (limba de lucru a agentului care l-a construit); pașii, comenzile și selectorii sunt universali.
Fluxul VERIFICAT end-to-end (24.09 seara): 3 video + 1 foto-cu-muzică + 1 editare descriere, toate reușite, 0 credite. Sesiunea TikTok persistă în profilul Chromium ``TIKTOK_PROFILE_DIR(default~/.tiktok-poster/profile) — o dată logat (QR scanat din app), toate fluxurile rulează singure, fără re-login.
Cine postează: pentru automatizare (cron), un subagent dedicat face tot pipeline-ul inclusiv postarea (regula owner-ului: cronul postează prin subagent; sesiunea principală nu atinge TikTok decât la cerere explicită). Înainte de orice postare: verifică lista de pe /tiktokstudio/content — owner-ul poate posta manual în paralel (s-a întâmplat în producție); fără duplicate.
Scripturi (în scripts/, toate headed, profil persistent, portabile: TIKTOK_PROFILE_DIR / TIKTOK_SHOTS_DIR suprascriu căile default ~/.tiktok-poster/):
1. Video — scripts/tiktok_post3.py
python3 <skill-dir>/scripts/tiktok_post3.py \
--video <cale.mp4> --caption '<citat + emoji + #CitatulZilei #citate #motivatie #mindset #inspiratie #fyp>' --tag <tag-scurt>
Flux: /tiktokstudio/upload → input[type=file] → caption (contenteditable) → Escape + click neutral (închide popup) → privacy „Toată lumea"/Everyone → Post.
- ⭐ Dialogul „Continue to post?" („We're still checking your video...") apare după click pe Post. Trebuie click „Post now" imediat (în 1–2s de la apariție) — lăsat nesupravegheat se închide singur FĂRĂ să posteze (2 eșecuri consecutive înainte de fix). Scriptul poll-ează și apasă singur.
- Succes = redirect la
/tiktokstudio/content+ postarea apare după reload. Postările video primesc dialogul; cele foto de obicei nu.
2. Foto cu piesă TikTok — scripts/tiktok_photo_music.py
python3 .../tiktok_photo_music.py --image <cale.png> --caption '<citat + taguri>' --query '<mood EN pentru căutarea piesei>' --tag <tag-scurt>
- ⭐ Tab-ul „Photos" se clickă ÎNAINTE de upload — input-ul default are
accept=video/*și ignoră silențios PNG-urile: FILE_SET apare în log, dar editorul de caption nu mai vine niciodată (diagnosticat în producție). - Sunet: click pe butonul real
button:has-text("Add sound")— click pe text cuforce=TrueNU deschide panoul. Căsuța de căutare se ia DOAR din modal ([role=dialog] input,input[placeholder*=earch]) — primulinput[type=text]de pe pagină e câmpul Description (titlu): query-ul scris acolo poluează titlul postării. - Alegere piesă: click pe sugestia potrivită (ex. „golden hour jvke" → piesa JVKE), apoi click JS pe primul buton „Use" vizibil (
offsetParent !== null; preferă rândul cu cuvântul-cheie din query). Click-ul Playwright normal dă timeout — 20 butoane „Use" găsite, toate cu TimeoutError, dropdown-ul de sugestii le acoperă;.click()prin evaluate merge. - Dacă piesa nu se poate selecta → ABORT, nu posta fără muzică.
3. Editare descriere postare existentă — scripts/tiktok_edit_post.py
python3 <skill-dir>/scripts/tiktok_edit_post.py --match '<fragment caption curent>' --caption '<text nou complet>' --guard '<fragment din caption-ul curent pt. gard>'
- Găsește rândul pe
/contentdupă un fragment din caption (JS: text node → walk-up la strămoșul cu ≥4 svg și text scurt; sortează candidații dupătextContent.lengthcrescător — strămoșul comun al mai multor rânduri e mai lung și altfel câștigă sortarea greșit). - Creionul de editare = primul
span.px-iconcu x > 65% din lățimea viewport-ului (coloana Actions; px-icon-urile din stânga rândului sunt badge-uri de thumbnail). Click prinpage.mouse.click(x, y)la coordonate —.click()JS pe wrapper nu navighează. - Se deschide
/tiktokstudio/upload/post/photo?item_id=<post_id>&from=creator_center(URL direct navigabil odată cunoscut item_id). - ⭐ Gard anti-greșeală: citește textul curent al editorului înainte de tastare; dacă NU conține caption-ul postării țintă → ABORT fără nicio modificare (a oprit editări pe rândul greșit în teste).
- Save cu butonul „Save" → status „Under review", postarea rămâne live în timpul re-verificării — normal, nu o reposta.
Capcane verificate
- Rândurile din Content au doar 2
<button>reale (privacy + 1) — pictogramele Actions suntspan.px-iconfără data-e2e/aria-label. Nu căuta butoane de acțiune în rând. - Privacy dropdown-ul (Everyone/Friends/Only me) se deschide ușor din greșeală la click-uri în zonaActions — nimic nu se schimbă până nu alegi o opțiune; dă Escape.
- QCode QR de login: se capturează și se trimite pe WhatsApp, expiră în ~2–3 min („A expirat" → rulare nouă). Google OAuth e blocat în Chromium Playwright („browser not secure") — login TikTok doar prin QR din app, nu Google.
- Editarea postărilor video funcționează la fel ca foto (același creion); URL-ul de editare diferă doar prin item_id.
Drum blocat: conectorul Higgsfield (nu reîncerca fără motiv)
Publicarea prin conector (tiktok_prepare_publish + publish-form widget) nu a mers niciodată end-to-end la Alex ): widget-ul „Approve TikTok post" rămâne cu Continue disabled + „Preview unavailable", aplicația Higgsfield nu afișează sesiunile de publish, sesiunea expiră în ~2h. Hosting-ul pentru conector (catbox.moe → media_import_url → URL cloudfront; presigned PUT pică cu InvalidToken) și scripturile CDP (scripts/hf_*.py în skill) rămân utile doar dacă TikTok/Higgsfield repară widget-ul. Regula consimțământului: conectorul cere confirmarea în publish-form; fluxul Playwright rulează sub autorizarea owner-ului contului.
- Downloads
- Security audit
- Review
- Last updated
- 1mo ago
- Current version
- v1.0.0
- License
- MIT-0
