Skip to main content
Glama
abdouldotdev

tiktok-downloader-mcp

by abdouldotdev

📱 TikTok Media Downloader & Analytics (CLI & MCP Server)

npm version License: MIT

Универсальный набор для извлечения данных из TikTok: запускайте его прямо из терминала как автономный CLI-инструмент (без необходимости в ИИ) или подключайте как сервер Model Context Protocol (MCP) для ИИ-ассистентов (Claude Code, Claude Desktop, Cursor, Windsurf, Antigravity).

Извлекайте, анализируйте и массово загружайте HD-видео TikTok (.mp4) и фотослайд-шоу/карусели в оригинальном качестве без водяных знаков, организованные в структурированные папки по датам (YYYY-MM-DD_<id>) с комплексной аналитикой вовлечённости аккаунта.


📑 Содержание


Related MCP server: TikTok MCP Server

✨ Ключевые возможности

  • Двойной режим работы: используйте напрямую в терминале через npx или интегрируйте как MCP-сервер с LLM.

  • 🎥 HD-видео без водяных знаков: загружайте высококачественные файлы .mp4 с оригинальными обложками.

  • 📸 HD-фото без водяных знаков: извлекайте полноразмерные оригинальные фотографии и слайды каруселей.

  • 📁 Организация по датам: каждый пост сохраняется в папку YYYY-MM-DD_<id>/.

  • 📊 Богатая аналитика вовлечённости:

    • Всего просмотров (play_count)

    • Всего лайков (digg_count)

    • Всего комментариев (comment_count)

    • Всего репостов (share_count)

    • Всего добавлений в избранное / сохранений (collect_count)

    • Всего загрузок (download_count)

    • Средний уровень вовлечённости (%)

    • Лучшие посты (самые просматриваемые, самые лайкаемые, самые репостимые, самые комментируемые)

  • 📝 Двухуровневые JSON-сводки:

    • account_summary.json и account_activity.json в корневой папке аккаунта.

    • post.json и account_activity_recap.json внутри каждой папки с постом.

  • 🚀 Не требуется вход / куки: работает из коробки с публичными эндпоинтами TikTok.


🖥️ Часть 1: Использование автономного CLI (без ИИ)

Вы можете запускать загрузчик в терминале без какого-либо ИИ-ассистента или конфигурации.

Варианты установки и запуска

# Option A: One-liner via NPX (No installation needed)
npx tiktok-downloader-mcp <arguments>

# Option B: Global NPM install
npm install -g tiktok-downloader-mcp
tiktok-downloader-mcp <arguments>

# Option C: Local Git Clone
git clone https://github.com/abdouldotdev/tiktok-downloader-mcp.git
cd tiktok-downloader-mcp && npm install && npm run build
node dist/index.js <arguments>

Сценарий 1: Одиночное фотослайд-шоу

Загружает все слайды в полном разрешении и сохраняет метаданные:

npx tiktok-downloader-mcp "https://www.tiktok.com/@username/photo/7405928371928371234"

Созданная структура:

tiktok_downloads/
  └── username/
      └── 2026-08-16_7405928371928371234/
          ├── slide_01.jpg
          ├── slide_02.jpg
          ├── slide_03.jpg
          ├── cover.jpg
          └── post.json

Сценарий 2: Одиночное HD-видео (MP4)

Загружает HD-видео без водяного знака и его обложку:

npx tiktok-downloader-mcp "https://www.tiktok.com/@username/video/7106594312292453675"

Созданная структура:

tiktok_downloads/
  └── username/
      └── 2026-08-15_7106594312292453675/
          ├── video.mp4     # Clean HD video without watermark
          ├── cover.jpg     # Video thumbnail
          └── post.json     # Views, likes, comments, sound metadata

Сценарий 3: Короткие мобильные ссылки (vm.tiktok.com)

Сокращённые мобильные URL автоматически разрешаются:

npx tiktok-downloader-mcp "https://vm.tiktok.com/ZMhNxxxx/"

Сценарий 4: Массовая загрузка профиля (всё)

Сканирует профиль, загружает как фото, так и видео, и вычисляет общую аналитику вовлечённости аккаунта:

# Download recent 50 posts (default):
npx tiktok-downloader-mcp @username

# Download recent 20 posts:
npx tiktok-downloader-mcp @username --max 20

# Download ALL posts from the profile:
npx tiktok-downloader-mcp @username --max all

Сценарий 5: Массовая загрузка профиля — только фото

Отфильтровывает отдельные видео и загружает только фотослайд-шоу / карусели:

