Servicio MCP de TikTok

Un servicio de Protocolo de Contexto Modelo para el descubrimiento de videos de TikTok y la extracción de metadatos. Este servicio proporciona una interfaz robusta para buscar videos de TikTok por hashtags y recuperar contenido en tendencia, con medidas antidetección integradas y gestión de errores.

Características

Buscar vídeos por hashtags
Recuento de vídeos configurable por búsqueda (predeterminado: 30)
Medidas de detección anti-bots
Soporte de proxy
Gestión automática de sesiones de API
Limitación de velocidad y manejo de errores
Monitoreo del estado de salud

Configuración

El servicio utiliza variables de entorno para la configuración. Cree un archivo .env con:

ms_token=your_tiktok_ms_token  # Optional but recommended to avoid bot detection
TIKTOK_PROXY=your_proxy_url    # Optional proxy configuration

Instalación y configuración

# 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

Integración de escritorio de Claude

Una vez que su servicio esté en ejecución, puede integrarlo con Claude Desktop. Dado que usamos Poetry para la gestión de dependencias, asegúrese de ejecutar los comandos de la CLI de MCP a través de Poetry:

# 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

Después de la instalación, el servicio estará disponible en Claude Desktop y se ejecutará utilizando Poetry para una gestión adecuada de las dependencias.

Puntos finales de API

Chequeo de salud

GET /health - Verifica el estado de salud del servicio y el estado de inicialización de la 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" } }

Buscar vídeos

POST /search - Busca vídeos con hashtags
{ "search_terms": ["python", "coding"], "count": 30 // Optional, defaults to 30 }
La respuesta incluye URL de videos, descripciones y estadísticas de participación (vistas, me gusta, compartidos, comentarios).

Gestión de recursos

POST /cleanup : limpia recursos y sesiones de API

Manejo de errores

El servicio incluye un manejo integral de errores para:

Errores de inicialización de la API
Problemas de detección de bots
Errores de red
Limitación de velocidad
Términos de búsqueda no válidos

Desarrollo

Construido con:

API de TikTok
FastMCP
Poesía para la gestión de la dependencia
Dramaturgo para la automatización del navegador

Licencia

Instituto Tecnológico de Massachusetts (MIT)

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Proporciona una interfaz sólida para buscar videos de TikTok por hashtags y recuperar contenido de tendencia, con medidas antidetección y extracción integral de metadatos.

Integrations