Teste die SKAILE Community 3 Tage kostenlos. Claude von Grund auf: Setup, Skills und echte Projekte.

3 Tage gratis testen →
Guide · Keyword INSTA

Dein Instagram.
In Claude Code.

Verbinde dein eigenes Konto und vergleiche deine Reels mit echten Kennzahlen. Hier findest du den Weg durch Meta, die Tester-Freigabe und ein fertiges Lesepaket.

Setup-Prompt kopieren ↓

Zuerst in Claude Code

Ein Prompt. Dann Schritt für Schritt.

Kopiere den Prompt in Claude Code auf deinem Rechner. Claude installiert das Lesepaket und begleitet dich. Die Anmeldung bei Meta und die Eingabe deines Tokens machst du selbst.

Für die Einrichtung in allen lokalen Claude-Code-Projekten. Der komplette Prompt wird auch zugeklappt kopiert.

Vollständigen Prompt ansehen
Richte mein eigenes professionelles Instagram-Konto in meinem lokalen Claude Code ein. Führe mich anhand von https://insta.skaile.de/ durch die neun Schritte. Nutze Instagram API with Instagram Login, nicht den Facebook-Login-Weg.

1. Prüfe zuerst Python 3.9 oder neuer und eine vorhandene Installation unter ~/.claude/skills/instagram-guide/. Erhalte vorhandene Dateien und Einstellungen. Lade https://insta.skaile.de/instagram-read.zip und die Prüfsumme unter https://insta.skaile.de/instagram-read.sha256. Prüfe die ZIP, lies README.md, SKILL.md und instagram-read.py vor der Installation. Entpacke nur diese drei Dateien in den persönlichen Skill-Ordner. Sichere ältere Dateien vor einem Update. Der Skill soll in allen lokalen Projekten verfügbar sein.
2. Führe mich durch Meta-App, Instagram-Konto, Tester-Rolle und gegebenenfalls Tester-Einladung. Verlange für Profil und Insights instagram_business_basic und instagram_business_manage_insights. Ich melde mich selbst an und bestätige die Freigaben. Verwende den Dashboard-Weg mit Generate token. Prüfe API-Version und tatsächliche Token-Gültigkeit in meiner App.
3. Gib mir den vollständigen setup-Befehl mit der geprüften API-Version für mein eigenes Terminal. Ich führe ihn selbst aus und gebe den Token verdeckt ein. Frage niemals nach Token, App-Secret oder Konfigurationsinhalt im Chat. Lies die Datei ~/.config/instagram-guide/config.json nicht in deinen Kontext. Das Skript muss sie selbst lesen. setup prüft den Kontonamen vor dem Speichern; ich bestätige das richtige Konto und die tatsächliche Restgültigkeit.
4. Rufe das Skript über seinen absoluten Pfad auf: zuerst me, dann reels --limit 20. Beachte die Abruf-Metadaten. Wenn weniger Reels vorliegen oder das Seitenlimit erreicht wurde, sage es ausdrücklich. Rufe insights --media-id für jedes abgerufene Reel auf. Bei Authentifizierungs-, Berechtigungs- oder Rate-Limit-Fehlern anhalten und die Ursache beheben. Nicht verfügbare Einzelmetriken bleiben fehlend, echte Nullen bleiben 0.
5. Zeige Link, Datum, Reach, Views, Saves, Shares, verfügbare Skip-Rate sowie Share-Rate in Prozent. Share-Rate = Shares / Reach * 100, nur mit vorhandenen Zahlen und Reach > 0. Skip-Rate aus der API ist bereits ein Prozentwert. Vergleiche ähnliche Formate und ähnlich alte Videos. Behaupte keine Analyse des gesprochenen Hooks oder Schnitts ohne zusätzliches Videomaterial. Nenne drei Auffälligkeiten und zwei mögliche Tests, keine bewiesenen Ursachen.
6. Prüfe status und erkläre den refresh-Befehl. Ein langlebiger Token muss mindestens 24 Stunden alt und noch gültig sein. Zeige Ablaufdatum und Erinnerungsdatum. Eine echte Erinnerung oder Automatisierung nur als eingerichtet melden, wenn sie nachweislich existiert. Ein abgelaufener Token muss neu erzeugt werden.

Dieses Setup liest nur. Nichts veröffentlichen, kommentieren oder an andere Accounts senden. Zeige am Ende die bestandenen Prüfungen und noch offenen Punkte.
Direkt zu den neun Schritten ↓Lesepaket herunterladenSHA-256-Prüfsumme

