🏆 Audiense Insights MCP-Server

Dieser Server basiert auf dem Model Context Protocol (MCP) und ermöglicht Claude oder jedem anderen MCP-kompatiblen Client die Interaktion mit Ihrem Audiense Insights- Konto. Er extrahiert Marketing-Insights und Zielgruppenanalysen aus Audiense-Berichten und deckt dabei demografische, kulturelle, Influencer- und Content-Engagement-Analysen ab.

🚀 Voraussetzungen

Stellen Sie vor der Verwendung dieses Servers sicher, dass Sie über Folgendes verfügen:

• Node.js (v18 oder höher)

• Claude Desktop App

• Audiense Insights-Konto mit API-Anmeldeinformationen

• X/Twitter API Bearer Token (optional, für angereicherte Influencer-Daten)

⚙️ Claude Desktop konfigurieren

1. Öffnen Sie die Konfigurationsdatei für Claude Desktop:

   • MacOS:

     code ~/Library/Application\ Support/Claude/claude_desktop_config.json

   • Windows:

     code %AppData%\Claude\claude_desktop_config.json

2. Fügen Sie die folgende Konfiguration hinzu oder aktualisieren Sie sie:

   "mcpServers": { "audiense-insights": { "command": "npx", "args": [ "-y", "mcp-audiense-insights" ], "env": { "AUDIENSE_CLIENT_ID": "your_client_id_here", "AUDIENSE_CLIENT_SECRET": "your_client_secret_here", "TWITTER_BEARER_TOKEN": "your_token_here" } } }

3. Speichern Sie die Datei und starten Sie Claude Desktop neu.

🛠️ Verfügbare Tools

📌 get-reports

Beschreibung : Ruft die Liste der Audiense Insights-Berichte ab, die dem authentifizierten Benutzer gehören.

• Parameter : Keine

• Antwort :

  • Liste der Berichte im JSON-Format.

📌 get-report-info

Beschreibung : Ruft ausführliche Informationen zu einem bestimmten Geheimdienstbericht ab, darunter:

• Status

• Segmentierungstyp

• Publikumsgröße

• Segmente

• Zugriffslinks

• Parameter :

  • report_id(Zeichenfolge) : Die ID des Geheimdienstberichts.

• Antwort :

  • Vollständige Berichtsdetails im JSON-Format.

  • Wenn der Bericht noch verarbeitet wird, wird eine Meldung zurückgegeben, die den ausstehenden Status angibt.

📌 get-audience-insights

Beschreibung : Ruft aggregierte Erkenntnisse für eine bestimmte Zielgruppe ab, darunter:

• Demografie : Geschlecht, Alter, Land.

• Verhaltensmerkmale : Aktive Stunden, Plattformnutzung.

• Psychografik : Persönlichkeitsmerkmale, Interessen.

• Sozioökonomische Faktoren : Einkommen, Bildungsstatus.

• Parameter :

  • audience_insights_id(Zeichenfolge) : Die ID der Zielgruppen-Insights.

  • insights(Zeichenfolgen-Array, optional) : Liste mit bestimmten zu filternden Insight-Namen.

• Antwort :

  • Erkenntnisse als strukturierte Textliste formatiert.

📌 get-baselines

Beschreibung : Ruft verfügbare Basiszielgruppen ab, optional gefiltert nach Land .

• Parameter :

  • country(Zeichenfolge, optional) : ISO-Ländercode, nach dem gefiltert werden soll.

• Antwort :

  • Liste der Basiszielgruppen im JSON-Format.

📌 get-categories

Beschreibung : Ruft die Liste der verfügbaren Affinitätskategorien ab, die in Influencer-Vergleichen verwendet werden können.

• Parameter : Keine

• Antwort :

  • Liste der Kategorien im JSON-Format.

📌 compare-audience-influencers

Beschreibung : Vergleicht Influencer einer bestimmten Zielgruppe mit einer Basiszielgruppe . Die Basiszielgruppe wird wie folgt ermittelt:

• Wenn ein einzelnes Land mehr als 50 % des Publikums repräsentiert, wird dieses Land als Basis verwendet.

• Andernfalls wird die globale Basislinie verwendet.

• Wenn ein bestimmtes Segment ausgewählt wird, wird die gesamte Zielgruppe als Basis verwendet.

Jeder Influencer-Vergleich beinhaltet:

• Affinität (%) – Wie gut der Influencer zum Publikum passt.

• Basisaffinität (%) – Die Affinität des Influencers innerhalb des Basispublikums.

• Einzigartigkeitswert – Wie deutlich sich der Influencer vom Ausgangswert abhebt.

