GITHUB REPO

Instagram an Claude anschließen.

Zwei Dinge, die zusammengehören: das Repo instagram-agent-skill bringt Claude dreizehn Skills bei, mit denen er Hooks, Captions und Carousels baut, und braucht dafür keinen einzigen Schlüssel. Die neun Schritte darunter legen die Leitung zur Instagram-API, damit Claude danach mit deinen echten Reel-Zahlen und Kommentaren arbeitet statt mit Bauchgefühl.

  • Claude Code
  • GitHub
  • Fortgeschritten
Repo öffnen Zu den 9 Schritten

QUICK FACTS

Das Wichtigste auf einen Blick.

Repo
Jakeschincariol / instagram-agent-skill
Lizenz
MIT, Open Source
Umfang
13 Skills, 5 Python-Werkzeuge, 3 Datensätze
Zugangsdaten
keine fürs Repo, Creator-Konto plus Meta-Entwicklerkonto für die Verbindung
Dauer
Repo 2 Minuten, Verbindung rund 30 Minuten

EINORDNUNG

Warum ich das geteilt habe.

  • Warum beides auf eine Seite gehört.

    Die beiden Hälften lösen unterschiedliche Probleme, und genau deshalb funktionieren sie zusammen. Das Repo ist das Handwerk: Claude weiß danach, wie ein Hook gebaut ist, wie lang eine Caption sein darf, bevor Instagram sie abschneidet, und welche 154 Wörter sofort nach KI klingen. Was es nicht hat, sind deine Zahlen. Die neun Schritte legen die Leitung dorthin: Sie geben Claude Lesezugriff auf dein eigenes Konto, also Views, Reichweite und Kommentare deiner letzten Reels. Erst zusammen wird daraus eine ehrliche Antwort auf die Frage, warum ein Reel bei dir lief und das nächste nicht. Wichtig zu wissen, bevor du anfängst: Das Repo verlangt die Verbindung nicht. Du kannst heute mit den Skills starten und die neun Schritte erst gehen, wenn dir die Zahlen fehlen.

FEATURES

Was es kann.

Dreizehn Befehle statt einem Prompt-Chaos.

Jede Aufgabe hat ihren eigenen Befehl, und jeder bringt sein eigenes Regelwerk mit. Du tippst den Befehl, Claude weiß sofort, worauf es bei genau dieser Textsorte ankommt, statt dass du die Anforderungen jedes Mal neu erklärst.

  • /ig-reel baut Hooks aus 26 Formeln und gibt jedem eine Punktzahl
  • /ig-caption schreibt die Caption und zeigt, wo Instagram bei 125 Zeichen abschneidet
  • /ig-carousel, /ig-story und /ig-repurpose für Swipe-Posts, Story-Folgen und Zweitverwertung
  • /ig-comment, /ig-reply und /ig-dm für alles, was nach dem Posten kommt

Ein Prüfer, der 154 KI-Wörter kennt.

/ig-human räumt den Entwurf auf, bevor er nach Maschine klingt: unsichtbare Sonderzeichen raus, Typografie gerade ziehen, und 154 verbrannte Wörter gegen Ersatzvorschläge tauschen. Dazu kommen 34 strukturelle Muster, an denen man KI-Text auch ohne Vokabeltest erkennt. /ig-detect gibt dem Ergebnis danach eine Punktzahl aus fünf Prüfungen.

Fünf Werkzeuge, die wirklich rechnen.

Der Unterschied zu einem reinen Prompt-Paket: Fünf kleine Python-Programme laufen mit, wenn du Claude Code nutzt. hookscore.py bewertet Hooks gegen fünf Eigenschaften, beats.py baut das Timing des Skripts, caption.py prüft die Caption, humanize.py und detect.py übernehmen die Entschärfung. Kein API-Aufruf nach draußen, alles rechnet auf deinem Rechner.

Deine Stimme als Datei, nicht als Ansage.

Einmal legst du eine voice.md an, und ab da gilt sie für jeden der dreizehn Befehle. Wer nicht bei null anfangen will, schickt Claude drei eigene Reels und lässt die Datei daraus schreiben. Das ist der Schritt, den die meisten überspringen, und genau der entscheidet, ob die Entwürfe nach dir klingen oder nach dem Durchschnitt des Internets.

