소셜 리스닝 MCP 서버

Syften API를 통해 소셜 리스닝 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 AI 기반 소셜 멘션 분석을 가능하게 하며, 웹훅을 통한 실시간 알림을 지원합니다.

특징

실시간 소셜 언급 모니터링
AI 기반 콘텐츠 분류
중요한 언급에 대한 웹훅 알림
과거 데이터 백필링
추세 분석 및 보고
자연어 쿼리 지원

필수 조건

Node.js(v16 이상)
API 액세스가 가능한 Syften 계정
Claude 데스크톱 앱 또는 Claude 확장 기능이 있는 VSCode

설치

저장소를 복제합니다.

지엑스피1

종속성 설치:

npm install

서버를 빌드하세요:

npm run build

구성

1. Syften API 설정

Syften 계정에 로그인하세요
설정 > API 액세스로 이동하세요
아직 API 키를 생성하지 않았다면 생성하세요.
다음 단계를 위해 API 키를 복사하세요

2. Claude 데스크톱 구성

~/Library/Application Support/Claude/claude_desktop_config.json 에 서버 구성을 추가합니다.

{
  "mcpServers": {
    "social-listening": {
      "command": "node",
      "args": ["/absolute/path/to/social-listening/build/index.js"],
      "env": {
        "SYFTEN_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. VSCode 구성(선택 사항)

Claude 확장 기능과 함께 VSCode를 사용하는 경우 /Users/YOUR_USERNAME/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 에 구성을 추가합니다.

{
  "mcpServers": {
    "social-listening": {
      "command": "node",
      "args": ["/absolute/path/to/social-listening/build/index.js"],
      "env": {
        "SYFTEN_API_KEY": "your-api-key-here"
      }
    }
  }
}

사용 가능한 도구

1. 구성_ai_필터

멘션 분석을 위한 AI 필터링 설정을 구성합니다.

{
  "enabled": true,
  "min_confidence": 0.7,
  "categories": ["spam", "support", "feedback", "bug_report", "feature_request"],
  "webhook_url": "https://your-webhook.com/endpoint",
  "webhook_secret": "your-secret-token"
}

2. 웹훅 설정

실시간 알림을 위해 웹훅 엔드포인트를 구성합니다.

{
  "endpoint_url": "https://your-webhook.com/endpoint",
  "secret_token": "your-secret-token",
  "enabled": true
}

3. 백필_월

특정 달에 대한 언급을 보충합니다.

{
  "year": 2024,
  "month": 2
}

4. 최신 동기화

마지막 업데이트 이후 새로운 언급을 동기화합니다.

{}

5. 트렌드 분석

시간 경과에 따른 언급 추세를 분석합니다.

{
  "start_date": "2024-01-01",
  "end_date": "2024-02-01",
  "group_by": "day",
  "tags": ["feature", "bug"]
}

6. 상위_소스_얻기

상위 언급 소스/작성자를 확인하세요.

{
  "start_date": "2024-01-01",
  "end_date": "2024-02-01",
  "limit": 10
}

7. nlp_프롬프트

자연어 쿼리를 처리합니다.

{
  "prompt": "show me feedback mentions from last week"
}

8. get_ai_filtered_mentions

AI 필터링을 통해 언급 내용을 처리하세요.

{
  "start_date": "2024-01-01",
  "end_date": "2024-02-01",
  "min_confidence": 0.8,
  "categories": ["feedback", "bug_report"],
  "limit": 50
}

Claude에서의 사용 예

클로드와 함께 사용할 수 있는 몇 가지 프롬프트 예시는 다음과 같습니다.

AI 필터링 구성:

Configure the social listening AI filter to detect bug reports and feature requests with 80% confidence.

웹훅 알림 설정:

Set up a webhook for the social listening server to send notifications to https://my-server.com/webhook with the secret token "my-secret".

추세 분석:

Show me the trend of bug reports and feature requests from last month.

필터링된 언급 받기:

Show me all high-confidence bug reports from the past week.

자연어 쿼리:

What kind of feedback have we received about the new feature launch?

웹훅 통합

웹훅을 구성할 때 서버는 다음 형식으로 알림을 보냅니다.

{
  "mention_url": "https://example.com/post",
  "ai_score": 0.95,
  "ai_categories": ["bug_report", "feature_request"],
  "timestamp": "2024-02-12T15:30:00Z"
}

웹훅 요청에 포함된 헤더:

Content-Type: application/json
X-Webhook-Secret: your-secret-token

개발

소스에서 빌드

# Install dependencies
npm install

# Build the server
npm run build

# Run tests
npm test

새로운 기능 추가

src/ 에 새로운 기능을 구현합니다
tests/ 에 테스트 추가
로컬로 빌드하고 테스트하세요
풀 리퀘스트 제출

문제 해결

웹훅 오류 : 웹훅 엔드포인트에 액세스할 수 있고 HTTPS를 지원하는지 확인하세요.
API 키 문제 : Syften API 키가 구성에서 올바르게 설정되었는지 확인하세요.
데이터베이스 오류 : data 디렉토리가 존재하고 쓰기 가능한지 확인하세요

기여하다

저장소를 포크하세요
기능 브랜치 생성
변경 사항을 커밋하세요
지점으로 밀어 넣기
풀 리퀘스트 만들기

특허

MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.

Social Listening MCP Server