• Parameter :

  • audience_influencers_id(Zeichenfolge) : ID der Zielgruppen-Influencer.

  • baseline_audience_influencers_id(Zeichenfolge) : ID der Influencer des Baseline-Publikums.

  • cursor(Zahl, optional) : Seitencursor.

  • count(Zahl, optional) : Anzahl der Elemente pro Seite (Standard: 200).

  • bio_keyword(Zeichenfolge, optional) : Filtern Sie Influencer nach Bio-Schlüsselwort .

  • entity_type(Aufzählung: : Filtern nach Entitätstyp.

  • followers_min(Zahl, optional) : Mindestanzahl an Followern.

  • followers_max(Zahl, optional) : Maximale Anzahl an Followern.

  • categories(Zeichenfolgen-Array, optional) : Filtern Sie Influencer nach Kategorien .

  • countries(Zeichenfolgen-Array, optional) : Filtern Sie Influencer nach ISO-Ländercodes .

• Antwort :

  • Liste der Influencer mit Affinitätsbewertungen, Basisvergleich und Eindeutigkeitsbewertungen im JSON-Format.

📌 get-audience-content

Beschreibung : Ruft Details zur Inhaltsinteraktion des Publikums ab, darunter:

• Beliebte Inhalte : Beliebteste Beiträge, Domänen, Emojis, Hashtags, Links, Medien und eine Wortwolke.

• Freigegebener Inhalt : Die meisten freigegebenen Inhalte sind ähnlich kategorisiert.

• Einflussreicher Inhalt : Inhalt von einflussreichen Konten.

Jede Kategorie enthält:

• popularPost : Beiträge mit den meisten Interaktionen.

• topDomains : Am häufigsten erwähnte Domänen.

• topEmojis : Am häufigsten verwendete Emojis.

• topHashtags : Am häufigsten verwendete Hashtags.

• topLinks : Am häufigsten geteilte Links.

• topMedia : Gemeinsam genutzte Medien.

• wordcloud : Am häufigsten verwendete Wörter.

• Parameter :

  • audience_content_id(Zeichenfolge) : Die ID des Zielgruppeninhalts.

• Antwort :

  • Daten zur Inhaltsinteraktion im JSON-Format.

📌 report-summary

Beschreibung : Generiert eine umfassende Zusammenfassung eines Audiense-Berichts, einschließlich:

• Berichtsmetadaten (Titel, Segmentierungstyp)

• Gesamte Zuschauerzahl

• Detaillierte Segmentinformationen

• Top-Erkenntnisse für jedes Segment (Bio-Schlüsselwörter, demografische Merkmale, Interessen)

• Top-Influencer für jedes Segment mit Vergleichsmetriken

• Parameter :

  • report_id(Zeichenfolge) : Die ID des zusammenzufassenden Geheimdienstberichts.

• Antwort :

  • Vollständige Berichtszusammenfassung im JSON-Format mit strukturierten Daten für jedes Segment

  • Für ausstehende Berichte: Statusmeldung, die angibt, dass der Bericht noch verarbeitet wird

  • Für Berichte ohne Segmente: Meldung, dass keine Segmente zur Analyse vorhanden sind

💡 Vordefinierte Eingabeaufforderungen

Dieser Server enthält vorkonfigurierte Eingabeaufforderungen

• audiense-demo : Hilft bei der interaktiven Analyse von Audiense-Berichten.

• segment-matching : Eine Aufforderung zum Abgleichen und Vergleichen von Zielgruppensegmenten in Audiense-Berichten, um Ähnlichkeiten, einzigartige Merkmale und wichtige Erkenntnisse basierend auf demografischen Merkmalen, Interessen, Influencern und Engagement-Mustern zu identifizieren.

Verwendung:

• Akzeptiert ein ReportName-Argument, um den relevantesten Bericht zu finden.

• Wenn eine ID angegeben ist, wird stattdessen nach der Berichts-ID gesucht.

Anwendungsfall: Strukturierte Anleitung zur Zielgruppenanalyse.

🛠️ Fehlerbehebung

Werkzeuge, die in Claude nicht erscheinen

1. Überprüfen Sie die Protokolle von Claude Desktop:

2. Überprüfen Sie, ob die Umgebungsvariablen richtig eingestellt sind.

3. Stellen Sie sicher, dass der absolute Pfad zu index.js korrekt ist.

Authentifizierungsprobleme

• Überprüfen Sie die OAuth-Anmeldeinformationen doppelt.

• Stellen Sie sicher, dass das Aktualisierungstoken noch gültig ist.

• Überprüfen Sie, ob die erforderlichen API-Bereiche aktiviert sind.

📜 Protokolle anzeigen

So überprüfen Sie die Serverprotokolle:

Für MacOS/Linux:

Für Windows:

🔐 Sicherheitsüberlegungen

• Bewahren Sie API-Anmeldeinformationen sicher auf – geben Sie sie niemals in öffentlichen Repositories preis.

• Verwenden Sie Umgebungsvariablen, um vertrauliche Daten zu verwalten.

📄 Lizenz

Dieses Projekt ist unter der Apache 2.0-Lizenz lizenziert. Weitere Informationen finden Sie in der Lizenzdatei.