Dein Instagram.
In Claude Code.

Zuerst in Claude Code

Ein Prompt, dann Schritt für Schritt.

Kopier den Prompt in Claude Code auf deinem Rechner. Claude installiert das Lesepaket, prüft es vorher und begleitet dich durch die Einrichtung. Anmelden bei Meta und den Token eingeben machst du selbst, der Token landet nie im Chat.

Richte mir in meinem lokalen Claude Code einen Lesezugriff auf mein eigenes professionelles Instagram-Konto ein. Leitfaden sind die neun Schritte unter https://lbmedia.net/newsletter/instagram-claude-code. Nutze die Instagram API with Instagram Login, nicht den Weg über Facebook Login.

1. Installation: Prüfe, ob Python 3.9 oder neuer vorhanden ist und ob unter ~/.claude/skills/instagram-guide/ schon etwas liegt. Vorhandene Dateien und Einstellungen bleiben erhalten, ältere Dateien sicherst du vor einem Update. Lade https://insta.skaile.de/instagram-read.zip und die Prüfsumme https://insta.skaile.de/instagram-read.sha256, vergleiche beide und lies README.md, SKILL.md und instagram-read.py, bevor du etwas installierst. Entpacke nur diese drei Dateien in den persönlichen Skill-Ordner, damit der Skill in allen lokalen Projekten verfügbar ist.

2. Meta: Begleite mich durch Meta-App, Instagram-Produkt, Tester-Rolle und gegebenenfalls die Tester-Einladung. Fordere nur instagram_business_basic und instagram_business_manage_insights an. Anmelden und Freigaben bestätige ich selbst. Den Token erzeuge ich im Dashboard über „Generate token“. Prüfe API-Version und tatsächliche Gültigkeit des Tokens in meiner App.

3. Token: Gib mir den fertigen setup-Befehl mit der geprüften API-Version. Ich führe ihn in meinem eigenen Terminal aus und gebe den Token verdeckt ein. Frag nie nach Token, App-Secret oder dem Inhalt der Konfiguration. Öffne ~/.config/instagram-guide/config.json nicht, das Skript liest sie selbst. setup prüft vor dem Speichern den Kontonamen, ich bestätige Konto und Restgültigkeit.

4. Test: Ruf das Skript über seinen absoluten Pfad auf: erst me, dann reels --limit 20, danach insights --media-id für jedes gefundene Reel. Beachte die Abruf-Metadaten und sag ausdrücklich, wenn weniger Reels kamen oder ein Seitenlimit erreicht wurde. Bei Fehlern zu Anmeldung, Berechtigung oder Rate-Limit: anhalten und die Ursache klären. Fehlende Einzelwerte bleiben fehlend, echte Nullen bleiben 0.

5. Auswertung: Zeig eine Tabelle mit Link, Datum, Reach, Views, Saves, Shares, Skip-Rate (falls vorhanden) und Share-Rate. Share-Rate = Shares / Reach × 100, nur mit vorhandenen Werten und Reach über 0. Die Skip-Rate liefert die API bereits als Prozentwert. Vergleiche nur ähnliche Formate und ähnlich alte Videos. Keine Aussagen über Hook oder Schnitt ohne das Videomaterial. Nenne drei Auffälligkeiten und zwei mögliche Tests, keine bewiesenen Ursachen.

6. Pflege: Prüfe status und erkläre refresh. Erneuern geht erst, wenn der Token mindestens 24 Stunden alt und noch gültig ist. Zeig Ablaufdatum und ein Erinnerungsdatum davor. Eine Erinnerung gilt nur als eingerichtet, wenn sie nachweislich existiert. Ein abgelaufener Token wird neu erzeugt, nicht erneuert.

Nur lesen: nichts veröffentlichen, nichts kommentieren, nichts an andere Konten senden. Zum Schluss: bestandene Prüfungen und offene Punkte auflisten.

Auch zugeklappt wird der komplette Prompt kopiert.

