CDCStream/skills

Ad library weekly diff

Rufen Sie die aktuell sichtbaren Anzeigen jedes Mitbewerbers aus den öffentlichen Anzeigenbibliotheken ab, vergleichen Sie sie mit der Momentaufnahme der letzten Woche und erstellen Sie einen kurzen Bericht darüber, was neu ist, was gestoppt wurde und was die neuen Anzeigen aussagen.

Was öffentliche Anzeigenbibliotheken Ihnen sagen können und was nicht

Geben Sie diese Einschränkungen in jedem Bericht an. Lassen Sie den Leser nicht mehr daraus ableiten.

• Öffentliche Anzeigenbibliotheken zeigen keine Ausgaben, Impressionen oder Conversions für normale kommerzielle Anzeigen. Google veröffentlicht Ausgaben- und Impressionsbereiche nur für Wahlkampfanzeigen; Meta zeigt Reichweitenaufschlüsselungen nur für einige in der EU geschaltete und politische Anzeigen; LinkedIn zeigt Impressionen und Targeting für eine Teilmenge von Anzeigen. Schätzen Sie niemals Budget oder Leistung anhand der Anzeigenanzahl.
• "Nicht in der Bibliothek" bedeutet nicht "keine Werbung": Die Bibliotheken sind länderspezifisch und können einen Tag oder länger hinterherhinken.
• Die TikTok-Anzeigenbibliothek deckt nur Anzeigen ab, die in der EU/EWR, dem Vereinigten Königreich und der Schweiz ausgestrahlt werden. Geben Sie außerhalb dieser Länder "TikTok: nicht abgedeckt" an – melden Sie nicht null Anzeigen.
• Die Daten „Erstmals/Letztmals angezeigt“ sind Kalendertage, keine genauen Zeitpunkte.

Zuerst zu erfassende Eingaben

1. Wettbewerber: Markenname, und falls bekannt die Meta-Seiten-URL, den Google-Werbetreibendennamen und den LinkedIn-Unternehmensnamen.
2. Länder (zweistellige Codes). Standard: US. Fügen Sie ein EU-/UK-Land wie GB oder DE hinzu, wenn TikTok relevant ist.
3. Pfad zur Momentaufnahme-Datei. Standard: ad-library-snapshot.json im Arbeitsverzeichnis.
4. Ob Anzeigendetails und -texte für neue Anzeigen abgerufen werden sollen (mehr Credits, besserer Bericht).

Kostenschätzung – vor der Ausführung anzeigen

Pro Wettbewerber, pro Land:

Schritt	Endpunkt	Credits
Meta-Seite finden	/v1/ad-library/facebook/search-companies	2
Meta-Anzeigen	/v1/ad-library/facebook/company-ads	2
Google-Werbetreibenden finden	/v1/ad-library/google/advertiser-search	1
Google-Anzeigen	/v1/ad-library/google/company-ads	2
LinkedIn-Anzeigen	/v1/ad-library/linkedin/search-ads	2
TikTok-Anzeigen (nur EU/EWR/UK/CH)	/v1/ad-library/tiktok/search	2 (bis zu 5 auf dem Fallback-Pfad)

Das sind etwa 11 Credits pro Wettbewerber pro Land (9, wenn TikTok nicht abgedeckt ist). Die Nachschlagsschritte können bei späteren Läufen übersprungen werden, indem die Seiten-ID und die Werbetreibenden-ID in der Momentaufnahme gespeichert werden.

Optional, nur pro neuer Anzeige: Details (.../ad-details, 2 Credits) und Meta-Anzeigentext (/v1/ad-library/facebook/ad-transcript, 2 Credits). Begrenzen Sie diese – zum Beispiel auf 5 neue Anzeigen pro Wettbewerber – und geben Sie dies in der Schätzung an.

Geben Sie die Schätzung aus (Wettbewerber × Länder × 11, zuzüglich der Detail-Obergrenze) und prüfen Sie den Kontostand mit GET /v1/account/balance (kostenlos). Bitten Sie den Benutzer um Bestätigung, bevor Sie Credits ausgeben.

