TikTok MCP 서비스

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

특징

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

구성

이 서비스는 환경 변수를 사용하여 구성합니다. 다음을 사용하여 .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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

해시태그로 TikTok 비디오를 검색하고 트렌드 콘텐츠를 검색하며, 탐지 방지 조치와 포괄적인 메타데이터 추출 기능을 갖춘 강력한 인터페이스를 제공합니다.

Integrations