올인원 TikTok 추출 제품군: 터미널에서 독립형 CLI 도구(AI 불필요)로 직접 실행하거나, Model Context Protocol (MCP) 서버로 연결하여 AI 어시스턴트(Claude Code, Claude Desktop, Cursor, Windsurf, Antigravity)와 함께 사용할 수 있습니다.
TikTok HD 동영상(.mp4) 및 원본 품질의 워터마크 없는 사진 슬라이드쇼/캐러셀을 추출, 분석 및 대량 다운로드하며, 구조화된 날짜 폴더(YYYY-MM-DD_<id>)로 정리하고 포괄적인 계정 참여 분석을 제공합니다.
Related MCP server: TikTok MCP Server
⚡ 이중 실행: 터미널에서 npx로 직접 사용하거나 LLM과 함께 MCP 서버로 통합 가능.
🎥 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 엔드포인트를 사용하여 즉시 작동.
AI 어시스턴트나 설정 없이 터미널에서 다운로더를 실행할 수 있습니다.
# 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>모든 슬라이드를 최고 해상도로 다운로드하고 메타데이터를 저장합니다:
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워터마크 없는 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 metadatavm.tiktok.com)단축된 모바일 URL은 자동으로 해석됩니다:
npx tiktok-downloader-mcp "https://vm.tiktok.com/ZMhNxxxx/"프로필을 스캔하여 사진과 동영상을 모두 다운로드하고 총 계정 참여 분석을 계산합니다:
# 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독립형 동영상을 걸러내고 사진 슬라이드쇼/캐러셀만 다운로드합니다:
npx tiktok-downloader-mcp @username --media photos
# or:
npx tiktok-downloader-mcp @username --photos-only --max 30사진 슬라이드쇼를 걸러내고 HD MP4 동영상 게시물만 다운로드합니다:
npx tiktok-downloader-mcp @username --media videos
# or:
npx tiktok-downloader-mcp @username --videos-only --max 30파일을 저장할 위치를 지정합니다:
npx tiktok-downloader-mcp @username --out "/Users/me/Desktop/MyTikTokMedia"플래그 | 값 | 기본값 | 설명 |
|
| 필수 | 프로필 사용자명, 프로필 URL 또는 직접 게시물 URL |
|
|
| 다운로드할 미디어 유형 필터 |
| - |
|
|
| - |
|
|
|
|
| 가져올 최대 게시물 수 |
|
|
| 시스템의 대상 출력 디렉터리 |
| - | - | 도움말 메뉴 표시 |
서버를 AI 어시스턴트에 연결하여 LLM이 자연어를 통해 TikTok 콘텐츠를 추출, 분석 및 다운로드하도록 합니다.
# 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-mcpClaude Code 내에서 상태 확인:
/mcpclaude_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"]
}
}
}.cursor/mcp.json 또는 프로젝트 .mcp.json에 추가:
{
"mcpServers": {
"tiktok-downloader": {
"command": "npx",
"args": ["-y", "tiktok-downloader-mcp"]
}
}
}agy mcp add tiktok-downloader -- npx -y tiktok-downloader-mcp도구 | 목적 | 매개변수 | 자연어 예제 |
| 파일을 저장하지 않고 워터마크 없는 미디어 URL, 오디오 및 측정항목을 추출합니다. |
| "이 링크에서 이미지, 오디오 및 조회수를 추출해 줘: https://www.tiktok.com/@user/photo/123" |
| 프로필의 최근 게시물 ID, 업로드 날짜 및 URL을 나열합니다. |
| "@username이 게시한 최근 15개 게시물을 날짜와 함께 나열해 줘." |
| 단일 게시물(사진 또는 동영상)을 날짜 폴더에 |
| "이 TikTok 동영상을 내 다운로드 폴더에 HD로 다운로드해 줘." |
| 동영상/사진을 날짜 폴더에 대량 다운로드하고 전역 |
| "@username의 모든 사진 캐러셀을 다운로드하고 참여도를 요약해 줘." |
| 파일을 다운로드하지 않고 계정 총계, 평균, 참여율 및 최고 게시물을 계산합니다. |
| "@username의 참여율과 최고 성과 게시물을 분석해 줘." |
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"
}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.jsonA: 아니요. 모든 다운로드 및 메타데이터 추출은 공개 엔드포인트를 사용하여 로그인이나 세션 쿠키 없이 즉시 작동합니다.
A: 아니요. 다운로드된 모든 미디어 파일은 TikTok의 튀는 워터마크가 없는 깨끗한 원본 품질의 파일입니다.
A: 아니요. 도구는 디스크에 있는 파일 크기와 존재 여부를 확인합니다. 슬라이드나 동영상이 이미 다운로드된 경우 자동으로 건너뛰어 즉시 속도를 냅니다.
A: Node.js >= 18이 필요합니다. 프로필 스캔을 위해 yt-dlp가 권장됩니다(macOS에서는 brew install yt-dlp, 또는 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 --stdioMIT © abdouldotdev
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
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…
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