ARCHITEKTUR

So funktioniert es.

  1. Dein Instagram-KontoCreator oder Business, privat geht nicht
  2. Meta-Entwicklerportaleigene App vom Typ Business, du selbst als Tester
  3. 60-Tage-Schlüsselaus dem Ein-Stunden-Token eingetauscht
  4. Claude liest die ZahlenViews, Reichweite, Kommentare deiner Reels
  5. Die 13 Skills schreibenHook, Caption, Carousel, Antworten
  6. Du postestbewusst von Hand, das Repo postet nichts

Die Kette hat absichtlich eine Lücke am Ende. Das Repo nutzt die Content-Publishing-API von Instagram nicht, steuert keinen Browser fern und meldet sich nirgends für dich an. Es schreibt, du veröffentlichst. Die API-Verbindung aus den neun Schritten ist dabei die Leserichtung: Sie bringt deine Zahlen zu Claude, nicht Claudes Texte zu Instagram.

USE CASES

Wofür du es einsetzt.

  1. Der Montag, an dem die Woche steht

    /ig-plan legt die Woche an, /ig-reel liefert zu jedem Thema mehrere Hooks mit Punktzahl, und du entscheidest. Mit angeschlossener API kommt der ehrliche Teil dazu: Claude sieht, welche deiner letzten Reels wirklich liefen, und schlägt die Themen danach vor statt nach Gefühl.

  2. Das Reel, das fast fertig ist

    Der Schnitt steht, die Caption fehlt. /ig-caption schreibt sie und zeigt gleich, was im Feed nach 125 Zeichen abgeschnitten wird, also wo die Pointe auf keinen Fall stehen darf. /ig-human geht danach einmal drüber, damit nichts nach Textgenerator klingt.

  3. Die Nische, die du noch nicht kennst

    /ig-viral geht zehn Konten deiner Nische durch und sortiert deren Posts danach, um welchen Faktor sie über dem eigenen Schnitt lagen. Das läuft bewusst im Schritttempo über deinen normalen Browser, ohne Anmeldung, ohne Scraper. Langsamer als ein Tool, dafür ohne Konto-Risiko.

  4. Die Auswertung nach 48 Stunden

    Hier zahlt sich die Verbindung aus. /ig-audit schaut sich einen Post nach dem Laufen an, und mit Zugriff auf die echten Zahlen redet ihr über Views, Reichweite und Kommentare statt über Vermutungen. Der nächste Hook entsteht dann aus dem, was gemessen wurde.

INSTALLATION

Einmal einrichten, dann läuft es.

instagram-skill-install.txt 
https://github.com/Jakeschincariol/instagram-agent-skill

Installiere mir diese Skills und bestätige danach, dass /ig-reel funktioniert.
Lege mir anschließend die Datei ~/.claude/instagram/voice.md aus der Vorlage
in templates/voice.md an und sag mir, welche Felder ich noch ausfüllen muss.

DIE VERBINDUNG

In neun Schritten an deine echten Zahlen.

