TikTok MCP 서비스

TikTok 비디오 검색 및 메타데이터 추출을 위한 모델 컨텍스트 프로토콜 서비스입니다. 이 서비스는 해시태그로 TikTok 비디오를 검색하고 인기 콘텐츠를 검색할 수 있는 강력한 인터페이스를 제공하며, 내장된 탐지 방지 기능과 오류 처리 기능을 갖추고 있습니다.

특징

• 해시태그로 동영상 검색

• 검색당 구성 가능한 비디오 수(기본값: 30)

• 봇 탐지 방지 대책

• 프록시 지원

• 자동 API 세션 관리

• 속도 제한 및 오류 처리

• 건강 상태 모니터링

Related MCP server: studiosphere-pulse-mcp

구성

이 서비스는 환경 변수를 사용하여 구성합니다. 다음을 사용하여 .env 파일을 만드세요.

지엑스피1

설치 및 설정

# Install dependencies
poetry install

# Install browser automation dependencies
poetry run python -m playwright install

# Start the service
poetry run python -m tiktok_mcp_service.main

Claude 데스크톱 통합

서비스가 실행되면 Claude Desktop과 통합할 수 있습니다. 종속성 관리를 위해 Poetry를 사용하고 있으므로 Poetry를 통해 MCP CLI 명령을 실행하세요.

# Navigate to the project directory
cd /path/to/tiktok-mcp-service

# Install the service in Claude Desktop with Poetry in editable mode
poetry run mcp install tiktok_mcp_service/main.py --with-editable . -f .env

# Optional: Install with a custom name
poetry run mcp install tiktok_mcp_service/main.py --name "TikTok Video Search" --with-editable . -f .env

설치 후 해당 서비스는 Claude Desktop에서 사용할 수 있으며, 적절한 종속성 관리를 위해 Poetry를 사용하여 실행됩니다.

API 엔드포인트

건강 검진

• GET /health - 서비스 상태 및 API 초기화 상태 확인

  {
    "status": "running",
    "api_initialized": true,
    "service": {
      "name": "TikTok MCP Service",
      "version": "0.1.0",
      "description": "A Model Context Protocol service for searching TikTok videos"
    }
  }

비디오 검색

• POST /search - 해시태그로 영상 검색

  {
    "search_terms": ["python", "coding"],
    "count": 30  // Optional, defaults to 30
  }

  응답에는 비디오 URL, 설명, 참여 통계(조회수, 좋아요, 공유, 댓글)가 포함됩니다.

자원 관리

• POST /cleanup - 리소스 및 API 세션 정리

오류 처리

이 서비스에는 다음에 대한 포괄적인 오류 처리가 포함됩니다.

• API 초기화 실패

• 봇 감지 문제

• 네트워크 오류

• 속도 제한

• 잘못된 검색어입니다

개발

다음으로 구성됨:

• 틱톡 API

• 패스트MCP

• 의존성 관리를 위한 시

• 브라우저 자동화를 위한 Playwright

특허

MIT# tiktok_mcp

TikTok API 제한 사항

중요 공지: TikTok은 API 접근을 제한하는 엄격한 스크래핑 방지 조치를 시행하고 있습니다. 이에 따라 이 서비스는 다음과 같은 기능을 제공합니다.

1. 모의 데이터 모드 : TikTok이 API 접근을 차단할 경우(현재처럼), 서비스는 검색어와 관련된 사실적인 시뮬레이션 결과를 제공합니다. 이를 통해 TikTok이 접근을 제한하더라도 Claude 통합 기능이 계속 작동합니다.

2. API 접근 시도 : 서비스는 여전히 먼저 TikTok API를 사용하려고 시도하지만 API를 사용할 수 없거나 오류가 반환되면 빠르게 모의 데이터로 되돌아갑니다.

3. 투명성 : 모의 데이터가 제공되는 경우 transformations 필드를 통해 응답에서 이를 명확하게 나타내며, 시뮬레이션 결과가 표시된다는 설명이 포함됩니다.

이 구현을 통해 TikTok의 스크래핑 방지 조치에도 불구하고 서비스가 계속 작동되도록 보장할 수 있습니다.