Skip to main content
Glama
Audiense Insights MCP Server

Audiense Insights MCP Server

Official
by AudienseCo

🏆 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.

Related MCP server: Mailchimp Universal MCP Server

🚀 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: person | brand , optional) : 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:

tail -f ~/Library/Logs/Claude/mcp*.log
  1. Überprüfen Sie, ob die Umgebungsvariablen richtig eingestellt sind.

  2. 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:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Für Windows:

Get-Content -Path "$env:AppData\Claude\Logs\mcp*.log" -Wait -Tail 20

🔐 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.

Available Tools

8 tools
compare-audience-influencersB

Compares the influencers of an audience with a baseline audience. The baseline is determined as follows: If the selection was the full audience and a single country represents more than 50% of the audience, that country is used as the baseline. Otherwise, the Global baseline is applied. If the selection was a specific segment, the full audience is used as the baseline. Each influencer comparison includes: - Affinity (%) - The level of alignment between the influencer and the audience. Baseline Affinity (%) - The influencer’s affinity within the baseline audience. Uniqueness Score - A measure of how distinct the influencer is within the selected audience compared to the baseline.

Inputs: audience_influencers_id (required), baseline_audience_influencers_id (required), cursor, count, +6 more.

get-audience-contentC

Retrieves audience content engagement details for a given audience.

This tool provides a detailed breakdown of the content an audience interacts with, including:

  • Liked Content: Popular posts, top domains, top emojis, top hashtags, top links, top media, and a word cloud.

  • Shared Content: Content that the audience shares, categorized similarly to liked content.

  • Influential Content: Content from influential accounts that impact the audience, with similar categorization.

Each category contains:

  • popularPost: List of the most engaged posts.

  • topDomains: Most mentioned domains.

  • topEmojis: Most used emojis.

  • topHashtags: Most used hashtags.

  • topLinks: Most shared links.

  • topMedia: Media types shared and samples.

  • wordcloud: Frequently used words.

Inputs: audience_content_id (required).

get-audience-insightsC

Retrieves aggregated insights for a given audience ID, providing statistical distributions across various attributes. Available insights include demographics (e.g., gender, age, country), behavioral traits (e.g., active hours, platform usage), psychographics (e.g., personality traits, interests), and socioeconomic factors (e.g., income, education status).

Inputs: audience_insights_id (required), insights.

get-baselinesC

Retrieves available baselines, optionally filtered by country.

Inputs: country.

get-categoriesA

Retrieves the list of available affinity categories that can be used as the categories parameter in the compare-audience-influencers tool.

Inputs: no named parameters.

get-report-infoB

Retrieves detailed information about a specific intelligence report, including its status, segmentation type, audience size, segments, and access links.

Inputs: report_id (required).

get-reportsB

Retrieves the list of Audiense insights reports owned by the authenticated user.

Inputs: no named parameters.

report-summaryC

Generates a comprehensive summary of an Audiense report, including segment details, top insights, and influencers.

Inputs: report_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: compare-audience-influencers focuses on influencer comparisons, get-audience-content on content engagement, get-audience-insights on aggregated statistics, get-baselines on baseline data, get-categories on affinity categories, get-report-info on report metadata, get-reports on report listings, and report-summary on report summarization. The descriptions reinforce these distinct roles, making tool selection unambiguous.

    Naming Consistency5/5

    All tool names follow a consistent kebab-case pattern with a verb-noun structure (e.g., get-audience-insights, compare-audience-influencers). The verbs are appropriate and predictable (get, compare, report), and there are no deviations in naming style or convention across the set.

    Tool Count5/5

    With 8 tools, this server is well-scoped for an audience insights domain. The count is neither too sparse nor bloated, covering core operations like retrieving insights, content, reports, and comparisons without redundancy. Each tool serves a specific, necessary function in the workflow.

    Completeness4/5

    The tool set provides comprehensive coverage for analyzing audience insights, including retrieval of reports, insights, content, and comparisons. Minor gaps exist, such as the lack of tools for creating or updating reports or audiences, which might limit full lifecycle management. However, the available tools support most common analysis tasks effectively.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables interaction with Google Ads accounts through the Model Context Protocol, specifically tuned for local service businesses. Provides account health scoring, search term waste analysis, and diagnostic insights without requiring GAQL knowledge.
      11
      355 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides a standardized interface for interacting with Mailchimp's tools and services through the Model Context Protocol, enabling easy management of Mailchimp campaigns, audiences, and reports via natural language commands.
      1
      MIT