tiktok-downloader-mcp
📱 TikTok Media Downloader & Analytics (CLI & MCP Server)
Универсальный набор для извлечения данных из 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
Флаг | Значения | По умолчанию | Описание |
|
| Обязательно | Имя пользователя профиля, URL профиля или прямой URL поста |
|
|
| Фильтр типов медиа для загрузки |
| - |
| Сокращение для |
| - |
| Сокращение для |
|
|
| Максимальное количество постов для получения |
|
|
| Целевая выходная директория на вашей системе |
| - | - | Показать справку |
🤖 Часть 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:
/mcp2. Claude Desktop
Добавьте в ваш claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%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
Инструмент | Назначение | Параметры | Пример на естественном языке |
| Извлекает URL медиа без водяных знаков, аудио и метрики без сохранения файлов. |
| "Извлеки изображения, аудио и количество просмотров из этой ссылки: https://www.tiktok.com/@user/photo/123" |
| Выводит список последних ID постов, дат загрузки и URL для профиля. |
| "Выведи последние 15 постов, опубликованных @username, с их датами." |
| Загружает один пост (фото или видео) в папку с датой и файлом |
| "Загрузи это TikTok-видео в HD в мою папку загрузок." |
| Массово загружает видео/фото в папки по датам и создаёт глобальный |
| "Загрузи все фото-карусели от @username и суммируй их вовлечённость." |
| Вычисляет общие показатели аккаунта, средние значения, уровень вовлечённости и лучшие посты без загрузки файлов. |
| "Проанализируй уровень вовлечённости и лучшие посты @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
Maintenance
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
- AlicenseCqualityDmaintenanceEnables access to TikTok data without watermarks, including trending users, hashtags, post analytics, user profiles, and download links for specific countries. Supports searching by username, user ID, or post links.10MIT
- AlicenseBquality-maintenanceA 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.122
- Flicense-qualityDmaintenanceEnables AI assistants to download TikTok videos without watermarks, analyze creator metrics and audience insights, track trending content and hashtags, and search videos, users, and sounds through RapidAPI integration.
- FlicenseBqualityCmaintenanceMCP 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
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…
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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