TikTok MCP-сервис

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

Функции

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

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

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

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

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

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

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

Related MCP server: rednote-agent

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

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

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

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

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

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

npx -y @smithery/cli install @terrylinhaochen/tiktok_mcp --client claude

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

# 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 Desktop. Поскольку мы используем Poetry для управления зависимостями, убедитесь, что команды MCP CLI выполняются через 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

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