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

Related MCP server: TikTok Unauthorized API Scraper

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)