Instagram Data Skill

Der deterministische Read-Pfad für öffentliche Instagram-Daten über UnifAPI. Dies ist ein Data Skill: Er führt von sich aus keine Marketing-Aufgabe aus — er benennt die konkreten instagram/...-Operationen, Antwortformen und Fallstricke, sodass jeder creator-first-Workflow (Shortlisting, Audience-Fit, Pricing-Kontext) aus einem bekannten Rezept liest, statt die Oberfläche jedes Mal neu zu entdecken.

Schreibgeschützt — Augen, keine Hände. Er recherchiert öffentliche Instagram-Daten und liefert zitierte Datensätze zurück; er postet nie, kommentiert nicht und schickt keine DMs, und UnifAPI hält nie Instagram-Credentials.

Nutzen Sie den unifapi-Skill für Live-Belege

Verbinden Sie sich einmal über den gemeinsamen unifapi-Skill (OAuth MCP), und rufen Sie dann die untenstehenden Operationen auf. Profile sind über {username} verschlüsselt und Posts über ihren {shortcode} (das URL-Segment) — instagram/resolve/* mappt zwischen Username↔User-ID und Shortcode↔Media-ID, wenn Sie es brauchen. Behalten Sie jegliche billing-Metadaten, damit der Output die Datensatzkosten ausweisen kann.

Response-Contract

Single-Entity-Endpunkte geben das Objekt in data zurück:

{
  "request_id": "unif_...",
  "data": {},
  "billing": { "records_charged": 1, "balance_remaining": 99 }
}

List-Endpunkte geben ein Array in data plus pagination zurück:

{
  "request_id": "unif_...",
  "data": [],
  "pagination": { "has_more": false, "next_cursor": null },
  "billing": { "records_charged": 1 }
}

Wenn pagination.has_more true ist, übergeben Sie pagination.next_cursor als den cursor der nächsten Anfrage. Bewahren Sie beim Melden der Kosten stets billing.

Kern-Operationen

Brauchen Sie ein Feld, das hier nicht aufgeführt ist? Nutzen Sie get_operation des unifapi-Skills, um das exakte Schema vor dem Aufruf zu lesen — aber wählen Sie die Operation aus dieser Tabelle, entdecken Sie sie nicht blind.

Workflow

Die deterministischen Rezepte. Wählen Sie das, das zur Aufgabe passt; jedes benennt exakt, was aufzurufen ist.

1. Ein Profil auflösen. Rufen Sie instagram/users/{username} für follower_count, media_count, is_private und is_verified auf.
2. Content und Engagement lesen. Rufen Sie instagram/users/{username}/posts und .../reels auf; jeder InstagramPost trägt like_count, comment_count und play_count/view_count für Video — und is_paid_partnership, um Sponsored Content zu markieren. Paginieren Sie über next_cursor.
3. Reaktion lesen. Rufen Sie instagram/posts/{shortcode}/comments (und den Replies-Endpunkt) für die Stimmung zu einem Top-Post auf.
4. Neue Handles entdecken. Rufen Sie instagram/search?q=..., instagram/explore oder instagram/locations/{id}/posts auf, lösen Sie dann die aufgedeckten Handles auf und loopen Sie zurück zu Schritt 1.
5. Ein Netzwerk oder eine Audience mappen. Rufen Sie instagram/users/{username}/followers, .../following oder .../tagged-posts auf (wer sie featured) für Reichweitenarbeit.
6. Alles zitieren. Jede Zahl knüpft an den Post oder das Profil zurück, aus dem sie stammt; melden Sie billing.records_charged (oder schätzen Sie, wenn billing-Metadaten fehlen).

Form-Notizen

• InstagramUser — über {username} verschlüsselt. follower_count, following_count, media_count, is_verified, is_private.
• InstagramPost — über {shortcode} verschlüsselt. caption, like_count, comment_count, play_count, view_count, taken_at, media_type, is_paid_partnership, user, location, carousel.
• InstagramComment — text, like_count, child_comment_count.
• InstagramLocation — name, lat, lng, media_count.

Fallstricke

• Profile sind über {username} verschlüsselt, Posts über {shortcode} — beide werden aus der öffentlichen IG-URL gelesen. Nutzen Sie instagram/resolve/* nur, wenn Sie die numerische User-ID oder Media-ID brauchen.
• Ein privater Account (is_private) exponiert das Profil, begrenzt aber die Medien — decken Sie das auf, übertünchen Sie keine dünne Abdeckung.
• is_paid_partnership markiert offengelegte Sponsored Posts — nützlicher Beleg für Pricing und Brand-Safety, melden Sie ihn.
• Ein niedriger Saldo kann List-Seiten still abschneiden: Prüfen Sie billing.truncated_due_to_balance — wenn true, ist die Seite unvollständig.

Output

Geben Sie die Datensätze zurück, die der aufrufende Workflow braucht, jeden zitiert an seinen Post oder sein Profil, plus eine einzeilige Kostennotiz (records_charged). Wenn dieser Skill direkt genutzt wird, ist eine kompakte Creator-Zusammenfassung der Standard:

**@handle** — {followers} followers, {media} posts, verified {yes/no}. Recent posts: avg {likes} likes / {comments} comments. Paid partnerships: {N}. Evidence: {post URLs}. Records: ~{N}.

Verwandte Skills

• kol-pricing, creator-shortlist, audience-fit-check (Influencer Marketing) — Instagram-Creator auf diesem Read-Pfad bepreisen und prüfen.
• unifapi — der gemeinsame Daten-Skill: MCP verbinden und exakte Schemas mit get_operation nachschlagen.