Skip to main content
Glama
Audiense Insights MCP Server

Audiense Insights MCP Server

Official
by AudienseCo

🏆 Audiense Insights MCP サーバー

鍛冶屋のバッジ

このサーバーは、モデルコンテキストプロトコル(MCP)をベースとしており、 Claudeやその他のMCP対応クライアントがAudiense Insightsアカウントと連携できるようにします。Audienseレポートから、人口統計、文化、インフルエンサー、コンテンツエンゲージメント分析といった マーケティングインサイトとオーディエンス分析を抽出します。


🚀 前提条件

このサーバーを使用する前に、次のものを用意してください。

  • Node.js (v18以上)

  • クロードデスクトップアプリ

  • API 認証情報を持つAudiense Insights アカウント

  • X/Twitter API ベアラートークン (オプション、強化されたインフルエンサーデータ用)


Related MCP server: Mailchimp Universal MCP Server

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Audiense Insights Server を自動的にインストールするには:

npx -y @smithery/cli@latest install @AudienseCo/mcp-audiense-insights --client claude

⚙️ Claude デスクトップの設定

  1. Claude Desktop の構成ファイルを開きます。

    • MacOSの場合:

      code ~/Library/Application\ Support/Claude/claude_desktop_config.json
    • ウィンドウズ:

      code %AppData%\Claude\claude_desktop_config.json
  2. 次の構成を追加または更新します。

    "mcpServers": {
      "audiense-insights": {
        "command": "/opt/homebrew/bin/node",
        "args": [
          "/ABSOLUTE/PATH/TO/YOUR/build/index.js"
        ],
        "env": {
          "AUDIENSE_CLIENT_ID": "your_client_id_here",
          "AUDIENSE_CLIENT_SECRET": "your_client_secret_here",
          "TWITTER_BEARER_TOKEN": "your_token_here"
        }          
      }     
    }
    
  3. ファイルを保存し、Claude Desktop を再起動します。

🛠️ 利用可能なツール

📌 get-reports

説明: 認証されたユーザーが所有するAudiense Insights レポートのリストを取得します。

  • パラメータ:なし

  • 応答:

    • JSON 形式のレポートのリスト。


📌 get-report-info

説明:特定のインテリジェンス レポートに関する詳細な情報を取得します。これには以下が含まれます。

  • 状態

  • セグメンテーションタイプ

  • 観客数

  • セグメント

  • アクセスリンク

  • パラメータ:

    • report_id(文字列) : インテリジェンス レポートの ID。

  • 応答:

    • 完全なレポートの詳細を JSON 形式で表示します。

    • レポートがまだ処理中の場合は、保留中のステータスを示すメッセージを返します。


📌 get-audience-insights

説明: 特定のオーディエンスに関する集計された分析情報を取得します。これには以下が含まれます。

  • 人口統計: 性別、年齢、国。

  • 行動特性: アクティブ時間、プラットフォームの使用状況。

  • サイコグラフィックス:性格特性、興味。

  • 社会経済的要因:収入、教育状況。

  • パラメータ:

    • audience_insights_id(文字列) : オーディエンスインサイトの ID。

    • insights(文字列の配列、オプション) :フィルタリングする特定のインサイト名のリスト。

  • 応答:

    • 構造化テキスト リストとしてフォーマットされた洞察。


📌 get-baselines

説明: 利用可能なベースラインオーディエンスを取得します。オプションで国別にフィルタリングできます。

  • パラメータ:

    • country(文字列、オプション) : フィルタリングする ISO 国コード。

  • 応答:

    • JSON 形式のベースライン オーディエンスのリスト。


📌 get-categories

説明: インフルエンサーの比較に使用できるアフィニティ カテゴリのリストを取得します。

  • パラメータ:なし

  • 応答:

    • JSON 形式のカテゴリのリスト。


📌 compare-audience-influencers

説明: 特定のオーディエンスのインフルエンサーを ベースラインオーディエンスと比較します。ベースラインは以下のように決定されます。

  • 1 つの国が視聴者の 50% 以上を占める場合は、その国が基準として使用されます。

  • それ以外の場合は、グローバル ベースラインが使用されます。

  • 特定のセグメントを選択した場合は、全オーディエンスがベースラインとして使用されます。