Einmal eingerichtet, läuft die Verbindung dauerhaft. Claude greift danach auf deine Reel-Zahlen und Kommentare zu. Jeder Schritt einzeln, mit dem genauen Klickpfad und der Plattform, auf der er passiert. Drei Dinge vorab: Ein privates Konto funktioniert nicht, es braucht Creator oder Business. Der 60-Tage-Schlüssel läuft nach 60 Tagen ab, und bleibt er die ganze Zeit ungenutzt, ist er endgültig verloren. Und Schlüssel wie App-Geheimnis behandelst du wie ein Passwort, also niemals einfach weitergeben.

  1. INSTAGRAM APPHandy → Einstellungen → Kontotyp und Tools

    Aus deinem Konto ein Creator-Profil machen

    Öffne in der App deine Einstellungen, tippe auf Kontotyp und Tools und aktiviere ein professionelles Konto vom Typ Creator. Kostenlos und jederzeit rückgängig zu machen, aber ohne diesen Schritt läuft keiner der folgenden.

  2. ENTWICKLERPORTALdevelopers.facebook.com

    Zugang zum Entwicklerportal holen

    Ruf developers.facebook.com auf und melde dich mit deinem Facebook-Konto an. Meta stellt dir dabei ein paar kurze Rückfragen, die sind in etwa einer Minute erledigt.

  3. ENTWICKLERPORTALMeine Apps → App erstellen

    Eigene App anlegen

    Klicke oben rechts auf Meine Apps, dann auf App erstellen. Der Name ist egal, entscheidend ist nur der Typ: Wähle Business, sonst taucht Instagram im nächsten Schritt gar nicht auf.

  4. ENTWICKLERPORTALDashboard deiner App → Instagram → Einrichten

    Instagram in die App einbinden

    Im Dashboard deiner neuen App findest du die Kachel Instagram. Klick auf Einrichten, danach erscheint links im Menü ein eigener Punkt namens Instagram.

  5. ENTWICKLERPORTALApp roles → Roles → Add People

    Dich selbst als Tester hinterlegen

    Öffne links App roles, dann Roles, und klicke auf Add People. Wähle die Rolle Instagram Tester und trag deinen Instagram-Namen ein. Dein Konto zeigt danach den Status Pending, das ist der erwartete Zwischenstand und keine Fehlermeldung.

  6. INSTAGRAM WEBinstagram.com → Profil bearbeiten → Apps und Websites

    Einladung drüben in Instagram bestätigen

    Wechsle am Rechner auf instagram.com und melde dich an. Geh zu Profil bearbeiten, dann Apps und Websites, und nimm dort unter Tester-Einladungen die Einladung an. Erst danach wechselt der Status im Entwicklerportal von Pending auf Active.

  7. ENTWICKLERPORTALInstagram → API setup with Instagram business login → Generate token

    Deinen ersten Zugangsschlüssel holen

    Zurück im Entwicklerportal klickst du links auf Instagram, dann auf API setup with Instagram business login, und meldest dich mit deinem Instagram-Konto an. Über Generate token erzeugst du den Schlüssel und bestätigst die angeforderten Berechtigungen. Kopiere ihn augenblicklich: Er wird nur einmal angezeigt und hält nur eine Stunde. Behandle ihn wie ein Passwort.

  8. ENTWICKLERPORTAL + BEFEHLApp settings → Basic → App secret → Show

    Schlüssel gegen die 60-Tage-Version eintauschen

    Klick links auf App settings, dann Basic, und öffne beim Feld App secret die Ansicht über Show. Trag das Geheimnis zusammen mit deinem Schlüssel aus Schritt 7 in den Befehl ein und führ ihn aus. Am schnellsten lässt du Claude das für dich übernehmen.

    60-tage-schluessel.sh 
    curl -s "https://graph.instagram.com/access_token\
?grant_type=ig_exchange_token\
&client_secret=DEIN_APP_GEHEIMNIS\
&access_token=DEIN_SCHLUESSEL_AUS_SCHRITT_7"

  9. TERMINAL ODER CLAUDEletzter Schritt

    Verbindung testen und Ablauf einplanen

    Setz deinen frischen 60-Tage-Schlüssel in den Testbefehl ein, die Antwort sollte deinen Kontonamen enthalten. Danach kannst du den Schlüssel bei Claude hinterlegen und loslegen. Setz dir jetzt gleich eine Erinnerung für Tag 55: Bleibt der Schlüssel 60 Tage komplett ungenutzt, verfällt er endgültig. Der Befehl mit ig_refresh_token verlängert ihn erneut um 60 Tage.

    verbindung-testen.sh 
    curl -s "https://graph.instagram.com/v21.0/me\
?fields=id,username,account_type,media_count\
&access_token=DEIN_60_TAGE_SCHLUESSEL"

# Tag 55, verlaengert um weitere 60 Tage:
curl -s "https://graph.instagram.com/refresh_access_token\
?grant_type=ig_refresh_token\
&access_token=DEIN_60_TAGE_SCHLUESSEL"

MEINE EINSCHÄTZUNG

Wofür sich der Aufwand lohnt.