npx tiktok-downloader-mcp @username --media photos
# or:
npx tiktok-downloader-mcp @username --photos-only --max 30

Сценарий 6: Массовая загрузка профиля — только видео

Отфильтровывает фотослайд-шоу и загружает только HD MP4-видео:

npx tiktok-downloader-mcp @username --media videos
# or:
npx tiktok-downloader-mcp @username --videos-only --max 30

Сценарий 7: Пользовательская выходная директория

Укажите, куда сохранять файлы:

npx tiktok-downloader-mcp @username --out "/Users/me/Desktop/MyTikTokMedia"

Справочник флагов CLI

Флаг

Значения

По умолчанию

Описание

<target>

@username | url

Обязательно

Имя пользователя профиля, URL профиля или прямой URL поста

--media

all | photos | videos

all

Фильтр типов медиа для загрузки

--photos-only

-

false

Сокращение для --media photos

--videos-only

-

false

Сокращение для --media videos

--max

number | all

50

Максимальное количество постов для получения

--out

path

./tiktok_downloads

Целевая выходная директория на вашей системе

--help, -h

-

-

Показать справку


🤖 Часть 2: Настройка Model Context Protocol (MCP)

Подключите сервер к ИИ-ассистенту, чтобы LLM мог извлекать, анализировать и загружать контент TikTok по вашим командам на естественном языке.

Настройка MCP по платформам

1. Claude Code CLI (рекомендуется)

# Add via NPX:
claude mcp add tiktok-downloader -- npx -y tiktok-downloader-mcp

# Or directly from GitHub:
claude mcp add tiktok-downloader -- npx -y github:abdouldotdev/tiktok-downloader-mcp

Проверьте статус внутри Claude Code:

/mcp

2. Claude Desktop

Добавьте в ваш claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tiktok-downloader": {
      "command": "npx",
      "args": ["-y", "tiktok-downloader-mcp"]
    }
  }
}

3. Cursor и Windsurf

Добавьте в .cursor/mcp.json или .mcp.json проекта:

{
  "mcpServers": {
    "tiktok-downloader": {
      "command": "npx",
      "args": ["-y", "tiktok-downloader-mcp"]
    }
  }
}

4. Antigravity CLI

agy mcp add tiktok-downloader -- npx -y tiktok-downloader-mcp

Справочник инструментов MCP

Инструмент

Назначение

Параметры

Пример на естественном языке

tiktok_extract_post

Извлекает URL медиа без водяных знаков, аудио и метрики без сохранения файлов.

url (строка)

"Извлеки изображения, аудио и количество просмотров из этой ссылки: https://www.tiktok.com/@user/photo/123"

tiktok_get_user_posts

Выводит список последних ID постов, дат загрузки и URL для профиля.

username (строка), max (число)

"Выведи последние 15 постов, опубликованных @username, с их датами."

tiktok_download_post

Загружает один пост (фото или видео) в папку с датой и файлом post.json.

url (строка), output_dir (строка)

"Загрузи это TikTok-видео в HD в мою папку загрузок."

tiktok_download_user_media

Массово загружает видео/фото в папки по датам и создаёт глобальный account_summary.json.

username (строка), max (число), output_dir (строка), media_type ("all"|"photos"|"videos")

"Загрузи все фото-карусели от @username и суммируй их вовлечённость."

tiktok_get_user_analytics

Вычисляет общие показатели аккаунта, средние значения, уровень вовлечённости и лучшие посты без загрузки файлов.

username (строка), max (число)

"Проанализируй уровень вовлечённости и лучшие посты @username."


📊 Схемы метаданных и аналитики

1. account_summary.json (на уровне аккаунта)

Сохраняется в корне папки пользователя (tiktok_downloads/<username>/account_summary.json):

{
  "account": {
    "username": "example_user",
    "nickname": "Creator Name",
    "user_id": "7582772389835113485",
    "avatar": "https://.../avatar.jpeg",
    "profile_url": "https://www.tiktok.com/@example_user"
  },
  "activity_totals": {
    "total_posts_analyzed": 50,
    "total_slideshows_count": 32,
    "total_videos_count": 18,
    "total_images_count": 312,
    "total_views": 1066188,
    "total_likes": 17388,
    "total_comments": 6078,
    "total_shares": 410,
    "total_favorites_saves": 2579,
    "total_downloads": 74,
    "total_all_interactions": 26455
  },
  "performance_averages": {
    "avg_views_per_post": 21324,
    "avg_likes_per_post": 348,
    "avg_comments_per_post": 121.6,
    "avg_shares_per_post": 8.2,
    "avg_favorites_per_post": 51.6,
    "avg_engagement_rate_percent": 2.48
  },
  "top_performing_posts": {
    "most_viewed": { "id": "7652520719259159822", "date": "2026-06-18", "views": 461748, "type": "slideshow" },
    "most_liked": { "id": "7652520719259159822", "date": "2026-06-18", "likes": 5558, "type": "slideshow" }
  },
  "updated_at": "2026-08-18T15:57:52.024Z"
}

