Audiense MCP 서버의 TweetBinder

이는 Audiense API의 TweetBinder를 위한 MCP(Model Context Protocol) 서버로, Claude 와 다른 MCP 호환 AI 모델이 Audiense 분석 데이터에 액세스할 수 있도록 해줍니다.

특징

• Claude에서 직접 TweetBinder 분석에 액세스하세요.
• Twitter/X의 해시태그, 사용자 및 대화를 분석합니다.
• 참여 지표, 감정 분석 등을 얻으세요
• 사용자 정의 검색 쿼리를 사용하여 Twitter 보고서 만들기
• 보고서 생성 상태 확인
• 자세한 보고서 통계 검색
• 계좌 잔액 및 할당량 정보 받기
• 특정 쿼리와 일치하는 트윗 수 계산
• TweetBinder 보고서를 나열하고 관리하세요
• 보고서에서 트윗 콘텐츠 및 사용자 정보에 액세스

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 mcp-tweetbinder를 자동으로 설치하려면:

지엑스피1

수동 구성

필수 조건

• Node.js (v18 이상)
• 클로드 데스크톱 앱
• API 자격 증명을 사용한 Audiense 계정의 TweetBinder

1. 이 저장소를 복제하세요
2. 종속성 설치:
   npm install
3. 프로젝트를 빌드하세요:
   npm run build

이 서비스를 사용하려면 유효한 TweetBinder API Bearer 토큰이 필요합니다. 환경에서 설정하세요.

Claude Desktop과 함께 사용

1. Claude Desktop 구성 파일을 편집하세요.
   • 맥OS:
     code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • 윈도우:
     code %AppData%\Claude\claude_desktop_config.json
2. 다음 구성을 추가합니다.

3. Claude Desktop을 다시 시작하세요

사용 가능한 도구

create-twitter-report

검색어를 기반으로 Twitter/X 데이터를 분석하는 새로운 보고서를 만듭니다.

• 매개변수 :
  • query (문자열): Twitter 데이터에 대한 검색 쿼리입니다. AND, OR, 해시태그, 멘션 등의 연산자를 포함할 수 있습니다.
  • limit (숫자, 선택 사항): 검색할 트윗의 최대 개수(최대 50,000개).
  • startDate (숫자, 선택 사항): Unix 타임스탬프(시대 이후 초)로 표시된 시작 날짜입니다.
  • endDate (숫자, 선택 사항): Unix 타임스탬프(시대 이후 초)로 표현된 종료 날짜입니다.
  • reportType (열거형, 선택 사항): 생성할 보고서 유형입니다. 지난주 보고서의 경우 "7일", 전체 기간의 경우 "이력"입니다. 기본값: "7일".
• 응답 :
  • 생성된 보고서에 대한 보고서 ID 및 상태 정보입니다.
  • 보고서 상태를 확인하고 통계를 검색하는 방법에 대한 지침입니다.

create-twitter-count

검색어와 일치하는 트윗을 계산하는 새로운 보고서를 만듭니다.

• 매개변수 :
  • query (문자열): Twitter 데이터에 대한 검색 쿼리입니다. AND, OR, 해시태그, 멘션 등의 연산자를 포함할 수 있습니다.
  • reportType (열거형, 선택 사항): 생성할 보고서 유형입니다. 지난주 보고서의 경우 "7일", 전체 기간의 경우 "이력"입니다. 기본값: "7일".
• 응답 :
  • 다음을 포함하는 원시 JSON 응답:
    • status : 보고서 생성 상태
    • resourceId : 생성된 보고서의 ID
    • error / message : 오류 또는 상태 메시지

list-reports

정렬 기능을 갖춘 모든 TweetBinder 보고서 목록을 검색합니다.

• 매개변수 :
  • order (문자열, 선택 사항): '필드|방향' 형식의 정렬 매개변수입니다. 예: 'createdAt|-1'은 최신 항목이 먼저 표시되고, 'createdAt|1'은 오래된 항목이 먼저 표시됩니다.
• 응답 :
  • 각 보고서에 대한 세부 정보가 포함된 보고서 배열을 포함하는 원시 JSON 응답:
    • id : 보고서 ID
    • name : 보고서 이름
    • status : 현재 상태(생성됨, 대기 중 등)
    • createdAt : 생성 타임스탬프
    • updatedAt : 마지막 업데이트 타임스탬프
    • type : 보고서 유형
    • source : 보고서 출처
    • query : 원래 검색어

get-report-content

고급 필터링 및 페이지 매김 기능을 사용하여 생성된 보고서에서 실제 트윗이나 사용자를 검색합니다.

• 매개변수 :
  • reportId (문자열): 콘텐츠를 검색할 보고서의 ID입니다.
  • contentType (enum): 검색할 콘텐츠 유형입니다. 트윗 데이터의 경우 'tweets'이고 사용자 데이터의 경우 'users'입니다.
  • page (번호, 선택 사항): 페이지 번호입니다. 1부터 시작합니다.
  • perPage (숫자, 선택 사항): 페이지당 항목 수.
  • sortBy (문자열, 선택 사항): 정렬 기준 필드(예: 'createdAt', 'counts.favorites').
  • sortDirection (enum, 선택 사항): 정렬 방향: 오름차순은 '1', 내림차순은 '-1'입니다.
  • filter (문자열, 선택 사항): 필터 기준이 포함된 JSON 문자열입니다. 예: '{"counts.favorites":{"$gt":10}}'