Einrichtung

Deine Verbindung in neun Schritten.

Arbeite am Rechner und halt dein Handy mit Instagram bereit. Bei jedem Schritt steht, wo du gerade bist und woran du erkennst, dass es geklappt hat. Die Menüpfade sind Orientierung, Meta benennt Dinge je nach App und Konto etwas anders.

1. 1

   Instagram-App

   Kontotyp prüfen

   Öffne in Instagram die Einstellungen und such nach „Kontotyp und Tools“. Die API spricht nur mit professionellen Konten. Ob Creator oder Business ist egal, ein privates Konto reicht nicht.

   Das Konto muss öffentlich sein. Ist es schon professionell, änderst du nichts.

   Weiter, wenn dein Konto als Creator oder Business läuft.

2. 2

   Browser · Meta for Developers

   Entwicklerkonto anlegen

   Geh auf developers.facebook.com und melde dich an. Hast du noch kein Entwicklerkonto, führt dich Meta durch eine kurze Registrierung.

   Danach öffnest du „Meine Apps“. Entweder du nimmst eine bestehende eigene Business-App oder du startest mit „Create App“. Die Anmeldung bei Meta und die bei Instagram sind zwei verschiedene Logins, das verwirrt am Anfang oft.

   Weiter, wenn du im App-Dashboard bist und die App bearbeiten kannst.

3. 3

   Meta-App-Dashboard

   Instagram Login hinzufügen

   Bei einer neuen App wählst du als Typ „Other“ und dann „Business“. Name und Kontaktadresse eintragen, danach beim Produkt Instagram auf „Set up“.

   Bietet dir die Oberfläche direkt einen Instagram-Anwendungsfall an, nimm „API setup with Instagram business login“. Wichtig ist nur: Instagram Login, nicht Facebook Login. Eine Facebook-Seite brauchst du dafür nicht.

   Webhooks und eine öffentliche Login-Seite sind für deinen eigenen Lesezugriff nicht nötig.

   Create AppOtherBusinessInstagramSet up

   Weiter, wenn die App einen Bereich für Instagram Login zeigt.

4. 4

   Meta-App-Dashboard · App roles

   Dein Konto als Tester eintragen

   Unter „App roles → Roles“ siehst du, ob dein Instagram-Konto schon berechtigt ist. Fehlt es, klick auf „Add People“ und wähl „Instagram Tester“, falls das angeboten wird. Deinen Instagram-Namen eintragen, Einladung abschicken.

   In manchen Oberflächen geht es kürzer: unter „Instagram → API Setup → Add account“. Dann meldest du dich direkt bei Instagram an und das Konto ist zugeordnet.

   Ein Eintrag mit „ausstehend“ ist noch keine Freigabe. Ist dein Konto schon aktiv zugeordnet, brauchst du keine zweite Einladung.

   App rolesRolesAdd PeopleInstagram Tester

   Weiter, wenn dein Konto hinzugefügt oder als Tester eingeladen ist.

5. 5

   instagram.com · eingeladenes Konto

   Einladung annehmen

   Wartet eine Einladung, öffne instagram.com im Browser und melde dich mit genau diesem Konto an. In den Einstellungen findest du unter „Apps und Websites“ den Punkt „Tester-Einladungen“. Dort die Einladung deiner App annehmen.

   Zurück im Meta-Dashboard die Rollen neu laden. Das Konto darf nicht mehr als ausstehend dastehen.

   Keine Einladung zu sehen? Erst den Benutzernamen prüfen, dann, mit welchem Konto du gerade angemeldet bist. Hat Meta das Konto beim Hinzufügen schon direkt freigegeben, fällt dieser Schritt weg.

   Profil bearbeitenApps und WebsitesTester-EinladungenAnnehmen

   Weiter, wenn die Einladung angenommen oder das Konto direkt freigegeben ist.