2. post.json (на уровне поста)

Сохраняется внутри каждой папки поста (tiktok_downloads/<username>/YYYY-MM-DD_<id>/post.json):

{
  "post_details": {
    "id": "7674774636999003406",
    "user": "example_user",
    "author": { "uniqueId": "example_user", "nickname": "Creator Name" },
    "title": "Summer outfit ideas #fashion #summer",
    "media_type": "slideshow",
    "date": "2026-08-16",
    "timestamp": 1787049600,
    "url": "https://www.tiktok.com/@example_user/video/7674774636999003406",
    "slides_count": 10,
    "stats": {
      "views": 1120,
      "likes": 21,
      "comments": 17,
      "shares": 1,
      "favorites": 5,
      "downloads": 0,
      "total_interactions": 44,
      "engagement_rate_percent": 3.93
    },
    "music": {
      "id": "7644346595656730640",
      "title": "Original Sound",
      "author": "Sound Creator",
      "duration": 60,
      "play_url": "https://.../audio.mp4"
    }
  },
  "account_recap": {
    "username": "example_user",
    "activity_totals": { "total_views": 1066188, "total_likes": 17388 },
    "performance_averages": { "avg_engagement_rate_percent": 2.48 }
  }
}

📁 Иерархия папок

tiktok_downloads/
  └── example_user/
      ├── account_summary.json            # Cumulative totals, averages, engagement & top posts
      ├── account_activity.json           # Complete chronological history of all posts
      │
      ├── 2026-08-16_7674774636999003406/ # 📸 Photo Slideshow post folder
      │   ├── slide_01.jpg
      │   ├── slide_02.jpg
      │   ├── slide_03.jpg
      │   ├── cover.jpg
      │   ├── post.json                   # Individual post metrics + global account recap
      │   └── account_activity_recap.json
      │
      └── 2026-08-15_7674392602606619917/ # 🎬 Video post folder
          ├── video.mp4                   # HD unwatermarked video
          ├── cover.jpg                   # Video cover thumbnail
          ├── post.json
          └── account_activity_recap.json

❓ Часто задаваемые вопросы и устранение неполадок

В: Нужна ли учётная запись TikTok или куки для использования?

О: Нет. Все загрузки и извлечение метаданных работают из коробки через публичные эндпоинты без необходимости входа или сессионных кук.

В: Содержат ли загруженные видео и изображения водяные знаки?

О: Нет. 100% загруженных медиафайлов — чистые файлы оригинального качества без прыгающего водяного знака TikTok.

В: Будет ли инструмент перезагружать уже существующие файлы при повторном запуске?

О: Нет. Инструмент проверяет размер файла и его наличие на диске. Если слайд или видео уже загружены, они автоматически пропускаются для мгновенной скорости.

В: Какие зависимости необходимы?

О: Node.js >= 18. Для сканирования профилей рекомендуется yt-dlp (brew install yt-dlp на macOS или pip install yt-dlp).


💻 Локальная разработка и вклад

# Clone repository
git clone https://github.com/abdouldotdev/tiktok-downloader-mcp.git
cd tiktok-downloader-mcp

# Install dependencies
npm install

# Compile TypeScript
npm run build

# Run CLI locally
node dist/index.js @username --max 10

# Run MCP Server on stdio
node dist/index.js --stdio

📄 Лицензия

MIT © abdouldotdev

Install Server
F
license - not found
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    B
    quality
    -
    maintenance
    A comprehensive MCP server that enables AI assistants to search, download, and analyze TikTok content while also performing active tasks like publishing videos and interacting with posts. It provides full automation capabilities for TikTok through browser session management and anti-detection features.
    12
    2
  • F
    license
    B
    quality
    C
    maintenance
    MCP server for TikTok that enables searching videos, users, hashtags, and fetching trending content, user profiles, and video details via official API or public scraping.
    8

View all related MCP servers

Related MCP Connectors

  • Download YouTube, TikTok, Vimeo, SoundCloud and 6 more platforms from any MCP AI chatbot.

  • MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.

  • A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/abdouldotdev/tiktok-downloader-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server