Du brauchst lokales Claude Code und Python 3.9 oder neuer auf macOS, Linux oder Windows mit WSL. Unter Windows führst du Claude Code und das Paket in derselben WSL-Umgebung aus. Dazu kommt Zugriff auf dein eigenes Instagram. Ein normaler Chat auf claude.ai führt diese lokalen Befehle nicht aus. Das Lesepaket hat keine zusätzlichen Python-Abhängigkeiten. Dein Claude-Tarif gilt weiter.

Der Ablauf

Drei Orte. Eine Verbindung.

Instagram gibt die Daten frei. Deine Meta-App verwaltet den Zugang. Der lokale Skill ruft die Kennzahlen ab.

  1. InstagramDein professionelles Konto
  2. Meta-AppRolle, Rechte und Token
  3. Claude CodeLokaler Skill und Auswertung

Eigenes Konto: Creator oder Business. Ein persönliches Konto reicht nicht.

Eigene App: Für den hier beschriebenen Zugriff auf dein zugeordnetes Konto genügt Standard Access.

Keine Facebook-Seite nötig: Wir verwenden Instagram Login. Ein Meta-Entwicklerkonto brauchst du trotzdem.

Nur lesen: Das Paket veröffentlicht nichts und beantwortet keine Kommentare.

Für fremde Konten oder einen Dienst für andere Nutzer gelten zusätzliche Freigaben und gegebenenfalls App Review. Diese Anleitung richtet deinen eigenen Lesezugriff ein.

Einrichtung

Deine Verbindung in neun Schritten.

