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:

Instalación y configuración

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:

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

MIT# tiktok_mcp

Limitaciones de la API de TikTok

Aviso importante: TikTok ha implementado estrictas medidas anti-scraping que limitan el acceso a la API. Por lo tanto, este servicio ofrece las siguientes funciones:

1. Modo de datos simulados : Cuando TikTok bloquea el acceso a la API (como ocurre actualmente), el servicio proporciona resultados simulados realistas relevantes para los términos de búsqueda. Esto garantiza que la integración con Claude siga funcionando incluso cuando TikTok restrinja el acceso.

2. Intentos de acceso a la API : el servicio aún intenta usar primero la API de TikTok, pero rápidamente recurrirá a datos simulados si la API no está disponible o devuelve errores.

3. Transparencia : cuando se proporcionan datos simulados, esto se indica claramente en la respuesta a través del campo transformations , que incluye una nota que explica que se muestran resultados simulados.

Esta implementación garantiza que su servicio permanezca operativo a pesar de las medidas anti-scraping de TikTok.