Hermoso is een marketing-MCP-server: 922+ tools via één OAuth-endpoint, waarmee een agent de advertenties kan onderzoeken die al in een markt draaien, afgewerkte beeld- en videoadvertenties kan genereren, ze kan publiceren en de betaalde campagnes erachter kan bouwen. Claude Code bereikt dat alles via één verbinding. Deze pagina behandelt één stuk daarvan: wat Claude Code echt op TikTok kan doen, en wat TikTok hem niet laat doen.
Hermoso verbinden met Claude Code
- Eén commando, en geen sleutel.
Al in een sessie? Typclaude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso/plugin marketplace add hermoso-ai/hermoso, daarna/plugin install hermoso@hermoso. Dat installeert vijf Hermoso-skills (research, ad-from-brand, generate, product-photoshoot en marketing) die hethermoso-commando draaien vianpx, dus er wordt geen toollijst in je sessies geladen en niets kost context zolang het niet draait. - Log één keer in.
Dat opent een browserinlog op loopback, zoalsnpx -y hermoso auth loginghdat doet, en slaat een alleen-voor-jou-leesbaar inloggegeven op in~/.hermoso/config.json. Claude Code draait dat voor je de eerste keer dat het Hermoso nodig heeft. Geen browser op die machine, bijvoorbeeld CI, een externe server of een container? Maak een sleutel aan onder MCP & CLI → Terminal & API-sleutels en voernpx -y hermoso auth login --token hmk_…uit. Een sleutel heeft echte uitgavenbevoegdheid, dus behandel hem als een wachtwoord. - Optioneel: de MCP-server erbij. Als je Hermoso’s tools ook in de eigen toollijst van Claude Code wilt hebben, voer dan na het inloggen
claude mcp add hermoso -- npx -y hermoso mcpuit. Die gebruikt hetzelfde opgeslagen inloggegeven, dus er komt geen sleutel in.claude.json. De skills bereiken elke tool zonder dit. - Vraag Claude Code om iets. “Haal de langstlopende advertenties van mijn drie dichtstbijzijnde concurrenten op en zet de beste hook om in een 9:16-video,” of “plaats deze render op het kanaal.” De agent kiest de tools; jij keurt de uitgaven goed.
De plugin en de optionele MCP-server bereiken dezelfde tools en hetzelfde account. Het verschil zit in de context: een toollijst wordt in elke sessie geladen voordat je iets typt, terwijl de skills niets kosten zolang er geen commando draait.
Koppel daarna TikTok zelf, één keer, onder Instellingen → Connectors in Hermoso. Dat is een OAuth-toestemmingsscherm, dus het is de ene stap die een browser nodig heeft. Alles daarna is een toolaanroep.
De TikTok-tools die Claude Code krijgt
post_to_tiktok: publiceert een afgewerkte video, of een fotopost van maximaal 35 afbeeldingen, live op het profiel met de privacy die je kiest, of in je TikTok-concepten om in de app af te maken. Ook de interactie-instellingen (reacties, duet, stitch), het omslagframe en de vermelding van branded content komen hiermee mee.schedule_post: zet hem voor later in de gedeelde kalender, met de privacy vastgelegd op het moment dat je hem in de wachtrij zet.tiktok_account / tiktok_creator_info: de bio van het account, verificatie, aantal volgers en video's, en de privacyniveaus die het account zelf toestaat.tiktok_post_status: volgt een post die TikTok nog verwerkt, zodat een trage upload wordt gecontroleerd in plaats van twee keer geplaatst.list_tiktok_videos / tiktok_account_insights: recente posts met weergaven, likes, reacties en shares, en de eigen analyses van het account, met volgersdemografie op een Business-account met 100 of meer volgers.list_tiktok_comments / reply_to_tiktok_comment / moderate_tiktok_comment: leest de reacties op je posts, antwoordt als het account, en geeft likes, verbergt of verwijdert, zodra de TikTok-accountautorisatie is verbonden.search_tiktok: zoeken op trefwoord door openbare TikTok, de onderzoekshelft.
Twee operationele feiten erbij. TikTok-fotoposts worden van een URL opgehaald in plaats van geüpload, dus de host die de afbeeldingen serveert moet in het ontwikkelaarsportaal van TikTok worden geverifieerd voordat fotoposts überhaupt kunnen uitgaan. En een concept heeft geen omslagframe: bij een directe post zet Hermoso het beste frame van de video als omslag, terwijl je bij een concept het omslag kiest in de TikTok-app.
TikTok-limieten om te weten voordat je iets automatiseert
| Tekst | Een TikTok-videocaption is beperkt tot 2.200 tekens, een fotopost-caption tot 4.000 en een fototitel tot 90. Die wordt afgedwongen bij het aanmaken of in de wachtrij zetten, dus een te lange post wordt geweigerd terwijl jij nog aanwezig bent om hem te repareren, in plaats van stilletjes ingekort te worden op weg naar buiten. |
|---|---|
| Zichtbaarheid | Iedereen, volgers, vrienden, alleen jij, of een concept, en jij kiest. Hermoso is in augustus 2026 door de Direct Post-audit van TikTok geslaagd, dus een post kan live op het profiel gaan. De regel van TikTok is dat de maker de privacy voor elke post kiest, zonder vooraf geselecteerde optie, en alleen uit de niveaus die tiktok_creator_info zegt dat het account toestaat. Hermoso vraagt daarom in plaats van standaard te kiezen, en weigert een post die geen niveau noemt voordat er iets wordt geüpload. Een concept gaat naar de TikTok-inbox om in de app af te maken, en daar voeg je ook een TikTok-geluid toe. Er is geen niet-vermeld niveau. Branded content kan niet worden gecombineerd met een privé- (alleen jij) post, en die combinatie wordt geweigerd in plaats van dat wij er een oplossing voor kiezen. |
| Carrousel | Tot 35 afbeeldingen als TikTok-fotopost, alleen afbeeldingen. Dat getal is van TikTok: “Een array met tot 35 foto-content-URL's.” De volgorde is de diavoorstelling, dus de dia-volgorde is het product. Eén afbeelding is gewoon een post met één dia, geen weigering. |
| Welk account | Geen. TikTok publiceert naar het verbonden account. |
Probeer het in Claude Code
Vraag er in gewone taal om. Dit zijn gewone zinnen, geen DSL:
“Render drie variaties van de hook, publiceer de sterkste openbaar, upload de andere twee als TikTok-concepten, en print de publicatie-id’s.”
Dat loopt via search_tiktok → plan_ad → render_ad → post_to_tiktok. Claude Code vraagt toestemming voordat het een tool draait, en het transcript staat gewoon in de terminal, dus een publicatiestap is een regel die je kunt lezen voordat je y indrukt.
Claude Code op TikTok: het deel dat pijn doet
Zet de privacy in het commando, elke keer. TikTok staat geen standaardwaarde toe, dus een stap die hem weglaat wordt geweigerd voordat er iets geüpload wordt, wat de juiste fout is voor een onbewaakte run. Een publicatie die nog verwerkt wordt, komt terug als in behandeling; gebruik tiktok_post_status met het publicatie-id om de status op te vragen, in plaats van opnieuw te proberen, want een nieuwe poging is een tweede post.
De plugin bevat geen tool-manifest, wat het zwaarst weegt bij een lange onbewaakte run: de agent roept per stap het hermoso-commando aan, en --json bij elk commando geeft machine-uitvoer om op te controleren.
Onderzoek TikTok voordat je post
Hermoso heeft geen TikTok-advertentiebibliotheekzoekfunctie zoals op Meta, dus TikTok-onderzoek is organisch: search_tiktok vindt wat werkt op trefwoord, en analyze_video haalt een clip uiteen in zijn hook, beats en tekst in beeld, zodat het patroon kan worden hergebruikt in plaats van geraden.
Het betaalde deel
TikTok Ads is een van de twaalf betaalde platforms waarop Hermoso campagnes bouwt en leest, inclusief Smart+-campagnes en Spark Ads die een organische post promoten, en het is een aparte verbinding van de organische. Campagnes lopen via de Marketing API van TikTok en publiceren via de contentpublicatie-goedkeuring van TikTok, dus Hermoso rapporteert elk apart in plaats van dat het ene het andere impliceert. Alleen een statusschakelaar met bevestiging zet echt geld in beweging.
Wat Claude Code niet zelfstandig kan
Een agent met een budget is alleen nuttig als de impact begrensd is, dus het hek zit in de server en niet in een prompt. Elke advertentiecampagne, adset, advertentiegroep en advertentie wordt gepauzeerd aangemaakt, en de statusschakelaars die echt geld in beweging zetten, weigeren te draaien zonder een uitdrukkelijke bevestigingsvlag. Elke render wordt vooraf geprijsd (hermoso_capabilities publiceert de exacte creditkosten van elk model voordat er iets wordt uitgegeven). Credits worden gereserveerd vóór de eerste aanroep naar de provider en daarna afgerekend op de exacte kosten, zodat een mislukte verzending wordt terugbetaald in plaats van dat je voor niets betaalt. Verwijderingen zijn ook bevestigingsbeveiligd, en elke campagnestructuur wordt teruggelezen uit het advertentieplatform voordat je agent vertelt wat hij heeft gebouwd.
Eén stap is bewust niet headless: een account koppelen is een OAuth-toestemmingsscherm, dus je koppelt het kanaal één keer in een browser. Alles daarna is een toolaanroep.
De rest van de matrix
Vanuit Claude Code posten naar: Facebook · Instagram · Threads · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. Of bekijk alles waarnaar Claude Code kan publiceren.
Posten naar TikTok vanuit: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code-marketing
Veelgestelde vragen
Kan Claude Code naar TikTok posten?
Ja, met de Claude Code-plugin van Hermoso. Eén commando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, of binnen een sessie /plugin marketplace add hermoso-ai/hermoso en daarna /plugin install hermoso@hermoso. Dat installeert vijf Hermoso-skills die het hermoso-commando aansturen, dus er wordt geen toollijst in je sessies geladen. Log één keer in met npx -y hermoso auth login. Dat opent een browser en slaat het inloggegeven zelf op, dus je hoeft geen sleutel te maken of te plakken. Daarna heeft Claude Code 922+ tools, inclusief de tools die naar TikTok publiceren, plus de tools die de advertenties onderzoeken die al in jouw markt draaien en het creatieve materiaal in de eerste plaats renderen.
Hoe koppel ik TikTok aan Claude Code?
Twee stappen, elk één keer. Eén commando: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, of binnen een sessie /plugin marketplace add hermoso-ai/hermoso en daarna /plugin install hermoso@hermoso. Dat installeert vijf Hermoso-skills die het hermoso-commando aansturen, dus er wordt geen toollijst in je sessies geladen. Log één keer in met npx -y hermoso auth login. Dat opent een browser en slaat het inloggegeven zelf op, dus je hoeft geen sleutel te maken of te plakken. Verbind daarna TikTok in Hermoso onder Instellingen → Connectors. Dat is een OAuth-toestemmingsscherm in de browser. Daarna publiceert Claude Code naar TikTok als een gewone toolaanroep.
Kan Claude Code een carrousel naar TikTok posten?
Ja. Een TikTok-fotopost neemt tot 35 afbeeldingen aan, in de volgorde waarin je ze meegeeft, en die volgorde is de diavoorstelling. Video kan er niet bij worden gemengd. Claude Code roept in beide gevallen dezelfde publicatietool aan, en een kanaal dat geen carrousel aankan, wordt geweigerd met de echte reden erbij.
Kan Claude Code een TikTok-post voor later inplannen?
Ja. schedule_post zet hem in één kalender die met elk ander kanaal wordt gedeeld, met een caption per kanaal als de tekst moet verschillen, en list_scheduled en cancel_scheduled lezen hem uit en halen hem terug. TikTok is een van de elf kanalen die in de wachtrij gaan.
Heeft Claude Code mijn TikTok-wachtwoord nodig?
Nee. Je koppelt TikTok één keer aan Hermoso via een OAuth-toestemmingsscherm in een browser, en Claude Code bereikt het daarna als toolaanroep. Een account koppelen is de ene stap die niet headless is; niets erna heeft een wachtwoord nodig, en het model krijgt nooit inloggegevens.
Wat kost posten naar TikTok vanuit Claude Code?
Publiceren naar TikTok kost geen credits; TikTok rekent niets per API-aanroep. Credits gaan op de render. Abonnementen kosten $29, $69 en $149 per maand voor 1.200, 3.000 en 7.000 credits, en elke functie zit in elk abonnement, ook op Gratis. De enige uitzondering is enterprise-SSO.
Begin gratis met 30 credits bij aanmelding en verdien er 250+ bij. Elke functie zit in elk abonnement.
Gratis starten → Bekijk prijzen