Gut geeignet für

  • Alle, die regelmäßig posten und beim Schreiben Struktur wollen statt eines leeren Prompts
  • Entwürfe, die nicht nach KI klingen sollen: Die 154 Wörter und 34 Muster sind die ehrlichste Liste, die ich dazu gesehen habe
  • Captions, bei denen der Schnitt nach 125 Zeichen im Feed wirklich sitzt
  • Alle, die ihre eigenen Zahlen auswerten wollen, ohne ein Analyse-Abo abzuschließen

Weniger geeignet für

  • Automatisches Posten: Das Repo veröffentlicht bewusst nichts, es schreibt und du postest von Hand
  • Private Konten, die kein Creator- oder Business-Profil werden sollen: Die Verbindung ist dann nicht möglich
  • Alle, die den Hook-Bewerter für ein Orakel halten: Er erkennt schwache Hooks gut, trifft aber zwischen zwei guten kaum eine Aussage
  • Wer einmal einrichten und nie wieder hinschauen will: Der Schlüssel will alle 60 Tage verlängert werden
Repo einrichtenrund 2 Minuten
API-Verbindungrund 30 Minuten
Laufende Kostenkeine, beides ist kostenlos

Erst die Skills, dann die Zahlen.

Das Repo ist in zwei Minuten installiert und braucht keinen Schlüssel. Fang damit an, schreib eine Woche lang damit, und geh die neun Schritte erst, wenn dir beim Auswerten die echten Zahlen fehlen. In der Reihenfolge merkst du am schnellsten, ob beides für dich taugt.

Repo öffnen Zu den 9 Schritten

Mehr Tipps auf @till.schae

FAQ

Häufige Fragen.

Brauche ich die API-Verbindung, damit das Repo funktioniert?
Nein. Die dreizehn Skills laufen komplett ohne Zugangsdaten, ohne Anmeldung und ohne einen einzigen Aufruf nach draußen. Die neun Schritte brauchst du erst, wenn Claude mit deinen echten Reel-Zahlen und Kommentaren arbeiten soll statt mit dem, was du ihm erzählst.
Postet das Repo für mich?
Nein, und das ist eine bewusste Entscheidung des Entwicklers. Die Content-Publishing-API wird nicht genutzt, ein Browser wird nicht ferngesteuert, und es wird nichts gescrapt. Es schreibt, du postest. Wer automatisches Posten sucht, ist hier falsch.
Warum funktioniert mein privates Konto nicht?
Meta gibt den API-Zugang nur für professionelle Konten frei, also Creator oder Business. Die Umstellung ist kostenlos, dauert in der App keine Minute und lässt sich jederzeit rückgängig machen. Ohne sie bricht schon Schritt 3 ab, weil Instagram im Entwicklerportal gar nicht angeboten wird.
Was passiert nach 60 Tagen?
Der Schlüssel läuft ab. Solange du ihn zwischendurch benutzt, verlängerst du ihn mit dem Befehl aus Schritt 9 um weitere 60 Tage. Bleibt er die kompletten 60 Tage ungenutzt, ist er endgültig verloren und du gehst die Schritte 7 und 8 noch einmal. Deshalb steht die Erinnerung für Tag 55 wirklich im Kalender und nicht nur im Kopf.
Wie gut ist der Hook-Bewerter wirklich?
Ehrlicher, als man es sonst liest, weil der Entwickler es gemessen hat: geprüft an 74 echten Shorts-Hooks. Schwache Hooks erkennt er zuverlässig, bei zwei guten Hooks desselben Creators liegt er dagegen kaum über dem Zufall. Nutz ihn also zum Aussortieren, nicht zum Küren des Gewinners.
Ist mein Zugangsschlüssel bei Claude sicher?
Behandle ihn wie ein Passwort, denn genau das ist er. Er gehört nicht in einen Chat, den du teilst, nicht in ein Repository und nicht in einen Screenshot. Wenn du ihn versehentlich doch irgendwo hast stehen lassen, erzeugst du im Entwicklerportal einfach einen neuen, dann ist der alte wertlos.

MEHR

Weitere Repos.

GITHUB REPO Dein KI-Agent bekommt Augen GitHub GITHUB REPO Dein Agent hört auf zu schwafeln GitHub Video-Skill Claude + Remotion Claude

Weiterlesen

Alle Anleitungen zu Coding und Agenten an einem Ort, von Skills über Connectors bis zu den Repos.

Coding & Agenten