Arbeite am Rechner und halte Instagram bereit. Unter jedem Schritt steht, wo du gerade bist und woran du den Erfolg erkennst. Die Abbildungen sind beschriftete Orientierungsschemata.

  1. Instagram-App

    Professionelles Konto prüfen

    Öffne in Instagram deine Kontoeinstellungen und suche nach Kontotyp und Tools. Wenn du noch ein persönliches Konto hast, wechsle zu einem professionellen Konto. Creator oder Business funktioniert.

    Dein Konto muss für diesen API-Zugang öffentlich sein. Hast du bereits ein professionelles Konto, lässt du den Kontotyp unverändert.

    Weiter, wenn: dein eigenes Konto als Creator oder Business eingerichtet ist.

  2. Browser am Rechner · Meta for Developers

    Entwicklerkonto öffnen

    Öffne Meta for Developers und melde dich an. Falls du noch kein Entwicklerkonto hast, schließe die angezeigte Registrierung ab.

    Wechsle anschließend zu deinen Apps. Wähle eine passende eigene Business-App oder starte mit Create App. Instagram-Zugang und Entwickleranmeldung sind zwei getrennte Anmeldungen.

    Weiter, wenn: du das App-Dashboard erreichst und deine App verwalten kannst.

  3. Meta-App-Dashboard

    Instagram Login hinzufügen

    Bei einer neuen App beschreibt Meta diesen Weg: Other → Business. Vergib einen Namen, trage deine Kontaktadresse ein und füge anschließend das Produkt Instagram über Set up hinzu.

    Falls deine Oberfläche direkt einen Instagram-Anwendungsfall anbietet, richte darüber API setup with Instagram business login ein. Entscheidend ist Instagram Login. Wähle hier nicht den Facebook-Login-Weg.

    Für den ersten eigenen Lesezugriff brauchst du keinen Nachrichten-Webhook und keine öffentliche Login-Seite für andere Nutzer.

    Meta for Developers · Orientierung
    Create App
    Other → Business
    Instagram → Set up
    API setup with Instagram business login
    Schematische Orientierung, kein Screenshot. Beschriftungen können in deiner Meta-Oberfläche abweichen.

    Weiter, wenn: deine App den Bereich für Instagram Login zeigt.

  4. Meta-App-Dashboard · App roles

    Dein Konto als Tester hinzufügen

    Prüfe unter App roles → Roles, ob dein Instagram-Konto bereits berechtigt ist. Fehlt es, wähle in der Rollenansicht Add People → Instagram Tester, falls diese Auswahl angezeigt wird. Trage deinen eigenen Instagram-Benutzernamen ein und sende die Einladung.

    In manchen Oberflächen fügst du das Konto direkt unter Instagram → API Setup → Add account hinzu. Meta führt dich dann durch die Instagram-Anmeldung. Prüfe danach die Zuordnung in der App.

    Wenn dein eigenes Konto schon aktiv zugeordnet ist, brauchst du keine zweite Einladung. Ein ausstehender Eintrag ist noch keine angenommene Freigabe.

    App roles · Roles

    Wenn deine Oberfläche den Tester-Dialog zeigt

    Add People → Instagram Tester
    @dein_konto
    Einladung ausstehend
    Schematische Orientierung, kein Screenshot. Beschriftungen können in deiner Meta-Oberfläche abweichen.

    Weiter, wenn: dein Konto in der App hinzugefügt oder als Tester eingeladen ist.

  5. instagram.com · mit dem eingeladenen Konto

    Tester-Einladung annehmen

    Falls eine Einladung aussteht, öffne instagram.com im Browser und melde dich mit genau dem eingeladenen Konto an. Öffne die Einstellungen, je nach Ansicht über Profil bearbeiten → Apps und Websites. Suche dort Tester-Einladungen und nimm die Einladung deiner App an.

    Gehe zurück ins Meta-Dashboard und lade die Rollenansicht neu. Das Konto darf nicht mehr nur als ausstehend erscheinen.

    Keine Einladung sichtbar? Prüfe zuerst den Instagram-Benutzernamen und das aktuell angemeldete Konto. Wenn Meta das Konto beim Hinzufügen bereits direkt freigegeben hat, entfällt die separate Annahme.

    Instagram · Tester-Einladung
    Angemeldet als @dein_konto
    Apps und Websites → Tester-Einladungen
    Deine Meta-App → Einladung annehmen
    Danach: Zuordnung in Meta prüfen
    Schematische Orientierung. Der genaue Menüpfad hängt von deiner Instagram-Ansicht ab.

    Weiter, wenn: die Einladung angenommen oder dein Konto bereits direkt freigegeben ist.

  6. Meta-App · Instagram API Setup

    Leserechte prüfen und Token erzeugen

    Öffne Instagram → API setup with Instagram business login. Füge dein Konto hier hinzu, falls es noch nicht angezeigt wird. Für Profil und Kennzahlen brauchst du:

    • instagram_business_basic
    • instagram_business_manage_insights

    Prüfe diese Rechte in der Berechtigungsansicht deiner App und im Freigabedialog. Wähle neben deinem Konto Generate token, melde dich bei Instagram an und bestätige die Freigaben. Fordere für diesen Guide keine zusätzlichen Schreibrechte an.

    Ein im App-Dashboard erzeugter Token ist laut Meta bereits 60 Tage gültig. Prüfe trotzdem die angezeigte Gültigkeit und die unterstützte API-Version deiner App. Der Token gehört nicht in den Claude-Chat oder einen Screenshot.

    Instagram · API setup

    Dein zugeordnetes professionelles Konto

    @dein_konto
    Generate token
    API-Version deiner App notieren
    Token nur für die lokale Eingabe kopieren
    Schematische Orientierung, kein Screenshot. Beschriftungen können in deiner Meta-Oberfläche abweichen.

    Weiter, wenn: der Token für das richtige Konto vorliegt und beide Leserechte freigegeben sind.

  7. Dein eigener Terminal · nicht im Claude-Chat

    Token verdeckt lokal speichern

    Der Setup-Prompt installiert das geprüfte Paket unter ~/.claude/skills/instagram-guide/. Lass Claude den folgenden Befehl mit der API-Version aus deiner Meta-App vervollständigen. vXX.0 ist ein Platzhalter.

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

    Führe den fertigen Befehl selbst in deinem Terminal aus. Der Token wird verdeckt abgefragt. Dass beim Einfügen keine Zeichen erscheinen, ist normal. Bestätige den geprüften Kontonamen und die tatsächliche Restgültigkeit.

    Das Skript speichert die Konfiguration unter ~/.config/instagram-guide/config.json mit eingeschränkten Dateirechten. Claude soll diese Datei nicht öffnen oder ausgeben. Für die Analyse liest das Skript den Token selbst.

    Weiter, wenn: das Skript das richtige Konto geprüft und die geschützte Konfiguration gespeichert hat.

  8. Claude Code · mit dem installierten Skill

    Die Verbindung wirklich testen

    Lass Claude diese Befehle nacheinander ausführen. Der erste muss deinen Benutzernamen liefern. Der zweite sucht über mehrere Ergebnisseiten nach bis zu 20 Reels.

    python3 ~/.claude/skills/instagram-guide/instagram-read.py me
