CDCStream/skills

Wettbewerber-Inhaltsübersicht

Rufe die aktuellen öffentlichen Beiträge jedes Wettbewerbers auf den von ihnen genutzten Plattformen ab, bewerte sie nach Engagement im Vergleich zum eigenen Konto und fasse zusammen, was sich in diesem Zeitraum in ihren Inhalten geändert hat.

Was hiermit möglich ist und was nicht

• Nur öffentliche, nicht eingeloggte Daten. Keine Reichweite, Speicherungen, Klickraten oder Zielgruppendaten – schätze diese niemals.
• Die Plattformen unterscheiden sich darin, was eine Auflistung zurückgibt:
  • X user-tweets gibt die beliebtesten aktuellen Tweets des Kontos zurück (ca. 100), nicht eine chronologische Liste.
  • LinkedIn company-posts gibt die Beiträge zurück, die eine Unternehmensseite nicht eingeloggten Besuchern zeigt – etwa die 10 neuesten.
  • Facebook profile-posts gibt in der Regel nur 1-2 der neuesten Beiträge zurück, die eine Seite nicht eingeloggten Besuchern zeigt. Behandle Facebook als Stichprobe, nicht als vollständigen Feed, und erwähne dies im Bericht.
• Vergleiche das Engagement innerhalb eines Kontos und einer Plattform. Rohe Likes über verschiedene Plattformen hinweg sind nicht vergleichbar.

Zunächst zu erfassende Eingaben

1. Wettbewerber und deren Profil-URLs pro Plattform. Rate keine Benutzernamen – überspringe eine Plattform, die der Benutzer nicht angegeben hat.
2. Zeitraum (Standard: letzte 7 Tage) und Anzahl der abzurufenden Beiträge pro Plattform (Standard: 10; Facebook profile-posts akzeptiert maximal limit=4).
3. Vorheriger Übersichtsdatei, falls vorhanden, um die Veränderung im Vergleich zur Vorwoche zu melden.

Kostenschätzung – vor der Ausführung anzeigen

Pro Wettbewerber ein Auflistungsaufruf pro Plattform:

Plattform	Endpunkt	Credits
TikTok	/v1/tiktok/channel-posts	2
Instagram	/v1/instagram/channel-posts (0,3 pro Beitrag; 10 Beiträge)	3
YouTube	/v1/youtube/channel-videos	2
X	/v1/twitter/user-tweets	2
Threads	/v1/threads/user-posts	2
LinkedIn	/v1/linkedin/company-posts	1
Facebook	/v1/facebook/profile-posts	2

Alle sieben Plattformen: etwa 14 Credits pro Wettbewerber; ~16 mit ein paar optionalen Detailaufrufen. Gib die Gesamtsumme für die angeforderten Wettbewerber und Plattformen aus, überprüfe GET /v1/account/balance (kostenlos) und bitte um Bestätigung.

So rufst du Captapi auf

• MCP: tiktok_channel_posts, instagram_channel_posts, youtube_channel_videos, twitter_user_tweets, threads_user_posts, linkedin_company_posts, facebook_profile_posts.
• REST: GET https://api.captapi.com<path>?url=<Profil-URL>&limit=<N> mit Header Authorization: Bearer $CAPTAPI_API_KEY. Verwende limit=4 für Facebook; ein höherer Wert führt zu einem 422-Validierungsfehler.

Fehlgeschlagene Aufrufe kosten 0 Credits. Wiederhole einen Fehler mit retryable: true einmal; protokolliere einen Fehler mit retryable: false als Antwort für diese Plattform.

Schritte

1. Rufe Auflistungen für jeden Wettbewerber × Plattform ab, die der Benutzer angegeben hat.
2. Filtere nach dem Zeitraum anhand des publishedAt jedes Beitrags – eine Auflistung gibt die neuesten Beiträge zurück, unabhängig davon, wie alt sie sind. Melde „keine Beiträge in diesem Zeitraum“ getrennt von einem fehlgeschlagenen Aufruf. Behalte bei X die Tweets innerhalb des Zeitraums bei und weise darauf hin, dass die Quelle eine nach Beliebtheit sortierte Menge ist.
3. Führe plattformübergreifende Beiträge zusammen: Beiträge eines Wettbewerbers auf verschiedenen Plattformen mit Zeitstempeln im Abstand weniger Minuten und überlappendem Text gelten als ein Eintrag.
4. Bewerte jeden Beitrag im Vergleich zu seinem eigenen Konto auf derselben Plattform: engagement = Likes + Kommentare (+ Shares/Reposts, sofern vorhanden); lift = engagement / median-engagement der abgerufenen Beiträge dieses Kontos. Beiträge mit einem Lift ≥ 2 sind „Überflieger“.
5. Kennzeichne jeden Beitrag mit Format (Kurzvideos, Langvideos, Bilder, Karussells, Text, Link) und einem 2–4 Wörter umfassenden Thema, das du aus der Bildunterschrift ableitest.
6. Vergleiche mit dem vorherigen Bericht, falls vorhanden: Änderung der Beitragshäufigkeit, neue Themen, aufgegebene oder hinzugekommene Formate.

Format des Berichts

1. Aktivitätstabelle: Wettbewerber × Plattform → Beiträge in diesem Zeitraum (und Veränderung gegenüber dem letzten Zeitraum).
2. Überflieger: bis zu 5 pro Wettbewerber – Plattform, Datum, Format, erste Zeile der Bildunterschrift, Engagement und Lift, Link und Quellendpunkt.
3. Themen [erfordert menschliche Überprüfung]: 3–5 Themen oder Formate, die Wettbewerber bevorzugen, jedes mit mindestens zwei verlinkten Beiträgen untermauert.
4. Lücken und Einschränkungen: nicht angegebene oder fehlgeschlagene Plattformen, die obigen Hinweise zu Facebook und X sowie ungefähre Zahlen.
5. Credit-Gesamtsumme für den Durchlauf.

Wo ein Mensch überprüfen muss

• Themen-Tags und Schwerpunkte – sie werden aus den Bildunterschriften abgeleitet.
• Jede „strategische“ Interpretation der Daten; der Bericht zeigt, was gepostet wurde und wie es im Vergleich zum Konto abgeschnitten hat, nicht warum.