🏆 Audiense Insights MCP 서버
이 서버는 MCP(Model Context Protocol) 기반이며, Claude 또는 기타 MCP 호환 클라이언트가 Audiense Insights 계정과 상호 작용할 수 있도록 지원합니다. Audiense 보고서에서 인구 통계, 문화, 인플루언서 및 콘텐츠 참여 분석을 포함한 마케팅 인사이트와 잠재고객 분석을 추출합니다.
🚀 필수 조건
이 서버를 사용하기 전에 다음 사항을 확인하세요.
Node.js (v18 이상)
클로드 데스크톱 앱
API 자격 증명이 있는 Audiense Insights 계정
X/Twitter API 전달자 토큰 (선택 사항, 강화된 인플루언서 데이터용)
Related MCP server: Audius MCP Server
Smithery를 통해 설치
Smithery를 통해 Claude Desktop용 Audiense Insights Server를 자동으로 설치하려면 다음을 수행합니다.
지엑스피1
⚙️ Claude Desktop 구성
Claude Desktop의 구성 파일을 엽니다.
맥OS:
code ~/Library/Application\ Support/Claude/claude_desktop_config.json윈도우:
code %AppData%\Claude\claude_desktop_config.json
다음 구성을 추가하거나 업데이트하세요.
"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" } } }파일을 저장하고 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: : 엔티티 유형별로 필터링합니다.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에 도구가 나타나지 않음
Claude Desktop 로그 확인:
환경 변수가 올바르게 설정되었는지 확인하세요.
index.js의 절대 경로가 올바른지 확인하세요.
인증 문제
OAuth 자격 증명을 다시 확인하세요.
새로 고침 토큰이 여전히 유효한지 확인하세요.
필요한 API 범위가 활성화되어 있는지 확인하세요.
📜 로그 보기
서버 로그를 확인하려면:
MacOS/Linux의 경우:
Windows의 경우:
🔐 보안 고려 사항
API 자격 증명을 안전하게 보관하세요. 공개 저장소에 절대 노출하지 마세요.
민감한 데이터를 관리하려면 환경 변수를 사용하세요.
📄 라이센스
이 프로젝트는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.