TikTok MCP-сервис

Служба Model Context Protocol для обнаружения видео TikTok и извлечения метаданных. Эта служба предоставляет надежный интерфейс для поиска видео TikTok по хэштегам и получения трендового контента со встроенными мерами защиты от обнаружения и обработки ошибок.

Функции

• Поиск видео по хэштегам

• Настраиваемое количество видео на поиск (по умолчанию: 30)

• Меры по обнаружению антиботов

• Поддержка прокси

• Автоматическое управление сеансами API

• Ограничение скорости и обработка ошибок

• Мониторинг состояния здоровья

Конфигурация

Служба использует переменные среды для настройки. Создайте файл .env с:

Установка и настройка

Установка через Smithery

Чтобы автоматически установить TikTok Video Search для Claude Desktop через Smithery :

Установка вручную

Интеграция рабочего стола Клода

После запуска службы вы можете интегрировать ее с Claude Desktop. Поскольку мы используем Poetry для управления зависимостями, убедитесь, что команды MCP CLI выполняются через Poetry:

После установки служба будет доступна в 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

• Проблемы с обнаружением ботов

• Ошибки сети

• Ограничение скорости

• Неверные условия поиска

Разработка

Построено с:

• TikTokApi

• FastMCP

• Поэзия для управления зависимостью

• Playwright для автоматизации браузера

Лицензия

MIT# tiktok_mcp

Ограничения API TikTok

Важное уведомление: TikTok внедрил строгие меры по борьбе с парсингом, которые ограничивают доступ к API. В результате этот сервис предоставляет следующие функции:

1. Mock Data Mode : когда TikTok блокирует доступ к API (что в настоящее время и происходит), сервис предоставляет реалистично выглядящие смоделированные результаты, соответствующие поисковым запросам. Это гарантирует, что ваша интеграция Claude продолжит работать, даже если TikTok ограничит доступ.

2. Попытки доступа к API : сервис по-прежнему сначала пытается использовать API TikTok, но быстро возвращается к фиктивным данным, если API недоступен или возвращает ошибки.

3. Прозрачность : если предоставляются фиктивные данные, это четко указывается в ответе в поле transformations , которое включает примечание, поясняющее, что отображаются моделированные результаты.

Такая реализация гарантирует, что ваш сервис продолжит работать, несмотря на меры TikTok по борьбе с взломом.