• 응답 :
  • 다음을 포함하는 원시 JSON 응답:
    • items : 트윗 또는 사용자 객체의 배열
    • pagination : 총 항목 및 페이지에 대한 정보

  트윗을 요청하면 다음을 포함한 자세한 정보가 반환됩니다.

  • 트윗 ID, 텍스트, 생성 날짜, 언어
  • 작성자 세부 정보(이름, 사용자 이름, 팔로워 등)
  • 참여 지표(리트윗, 좋아요, 답글 등)
  • 미디어 콘텐츠(해시태그, 이미지, 링크)
  • 감정 분석

  사용자에게 요청할 때 포함되는 정보는 다음과 같습니다.

  • 사용자 ID, 이름, 사용자 이름
  • 프로필 사진 URL
  • 팔로워 및 팔로잉 수
  • 검증 상태
  • 사용자 가치 및 기타 지표

참고: 콘텐츠에 액세스하려면 보고서가 '생성됨' 상태여야 합니다. get-report-status 도구를 사용하여 보고서가 준비되었는지 확인하세요.

쿼리 구문 예:

• #apple : #apple 해시태그가 포함된 트윗
• apple lang:en : "apple"을 포함하는 영어 트윗
• (#apple OR #iphone) -#android : #apple 또는 #iphone은 포함하지만 #android는 포함하지 않는 트윗
• @apple : @apple을 언급하는 트윗
• from:apple : 사용자 "apple"이 게시한 트윗

참고: 카운트 보고서를 만든 후 get-report-status 도구를 사용하여 준비가 되었는지 확인한 다음, get-report-stats 사용하여 실제 카운트를 가져옵니다.

get-report-status

TweetBinder 보고서의 현재 상태를 확인합니다.

• 매개변수 :
  • reportId (문자열): 확인할 보고서의 ID입니다.
• 응답 :
  • 보고서의 현재 상태는 다음 중 하나일 수 있습니다.
    • 생성됨 : 보고서가 완료되어 사용할 준비가 되었습니다.
    • 대기 중 : 보고서가 아직 생성 중이거나 트윗 수집을 기다리고 있습니다.
    • 오래됨 : 보고서는 새로운 데이터로 업데이트 중이며 곧 제공될 예정입니다.
    • 삭제됨 : 보고서가 삭제되어 더 이상 사용할 수 없습니다.
    • 보관됨 : 보고서가 보관되었으며 곧 삭제될 수 있습니다.
  • 상태가 무엇을 의미하는지, 어떤 작업이 가능한지에 대한 설명입니다.

참고: 먼저 create-twitter-report 또는 create-twitter-count 도구를 사용하여 보고서를 생성하고 보고서 ID를 얻어야 합니다.

get-report-stats

TweetBinder 보고서에 대한 포괄적인 통계와 분석을 검색합니다.

• 매개변수 :
  • reportId (문자열): 통계를 검색할 보고서의 ID입니다.
• 응답 :
  • 다음을 포함한 보고서 통계의 형식화된 요약:
    • 개요 : 총 트윗 수, 날짜 범위, 기여자, 참여도, 미디어 및 링크.
    • 참여 지표 : 잠재적 도달 범위, 노출 수, 리트윗, 좋아요.
    • 감정 분석 : 전반적인 감정 점수와 해석.
    • 상위 기여자 : 가장 활동적인 사용자와 트윗 수.
    • 인기 콘텐츠 : 가장 많이 리트윗된 게시물.
    • 자주 사용되는 해시태그 : 대화에서 일반적으로 사용되는 해시태그입니다.

참고: 통계를 검색하려면 보고서 상태가 "생성됨"이어야 합니다. get-report-status 도구를 사용하여 보고서가 준비되었는지 확인하세요.

get-account-balances

계정의 크레딧 잔액, 사용량, 남은 할당량에 대한 정보를 검색합니다.

• 매개변수 :
  • 없음
• 반품 :
  • 다음을 포함하는 원시 JSON 응답:
    • total : 사용 가능한 총 학점
    • used : 사용된 크레딧
    • available : 현재 사용 가능한 크레딧
    • discount : 적용 가능한 할인
    • remainingReports : 남은 보고서 수
    • quota : 할당량 정보 포함:
      • startedAt : 할당 기간 시작 날짜
      • finishedAt : 할당 기간 종료 날짜
      • remaining : 남은 할당량
      • used : 사용된 할당량
      • total : 총 할당량
  • 오류 또는 상태 메시지

문제 해결

Claude에 도구가 나타나지 않음

1. Claude Desktop 로그 확인:

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

인증 문제

• 신원증명서를 다시 한번 확인하세요.
• 새로 고침 토큰이 여전히 유효한지 확인하세요.
• 필수 API 범위가 활성화되어 있고 충분한 크레딧이 있는지 확인하세요.

로그 보기

서버 로그를 확인하려면:

MacOS/Linux의 경우:

Windows의 경우:

보안 고려 사항

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

📄 라이센스

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