So rufen Sie Captapi auf

Beide Wege funktionieren; verwenden Sie den, den die Umgebung bereitstellt.

• MCP: Tools, die nach dem Endpunkt benannt sind, z. B. facebook_ad_library_company_ads, google_ad_library_company_ads, linkedin_ad_library_search_ads, tiktok_ad_library_search.
• REST: GET https://api.captapi.com<path>?<params> mit Header Authorization: Bearer $CAPTAPI_API_KEY.

Fehlgeschlagene Aufrufe kosten 0 Credits. Ein retryable: true-Fehler kann nach einer kurzen Wartezeit einmal wiederholt werden; retryable: false ist eine endgültige Antwort – notieren Sie sie, wiederholen Sie sie nicht.

Schritte

1. Laden Sie die Momentaufnahme, falls vorhanden. Sie bildet ab: competitor → country → library → {ids: [...], meta: {...}} plus gespeicherte Such-IDs.
2. Lösen Sie IDs nur auf, wo die Momentaufnahme keine hat:
   • Meta: facebook/search-companies?q=<brand>&country=<cc> → wählen Sie die namensgleiche Seite aus; behalten Sie deren pageId. Wenn mehrere richtig aussehen, fragen Sie nach.
   • Google: google/advertiser-search?q=<brand>&country=<cc> → behalten Sie die Werbetreibenden-ID des passenden Ergebnisses.
3. Rufen Sie aktuelle Anzeigen für jeden Wettbewerber und jedes Land ab:
   • facebook/company-ads?url=<pageId or page URL>&country=<cc>&status=active
   • google/company-ads?advertiser=<advertiser id or name>&country=<cc>
   • linkedin/search-ads?company=<name>&country=<cc>
   • tiktok/search?q=<brand>&country=<cc> – nur für EU/EWR/UK/CH.
4. Vergleichen Sie anhand der Anzeigen-ID mit der Momentaufnahme: neu (jetzt vorhanden, vorher nicht), gestoppt (vorher, jetzt nicht), laufend.
5. Reichern Sie neue Anzeigen an bis zur vereinbarten Obergrenze: .../ad-details für Daten und Medien, facebook/ad-transcript für Meta-Überschrift/Text/CTA/Landing-URL.
6. Erstellen Sie den Bericht (Format unten) und speichern Sie die neue Momentaufnahme – erst nachdem der Bericht geschrieben wurde, damit ein fehlgeschlagener Lauf niemals die letzte Woche überschreibt.

Berichtsformat

Für jeden Wettbewerber:

• Eine Zeile pro Bibliothek: neu N · gestoppt N · laufend N, oder der Grund, warum sie fehlt (in diesem Land nicht abgedeckt, Suche fehlgeschlagen, 0 Anzeigen gefunden).
• Neue Anzeigen: Überschrift oder erste Zeile des Texts, Format (Bild/Video/Karussell), erstmals angezeigtes Datum, Landing-Domain und der Endpunkt, von dem sie stammt, z. B. (Quelle: /v1/ad-library/facebook/company-ads).
• Themen: 2–4 Aufzählungspunkte zu den Blickwinkeln, die die neuen Anzeigen gemeinsam haben (Angebot, Zielgruppe, Produkt). Markieren Sie jedes als [erfordert menschliche Überprüfung] – es ist eine Interpretation.
• Gestoppte Anzeigen: Anzahl, plus die am längsten laufende, die gestoppt wurde.

Enden Sie mit dem obigen Abschnitt zu den Einschränkungen, einer einzeiligen Gesamtcreditanzahl für den Lauf und dem Pfad zur Momentaufnahme.

Wo eine menschliche Überprüfung erforderlich ist

• Welche Seite oder welcher Werbetreibende „der“ Wettbewerber ist, wenn die Suche mehrere Ergebnisse liefert.
• Jede Behauptung zu Thema oder Strategie – die Bibliotheken zeigen Creatives, nicht die Absicht dahinter.
• Jede Schlussfolgerung zu Budget oder Leistung: Es gibt keine Daten dafür; der Bericht muss dies klarstellen, anstatt zu raten.