6. 6

   Meta-App · Instagram API Setup

   Leserechte setzen, Token erzeugen

   Öffne „Instagram → API setup with Instagram business login“ und füg dein Konto hinzu, falls es noch fehlt. Für Profil und Kennzahlen brauchst du genau zwei Rechte:

   • instagram_business_basic
   • instagram_business_manage_insights

   Neben deinem Konto auf „Generate token“, bei Instagram anmelden, beide Freigaben bestätigen. Schreibrechte brauchst du hier nicht, also fordere auch keine an.

   Ein Token aus dem Dashboard gilt laut Meta 60 Tage. Schau trotzdem, was angezeigt wird, und notier dir die API-Version deiner App. Der Token gehört weder in den Claude-Chat noch auf einen Screenshot.

   Weiter, wenn der Token zum richtigen Konto gehört und beide Rechte bestätigt sind.

7. 7

   Dein Terminal · nicht der Claude-Chat

   Token lokal und verdeckt speichern

   Der Setup-Prompt hat das Lesepaket unter ~/.claude/skills/instagram-guide/ installiert. Claude ersetzt vXX.0 durch die API-Version aus deiner Meta-App:

   TerminalKopieren

   python3 ~/.claude/skills/instagram-guide/instagram-read.py setup --api-version vXX.0

   Den fertigen Befehl führst du selbst aus. Beim Einfügen des Tokens erscheinen keine Zeichen, das ist Absicht. Danach bestätigst du den gefundenen Kontonamen und die Restlaufzeit.

   Gespeichert wird unter ~/.config/instagram-guide/config.json mit eingeschränkten Dateirechten. Claude liest diese Datei nicht, das Skript holt sich den Token selbst.

   Weiter, wenn das Skript dein Konto erkannt und die Konfiguration gespeichert hat.

8. 8

   Claude Code · mit dem Skill

   Verbindung testen

   Lass Claude die Befehle nacheinander ausführen. Der erste liefert deinen Benutzernamen, der zweite sucht über mehrere Ergebnisseiten nach bis zu 20 Reels.

   TerminalKopieren

   python3 ~/.claude/skills/instagram-guide/instagram-read.py me
   python3 ~/.claude/skills/instagram-guide/instagram-read.py reels --limit 20
   python3 ~/.claude/skills/instagram-guide/instagram-read.py insights --media-id DEINE_REEL_ID

   Für DEINE_REEL_ID nimmst du eine ID, die der zweite Befehl wirklich zurückgegeben hat. Die Abruf-Metadaten sagen dir, ob es noch mehr Reels gibt oder eine Grenze erreicht wurde. 20 Reels sind eine Stichprobe, kein Gesamtbild. Für mehr erhöhst du das Limit.

   Weiter, wenn der Kontoname stimmt, echte Reel-IDs da sind und mindestens ein Reel echte Insights liefert. Einzelne Werte dürfen begründet fehlen. Fehlen alle, ist der Test nicht bestanden.

9. 9

   Claude Code · Tokenpflege

   Vor Ablauf erneuern

   Der Status zeigt dir, wann der Token abläuft. Lass dir ein Erinnerungsdatum ein paar Tage davor nennen.

   TerminalKopieren

   python3 ~/.claude/skills/instagram-guide/instagram-read.py status
   python3 ~/.claude/skills/instagram-guide/instagram-read.py refresh

   Erneuern klappt, sobald der Token mindestens 24 Stunden alt und noch gültig ist. Die neue Laufzeit bestimmt die Antwort von Meta, das Skript speichert den neuen Token, ohne ihn anzuzeigen. Danach einmal me prüfen.

   Ist der Token schon abgelaufen oder widerrufen, hilft refresh nicht mehr. Dann in Meta einen neuen erzeugen und setup wiederholen. Ein Kalendereintrag zählt erst, wenn er wirklich gespeichert ist.

   Weiter, wenn du das Ablaufdatum kennst und weißt, wie du rechtzeitig erneuerst.