🏆 Audiense Insights MCP 서버

이 서버는 MCP(Model Context Protocol) 기반이며, Claude 또는 기타 MCP 호환 클라이언트가 Audiense Insights 계정과 상호 작용할 수 있도록 지원합니다. Audiense 보고서에서 인구 통계, 문화, 인플루언서 및 콘텐츠 참여 분석을 포함한 마케팅 인사이트와 잠재고객 분석을 추출합니다.

🚀 필수 조건

이 서버를 사용하기 전에 다음 사항을 확인하세요.

• Node.js (v18 이상)
• 클로드 데스크톱 앱
• API 자격 증명이 있는 Audiense Insights 계정
• X/Twitter API 전달자 토큰 (선택 사항, 강화된 인플루언서 데이터용)

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 로그 확인:

2. 환경 변수가 올바르게 설정되었는지 확인하세요.
3. index.js의 절대 경로가 올바른지 확인하세요.

인증 문제

• OAuth 자격 증명을 다시 확인하세요.
• 새로 고침 토큰이 여전히 유효한지 확인하세요.
• 필요한 API 범위가 활성화되어 있는지 확인하세요.

📜 로그 보기

서버 로그를 확인하려면:

MacOS/Linux의 경우:

Windows의 경우:

🔐 보안 고려 사항

• API 자격 증명을 안전하게 보관하세요. 공개 저장소에 절대 노출하지 마세요.
• 민감한 데이터를 관리하려면 환경 변수를 사용하세요.

📄 라이센스

이 프로젝트는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.