TikTok MCP Service

TikTok MCP 서비스

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

특징

• 해시태그로 동영상 검색
• 검색당 구성 가능한 비디오 수(기본값: 30)
• 봇 탐지 방지 대책
• 프록시 지원
• 자동 API 세션 관리
• 속도 제한 및 오류 처리
• 건강 상태 모니터링

구성

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

지엑스피1

설치 및 설정

Claude 데스크톱 통합

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

설치 후 해당 서비스는 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