各インフルエンサーの比較には以下が含まれます。

  • 親和性(%) – インフルエンサーがオーディエンスとどの程度一致しているか。

  • ベースラインの親和性 (%) – ベースラインオーディエンス内でのインフルエンサーの親和性。

  • ユニークさスコア– インフルエンサーがベースラインと比較してどれだけ独特であるか。

  • パラメータ:

    • audience_influencers_id(文字列) : オーディエンスインフルエンサーの ID。

    • baseline_audience_influencers_id(文字列) : ベースラインオーディエンスインフルエンサーの ID。

    • cursor(数値、オプション) : ページネーションカーソル。

    • count(数値、オプション) : ページあたりの項目数 (デフォルト: 200)。

    • bio_keyword(文字列、オプション) : bio キーワードでインフルエンサーをフィルタリングします。

    • entity_type(列挙: person | brand 、オプション) : エンティティタイプでフィルタリングします。

    • followers_min(数値、オプション) : フォロワーの最小数。

    • followers_max(数値、オプション) : フォロワーの最大数。

    • categories(文字列の配列、オプション) :カテゴリ別にインフルエンサーをフィルタリングします。

    • countries(文字列の配列、オプション) :国 ISO コードでインフルエンサーをフィルタリングします。

  • 応答:

    • 親和性スコア、ベースライン比較、および一意性スコアを含むインフルエンサーのリスト (JSON 形式)。


📌 get-audience-content

説明: 次のような視聴者コンテンツエンゲージメントの詳細を取得します:

  • 「いいね!」されたコンテンツ: 最も人気のある投稿、ドメイン、絵文字、ハッシュタグ、リンク、メディア、ワードクラウド。

  • 共有コンテンツ: ほとんどの共有コンテンツは同様に分類されます。

  • 影響力のあるコンテンツ: 影響力のあるアカウントからのコンテンツ。

各カテゴリには次のものが含まれます。

  • popularPost : 最もエンゲージメントの高い投稿。

  • topDomains : 最も多く言及されたドメイン。

  • topEmojis : 最もよく使われる絵文字。

  • topHashtags : 最も使用されているハッシュタグ。

  • topLinks : 最も共有されたリンク。

  • topMedia : 共有メディア。

  • wordcloud : 最も頻繁に使用される単語。

  • パラメータ:

    • audience_content_id(文字列) : オーディエンスコンテンツの ID。

  • 応答:

    • JSON 形式のコンテンツエンゲージメントデータ。


📌 report-summary

説明: 次の内容を含むオーディエンス レポートの包括的な概要を生成します:

  • レポートのメタデータ(タイトル、セグメンテーションの種類)

  • 観客全員の人数

  • 詳細なセグメント情報

  • 各セグメントのトップインサイト(プロフィールキーワード、ユーザー属性、興味関心)

  • 各セグメントのトップインフルエンサーと比較指標

  • パラメータ:

    • report_id(文字列) : 要約するインテリジェンス レポートの ID。

  • 応答:

    • 各セグメントの構造化データを含む JSON 形式の完全なレポート概要

    • 保留中のレポートの場合: レポートがまだ処理中であることを示すステータス メッセージ

    • セグメントのないレポートの場合: 分析するセグメントがないことを示すメッセージ

💡 定義済みプロンプト

このサーバーには、事前設定されたプロンプトが含まれています

  • audiense-demo : Audiense レポートをインタラクティブに分析するのに役立ちます。

  • segment-matching : オーディエンス レポート全体でオーディエンス セグメントを一致および比較するためのプロンプト。人口統計、興味、インフルエンサー、エンゲージメント パターンに基づいて、類似点、固有の特性、主要な洞察を特定します。

使用法:

  • 最も関連性の高いレポートを見つけるために、reportName 引数を受け入れます。

  • ID が指定されている場合は、代わりにレポート ID で検索します。

ユースケース: オーディエンス分析のための構造化されたガイダンス。

🛠️ トラブルシューティング

Claudeにツールが表示されない

  1. Claude Desktop のログを確認します。

tail -f ~/Library/Logs/Claude/mcp*.log
  1. 環境変数が正しく設定されていることを確認します。

  2. index.js への絶対パスが正しいことを確認してください。

認証の問題

  • OAuth 資格情報を再確認してください。

  • リフレッシュ トークンがまだ有効であることを確認します。

  • 必要な API スコープが有効になっていることを確認します。

📜 ログの表示

サーバー ログを確認するには:

MacOS/Linuxの場合:

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

Windowsの場合:

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

🔐 セキュリティに関する考慮事項

  • API 認証情報は安全に保ち、パブリック リポジトリに公開しないでください。

  • 環境変数を使用して機密データを管理します。

📄 ライセンス

このプロジェクトはApache 2.0ライセンスに基づいてライセンスされています。詳細についてはLICENSEファイルをご覧ください。

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