python3 ~/.claude/skills/instagram-guide/instagram-read.py reels --limit 20

    Nimm dann eine tatsächlich zurückgegebene Reel-ID. Ersetze DEINE_REEL_ID im nächsten Befehl.

    python3 ~/.claude/skills/instagram-guide/instagram-read.py insights --media-id DEINE_REEL_ID

    Die Abruf-Metadaten zeigen, ob weitere Reels vorhanden sind oder eine Grenze erreicht wurde. Auch 20 gefundene Reels sind kein vollständiger Kontovergleich. Für mehr kannst du das Limit gezielt erhöhen.

    Erfolg erkennen · Beispiel
    1. me Dein eigener Benutzername 2. reels Reel-IDs, Links, Datum plus tatsächlicher Abrufumfang 3. insights Messwerte oder klarer Fehlwert Authfehler stoppen den Abruf
    Erwartete Prüfpunkte, keine echte API-Antwort.

    Weiter, wenn: dein Kontoname stimmt, echte Reel-IDs vorliegen und mindestens ein Reel echte Insights liefert. Einzelne Kennzahlen dürfen begründet fehlen; fehlen alle, ist die Insights-Prüfung nicht bestanden.

  9. Claude Code · Tokenpflege

    Vor Ablauf verlängern

    Prüfe den gespeicherten Ablaufzeitpunkt und lass dir ein Erinnerungsdatum davor nennen. Ein Kalendertermin ist erst eingerichtet, wenn er tatsächlich gespeichert wurde.

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

    Ein langlebiger Token kann ab einem Alter von 24 Stunden erneuert werden, solange er noch gültig ist. Die erfolgreiche Antwort von Meta bestimmt die neue Gültigkeit. Das Skript speichert den erneuerten Token, ohne ihn auszugeben.

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

    Danach erneut me prüfen. Ist der Token bereits abgelaufen oder widerrufen, erzeuge in Meta einen neuen und wiederhole setup. Ein Refresh repariert keinen abgelaufenen Token.

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

Das Ergebnis

Deine abgerufenen Reels vergleichen.

Eine gemeinsame Tabelle macht Unterschiede sichtbar. Vergleiche ähnliche Formate und ähnlich alte Videos. Fehlende Daten bleiben als fehlend erkennbar.

Rechenbeispiel mit erfundenen Daten. Keine Ergebnisse deines Kontos.
ReelReachViewsSavesSharesSkip-RateShare-Rate
Beispiel A1.0001.500403028 %3,0 %
Beispiel B2.0002.6002020fehlt1,0 %
Beispiel C5006400035 %0,0 %

30 Shares ÷ 1.000 Reach × 100 = 3 %. Beispiel A hat weniger Views als B, aber mehr Shares pro erreichtem Konto. Daraus allein folgt noch keine Ursache.

Reach und Views
Reach schätzt die erreichten eindeutigen Konten. Views sind Aufrufe und können wiederholte Wiedergaben enthalten.
Saves und Shares
Gespeicherte und geteilte Inhalte. Im API-Feld heißt Saves saved. Echte 0 und fehlende Daten sind verschieden.
Skip-Rate
Prozent der initialen Views, bei denen innerhalb der ersten drei Sekunden übersprungen wurde. Meta kennzeichnet die Kennzahl als geschätzt und in Entwicklung.
Share-Rate
Eigene Berechnung: Shares ÷ Reach × 100. Nur bei vorhandenen Werten und Reach über 0. Kein Anteil eindeutig gezählter teilender Personen.

Nach der Einrichtung: aus den abgerufenen Zahlen einen sinnvollen Vergleich machen.

Vollständigen Prompt ansehen
Vergleiche meine mit instagram-guide abgerufenen Reels. Nenne zuerst Anzahl, Zeitraum und mögliche Abrufgrenzen. Zeige Links, Datum, Reach, Views, Saves, Shares, verfügbare Skip-Rate und Share-Rate in Prozent. Berechne Shares / Reach * 100 und Saves / Reach * 100 nur mit vorhandenen Werten und Reach > 0. Fehlende Werte sind keine Null. API-Fehler sind keine fehlenden Messwerte.

Vergleiche ähnliche Formate und ähnlich alte Reels. Nenne drei auffällige Ergebnisse und zwei konkrete Tests für den nächsten Inhalt. Trenne Beobachtung und Hypothese. Analysiere gesprochene Hooks nur anhand des Videos oder Transkripts. Beurteile Schnitt und visuelle Hooks nur, wenn du das betreffende Video tatsächlich angesehen hast. Aus Kennzahlen allein folgt keine Ursache.
Weitere Kennzahlen und Grenzen

