Posten naar Instagram vanuit Claude Code

Met één plugin-installatie kan Claude Code renderen, captionen en publiceren naar Instagram, vanuit dezelfde terminalsessie waarin het creatieve materiaal is gemaakt.

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 Instagram kan doen, en wat Instagram hem niet laat doen.

Hermoso verbinden met Claude Code

  1. Eén commando, en geen sleutel.
    claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso
    Al in een sessie? Typ /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 het hermoso-commando draaien via npx, dus er wordt geen toollijst in je sessies geladen en niets kost context zolang het niet draait.
  2. Log één keer in.
    npx -y hermoso auth login
    Dat opent een browserinlog op loopback, zoals gh dat 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 voer npx -y hermoso auth login --token hmk_… uit. Een sleutel heeft echte uitgavenbevoegdheid, dus behandel hem als een wachtwoord.
  3. 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 mcp uit. Die gebruikt hetzelfde opgeslagen inloggegeven, dus er komt geen sleutel in .claude.json. De skills bereiken elke tool zonder dit.
  4. 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 Instagram 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 Instagram-tools die Claude Code krijgt

  • post_to_meta: publiceert naar Instagram met target: "instagram". Instagram is een visueel kanaal en de API is het daarmee eens: een post heeft een afbeelding of een video nodig.
  • schedule_post: zet hem in de gedeelde kalender, met een caption per kanaal als de tekst moet afwijken van je Facebook- of LinkedIn-versie.
  • list_meta_comments / reply_to_meta_comment / moderate_meta_comment: lezen, antwoorden en modereren onder een post.
  • meta_page_insights / meta_post_insights: bereik, vertoningen, opslaan en betrokkenheid, per account en per post.
  • search_instagram: zoekt op trefwoord door openbare Instagram Reels, voor onderzoek en niet voor publicatie.

Twee Instagram-feiten om te weten voordat je iets automatiseert. In de API van Meta is er geen native Instagram-inplanning, dus een planning is de wachtrij van Hermoso en niet die van Instagram, en het doorgeven van Facebooks scheduleAt voor Instagram wordt geweigerd in plaats van stilletjes nu te posten. En een Instagram-caption kan niet worden bewerkt zodra de post live is: het enige wat Meta op een gepubliceerde post laat wijzigen, is of reacties aanstaan. Verwijderen kan wel: manage_meta_post verwijdert gewone posts, Stories, Reels en hele carrouselalbums, maar nooit één kaart uit een album.

Instagram-limieten om te weten voordat je iets automatiseert

TekstEen Instagram-caption is beperkt tot 2.200 tekens. 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.
ZichtbaarheidAlleen openbaar. De Content Publishing API van Meta publiceert direct of helemaal niet, en Instagram “heeft geen niet-vermelde, privé- of conceptpost.” Wil je een controlestap op Instagram, dan moet die vóór de aanroep gebeuren, niet erna.
Carrousel2 tot 10 dia's, en afbeeldingen en video mogen worden gemengd. Die bovengrens is van Meta zelf, geciteerd uit de capaciteitstabel die het afdwingt: “Carrousels zijn beperkt tot 10 afbeeldingen, video's of een mix van beide.” De ondergrens van 2 is van ons, want één dia is op geen enkel platform een carrousel. Een verzoek voor één dia wordt gepubliceerd als gewone post in plaats van geweigerd.
Welk accountpageId. Instagram publiceert via de verbonden Facebook-pagina, dus hetzelfde identiteitsveld kiest hem.

Probeer het in Claude Code

Vraag er in gewone taal om. Dit zijn gewone zinnen, geen DSL:

“Maak een carrousel van 5 slides uit ./assets/slides, controleer of elke slide onder de limieten van Instagram valt, publiceer hem en sla de permalink op in de releasenotes.”

Dat loopt via search_instagram → plan_ad → render_ad → post_to_meta (target: "instagram"). 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 Instagram: het deel dat pijn doet

Een Instagram-caption kan niet meer worden bewerkt zodra de post live is, dus bouw de controle in het script in plaats van in het excuus: laat Claude Code de volgorde van de slides en de caption tonen, en roep pas daarna de publicatietool aan. Als een render verkeerd blijkt, verwijdert manage_meta_post de hele post, inclusief albums. De volgorde is belangrijker dan mensen verwachten. Slide 2 moet op slide 1 volgen, en Hermoso houdt de volgorde die je meegeeft precies aan.

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 Instagram voordat je post

search_meta_ads dekt Instagram-plaatsingen net zo goed als Facebook, omdat het één bibliotheek is. Voor organisch werk zoekt search_instagram openbare Reels op trefwoord, het oppervlak waar het formaat echt beweegt; profiel- en hashtag-pulls lopen via fetch_social_data en search_instagram_hashtag.

Het betaalde deel

Instagram-plaatsingen worden gekocht via dezelfde Meta-campagnestructuur als Facebook: create_meta_campaign → create_meta_adset → create_meta_ad, met plaatsingen die per platform en positie te kiezen zijn. preview_meta_ad toont de echte gerenderde advertentie per plaatsing voordat je uitgeeft, en meta_insights splitst de resultaten uit naar leeftijd, geslacht, plaatsing en land. Die uitsplitsing bepaalt het volgende creatief.

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 · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. Of bekijk alles waarnaar Claude Code kan publiceren.

Posten naar Instagram 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 Instagram 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 Instagram 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 Instagram 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 Instagram in Hermoso onder Instellingen → Connectors. Dat is een OAuth-toestemmingsscherm in de browser. Daarna publiceert Claude Code naar Instagram als een gewone toolaanroep.

Heeft Claude Code mijn Instagram-wachtwoord nodig?

Nee. Je koppelt Instagram éé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.

Kan Claude Code een Instagram-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. Instagram is een van de elf kanalen die in de wachtrij gaan.

Kan Claude Code een carrousel naar Instagram posten?

Ja, 2 tot 10 dia's, en afbeeldingen en video mogen worden gemengd. Tien is de eigen gepubliceerde limiet van Meta, niet een die Hermoso heeft verzonnen. Claude Code roept in beide gevallen dezelfde publicatietool aan, en een kanaal dat geen carrousel aankan, wordt geweigerd met de echte reden erbij.

Wat kost posten naar Instagram vanuit Claude Code?

Publiceren naar Instagram kost geen credits; Meta rekent niets per API-aanroep. Credits gaan op de render zelf. 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