Skip to main content
Glama
Audiense Insights MCP Server

Audiense Insights MCP Server

Official
by AudienseCo

🏆 Audiense Insights MCP 서버

대장간 배지

이 서버는 MCP(Model Context Protocol) 기반이며, 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를 자동으로 설치하려면 다음을 수행합니다.

지엑스피1

⚙️ Claude Desktop 구성

  1. Claude Desktop의 구성 파일을 엽니다.

    • 맥OS:

      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 인사이트 보고서 목록을 검색합니다.

  • 매개변수 : 없음

  • 응답 :

    • 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

설명 : 특정 타겟층의 인플루 언서와 기준 타겟층을 비교합니다. 기준층은 다음과 같이 결정됩니다.

  • 단일 국가가 전체 시청자의 50% 이상을 차지하는 경우, 해당 국가를 기준으로 사용합니다.

  • 그렇지 않은 경우에는 글로벌 기준선이 사용됩니다.

  • 특정 세그먼트를 선택하면 전체 대상이 기준으로 사용됩니다.

각 인플루언서 비교에는 다음이 포함됩니다.

  • 친화도(%) – 인플루언서가 대중과 얼마나 잘 어울리는지.

  • 기준 친화도(%) – 기준 청중 내에서 인플루언서의 친화도입니다.

  • 고유성 점수 – 영향력 있는 사람이 기준선과 비교했을 때 얼마나 독특한가를 나타냅니다.

  • 매개변수 :

    • audience_influencers_id(문자열) : 청중 인플루언서의 ID입니다.

    • baseline_audience_influencers_id(문자열) : 기준 청중 인플루언서의 ID입니다.

    • cursor(숫자, 선택 사항) : 페이지 번호 커서.

    • count(숫자, 선택 사항) : 페이지당 항목 수(기본값: 200).

    • bio_keyword(문자열, 선택 사항) : 바이오 키워드 로 인플루언서를 필터링합니다.

    • entity_type(enum: 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

설명 : 다음을 포함하여 Audiense 보고서에 대한 포괄적인 요약을 생성합니다.

  • 보고서 메타데이터(제목, 세분화 유형)

  • 전체 청중 규모

  • 자세한 세그먼트 정보

  • 각 세그먼트(생물학적 키워드, 인구 통계, 관심사)에 대한 주요 통찰력

  • 비교 지표를 포함한 각 세그먼트별 최고 영향력자

  • 매개변수 :

    • report_id(문자열) : 요약할 인텔리전스 보고서의 ID입니다.

  • 응답 :

    • 각 세그먼트에 대한 구조화된 데이터가 포함된 JSON 형식의 전체 보고서 요약

    • 보류 중인 보고서의 경우: 보고서가 아직 처리 중임을 나타내는 상태 메시지

    • 세그먼트가 없는 보고서의 경우: 분석할 세그먼트가 없음을 나타내는 메시지

💡 미리 정의된 프롬프트

이 서버에는 미리 구성된 프롬프트가 포함되어 있습니다.

  • audiense-demo : Audiense 보고서를 대화형으로 분석하는 데 도움이 됩니다.

  • segment-matching : Audiense 보고서에서 대상 고객 세그먼트를 매칭하고 비교하여 인구 통계, 관심사, 영향력 있는 사람 및 참여 패턴을 기반으로 유사점, 고유한 특성 및 주요 통찰력을 파악하는 프롬프트입니다.

용법:

  • 가장 관련성 있는 보고서를 찾기 위해 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
    ResponsivenessNo recent community issues

    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
      153 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