Das Paket fragt auch Reposts und durchschnittliche Wiedergabezeit ab. Die Wiedergabezeit bleibt als API-Rohwert gekennzeichnet, solange ihre Einheit nicht verifiziert ist. Sie darf nicht einfach als Sekunden angezeigt werden.

profile_visits ist laut Metas aktueller Referenz für Feed und Stories dokumentiert, nicht für Reels. Deshalb fragt dieses Paket Profilbesuche nicht ab. Es lädt keine Videos herunter und transkribiert keine Hooks. Dafür wäre eine zusätzliche Videoanalyse nötig.

Wenn etwas hängt

Fehler erkennen. Gezielt weiterkommen.

Gib Claude die Fehlermeldung ohne Zugangsdaten. Ein ungültiger Token soll den Abruf stoppen, nicht eine Tabelle voller scheinbar fehlender Werte erzeugen.

„Insufficient developer role“ oder keine Tester-Einladung

Prüfe Schritt 4 und 5. Stimmen Instagram-Benutzername und angemeldetes Konto überein? Ist die Einladung angenommen? Lade danach die Rollenansicht neu. Nutze kein fremdes Konto und erzeuge den Token erst nach der Freigabe.

„Token ungültig“, abgelaufen oder API-Code 190

Erzeuge im Meta-Dashboard einen neuen Token und führe setup in deinem eigenen Terminal erneut aus. Teile den Token nicht mit Claude. Anschließend me prüfen. Ein abgelaufener Token lässt sich nicht per refresh retten.

Kontoname funktioniert, Insights fehlen aber

Prüfe instagram_business_manage_insights und den Freigabestatus deiner App. Nach geänderten Berechtigungen kann eine erneute Anmeldung mit neuem Token nötig sein. Prüfe auch, ob die Medien-ID zu deinem eigenen professionellen Konto gehört. Einzelne nicht verfügbare Metriken sind möglich; ein Berechtigungsfehler ist keine normale Datenlücke.

Es kommen weniger Reels zurück als erwartet

Lies die Metadaten der Ausgabe. Das Paket filtert Reels über mehrere Medienseiten und begrenzt die Arbeit. Andere Posttypen zählen nicht als Reels. Erhöhe das Reel-Limit bei Bedarf, behaupte aber nie einen vollständigen Vergleich, wenn has_more oder truncated gesetzt ist.

Refresh geht heute noch nicht

Ein frisch erzeugter langlebiger Token muss mindestens 24 Stunden alt sein. Das Skript wartet vorsichtshalber 24 Stunden ab dem unter obtained_at gespeicherten lokalen Einrichtungs- oder Erneuerungszeitpunkt. Die gespeicherte Gültigkeit ist eine lokale Angabe; ein erfolgreicher me-Aufruf prüft den tatsächlichen Zugriff.

Meta meldet zu viele Anfragen

Stoppe den Abruf und warte entsprechend Metas Hinweis. Das Skript startet keine endlose Wiederholung. Verkleinere später den Umfang und frage nicht bei jeder Analyse alle alten Reels erneut ab.

Kann ich später auch Kommentare oder Reels veröffentlichen?

Mit zusätzlichen Berechtigungen und eigenen Schreibfunktionen ist das möglich. Dieses Paket bietet diese Funktionen bewusst nicht an. Ein Upload über den hier beschriebenen Instagram-Login-Weg benötigt eine für Meta erreichbare Video-URL. Metas beschriebener Resumable Upload gehört zum Facebook-Login-Weg.

Prüfe vor einer Veröffentlichung das aktuelle Kontolimit über content_publishing_limit und gib jeden Schreibvorgang ausdrücklich frei.

Meta: App erstellenMeta: erster AbrufMeta: KennzahlenMeta: TokenpflegeMeta: PublishingClaude Code: persönliche Skills

Stand 20.09.2026. Eigenes lokales Lesepaket, kein offizieller Anthropic-Connector. Die Meta-Menüs können je nach App und Konto variieren. Entscheidend sind die jeweils beschriebenen Erfolgsprüfungen.

SKAILE Community

Drei Tage kostenlos reinschauen.

In der SKAILE Community lernst du Claude Code von Grund auf: das richtige Setup, die besten Skills und Plugins, echte Projekte statt nur chatten. Genau für Leute, die gerade anfangen und es richtig machen wollen.

3 Tage kostenlos testen →

In den drei Tagen wird nichts abgebucht. Kündigst du vorher, zahlst du keinen Cent.

3 Tage kostenlos testen →