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 Pinterest kan doen, en wat Pinterest 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 Pinterest 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 Pinterest-tools die Claude Code krijgt
list_pinterest_boards: de boards van het account, inclusief geheime boards, met hun id’s.create_pinterest_board: maakt een nieuw board aan.post_to_pinterest: maakt een afbeeldings- of video-Pin op een board dat je noemt, met een titel, een beschrijving, een bestemmingslink en alt-tekst.schedule_post: zet de Pin in de wachtrij, metboardId.list_pinterest_ads_campaigns / pinterest_ads_report: lezen de betaalde kant.
De beperking die je nodig hebt voordat je een Pinterest-workflow plant: deze app heeft Trial-toegang, en Pinterest weigert het aanmaken van Pins in productie op Trial. In hun eigen woorden, gevonden bij de eerste echte Pin: “Apps met Trial-toegang mogen geen Pins aanmaken in productie.” Boards en lezen werken wel op Trial (boards tonen, boards aanmaken, Pins lezen). De foutmelding van Hermoso noemt het toegangsniveau in plaats van je te vragen opnieuw te verbinden, want opnieuw verbinden kan dit niet oplossen. Een upgrade naar Standard-toegang ontgrendelt het aanmaken van Pins, en die is in beoordeling. Hetzelfde niveau beperkt de betaalde kant: op Trial toont Pinterest helemaal geen advertentieaccounts.
Pinterest-limieten om te weten voordat je iets automatiseert
| Tekst | Een Pin-beschrijving is beperkt tot 800 tekens en een Pin-titel tot 100. De limiet wordt afgedwongen bij het maken of in de wachtrij zetten, dus een te lange post wordt geweigerd terwijl je er nog bent om hem te repareren, in plaats van stilletjes ingekort te worden op weg naar buiten. |
|---|---|
| Zichtbaarheid | Openbaar, en de regeling is het board, niet de Pin. Een Pin neemt de openbare of geheime status van zijn board over. “Zet het ergens privé” wordt dus uitgedrukt door een geheim board te kiezen. Daarom is het board een verplicht argument en geen standaardwaarde. |
| Carrousel | 2 tot 5 afbeeldingen, alleen afbeeldingen. Beide grenzen komen rechtstreeks uit de v5 OpenAPI van Pinterest zelf (minItems: 2, maxItems: 5). Dat is de enige machineleesbare bron die Pinterest publiceert, want hun ontwikkelaarssite is een client-gerenderde app die niets teruggeeft aan een fetch. Er is geen bron voor meerdere video’s, dus een video-slide wordt geweigerd in plaats van stilletjes weggelaten. |
| Welk account | boardId, en het is het enige identiteitsveld dat bij het in de wachtrij zetten wordt geweigerd in plaats van bij het publiceren. Laat je het weg, dan wordt er niets ingepland, want “een Pin op het verkeerde board is een openbare fout, dus kiezen wij er nooit een voor je.” |
Probeer het in Claude Code
Vraag er in gewone taal om. Dit zijn gewone zinnen, geen DSL:
“Maak per productlijn een bord, genereer vijf verticale Pins voor elk met titels en beschrijvingen, en schrijf het hele plan klaar om te publiceren naar ./out/pinterest.json.”
Dat loopt via list_pinterest_boards → plan_ad → generate_image → post_to_pinterest. Claude Code vraagt toestemming voordat het een tool uitvoert, en het verloop staat in de terminal, dus een publicatiestap is een regel die je kunt lezen voordat je y indrukt.
Claude Code op Pinterest: het deel dat pijn doet
Een script dat alles klaarzet en net voor de Pin stopt, is op dit moment de juiste vorm. Borden lezen en schrijven werkt met Trial-toegang. Het maken van de Pin wordt in productie door Pinterest zelf geweigerd. Let er ook op dat boardId het enige identiteitsveld is dat Hermoso al bij het in de wachtrij zetten weigert, en niet pas bij het publiceren, omdat “een Pin op het verkeerde bord is een openbare fout, dus wij kiezen er nooit een voor je”.
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 Pinterest voordat je post
Er is geen Pinterest-advertentiebibliotheek, dus concurrentieonderzoek op Pinterest is iets wat Hermoso niet claimt. Het creatieve materiaal dat je daar zou draaien wordt goed gedekt door de rest van de studio: make_template_ad en de beeldmodellen maken de verticale, tekstrijke stills waar het kanaal op beloont.
Het betaalde deel
Er zijn Pinterest-advertentietools voor een campagne, een advertentiegroep en een advertentie die een bestaande Pin promoot. Ze archiveren in plaats van verwijderen, omdat de ADS API van Pinterest geen delete-werkwoord kent. Organische Pins en boards worden wel verwijderd, via delete_pinterest_pin en delete_pinterest_board; het zijn de betaalde objecten die alleen gearchiveerd kunnen worden. Maar hetzelfde Trial-niveau dat het aanmaken van Pins blokkeert, geeft geen advertentieaccounts vrij, dus advertentieschrijfacties zijn niet bruikbaar tot Standard-toegang er is. Dat is de eerlijke stand van zaken, en het is beter om dat hier in één zin te zeggen dan het op een deadline te ontdekken.
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 publiceren naar: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Bluesky · Telegram. Of bekijk alles waarnaar Claude Code kan publiceren.
Publiceren naar Pinterest 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 Pinterest 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 Pinterest 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 Pinterest 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 Pinterest in Hermoso onder Instellingen → Connectors. Dat is een OAuth-toestemmingsscherm in de browser. Daarna publiceert Claude Code naar Pinterest als een gewone toolaanroep.
Kan Claude Code een carrousel naar Pinterest posten?
In principe ja: 2 tot 5 afbeeldingen, alleen afbeeldingen, rechtstreeks uit de v5 OpenAPI van Pinterest zelf. In de praktijk is het aanmaken van een Pin zelf in productie geblokkeerd zolang deze app Trial-toegang heeft. Claude Code roept in beide gevallen dezelfde publicatietool aan, en een kanaal dat geen carrousel kan dragen wordt geweigerd, met de echte reden erbij.
Kan Claude Code een Pinterest-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. Pinterest is een van de elf kanalen die in de wachtrij gaan.
Heeft Claude Code mijn Pinterest-wachtwoord nodig?
Nee. Je koppelt Pinterest éé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 Pinterest vanuit Claude Code?
Pinterest rekent niets per API-aanroep, dus publiceren kost geen credits. Credits worden besteed aan het genereren van het Pin-creatief. Abonnementen kosten $29, $69 en $149 per maand voor 1.200, 3.000 en 7.000 credits, en elke functie zit op elk abonnement, ook op Free. 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