tiktok-mcp
by: Seym0n
Model Context Protocol (MCP) with TikTok integration
📌Overview
Purpose: The TikTok MCP aims to seamlessly integrate TikTok access into Claude AI and other applications, enabling advanced video analysis and interaction.
Overview: TikTok MCP allows users to analyze videos for virality factors, retrieve content, and even chat with videos. Through a series of tools, users can access subtitles, detailed post information, and more, enhancing their engagement with TikTok content.
Key Features:
-
tiktok_available_subtitles: This tool looks up available subtitles for a TikTok video, providing content options in various languages and formats. It helps users quickly check accessibility of video subtitles.
-
tiktok_get_subtitle: This feature retrieves the actual subtitle content for a TikTok video, offering customization for language preferences. It ensures users can engage with content in their desired language.
-
tiktok_get_post_details: This tool provides detailed insights into a TikTok post, including descriptions, creator information, engagement metrics, and video duration. It allows for comprehensive analysis of TikTok content.
TikTok MCP
The TikTok MCP integrates TikTok access into Claude AI and other apps via TikNeuron. This TikTok MCP allows you to:
- Analyze TikTok videos to determine virality factors
- Get content from TikTok videos
- Chat with TikTok videos
Available Tools
tiktok_available_subtitles
Description:
Looks up the available subtitles (content) for a TikTok video. Returns subtitles in different languages and formats like Automatic Speech Recognition, Machine Translation, or Creator Captions.
Input Parameters:
tiktok_url
(required): TikTok video URL, e.g., https://www.tiktok.com/@username/video/1234567890 or https://vm.tiktok.com/1234567890
tiktok_get_subtitle
Description:
Get the subtitle (content) for a TikTok video URL. If no language code is provided, returns the subtitle of automatic speech recognition.
Input Parameters:
tiktok_url
(required): TikTok video URLlanguage_code
(optional): Language code for the subtitle, e.g., en for English, es for Spanish, fr for French
tiktok_get_post_details
Description:
Get the details of a TikTok post, including:
- Description
- Creator username
- Hashtags
- Number of likes, shares, comments, views, and bookmarks
- Date of creation
- Duration of the video
Input Parameters:
tiktok_url
(required): TikTok video URL
Requirements
- NodeJS v18 or higher (https://nodejs.org/)
- Git (https://git-scm.com/)
- TikNeuron Account and MCP API Key (https://tikneuron.com/tools/tiktok-mcp)
Setup
-
Clone the repository
git clone https://github.com/Seym0n/tiktok-mcp.git
-
Install dependencies
npm install
-
Build project
npm run build
This creates the file build\index.js
Using in Claude AI
Add the following entry to mcpServers
:
"tiktok-mcp": {
"command": "node",
"args": [
"path\\build\\index.js"
],
"env": {
"TIKNEURON_MCP_API_KEY": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
}
Replace path
with the path to TikTok MCP and XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
with your TikNeuron API Key.
The mcpServers
configuration will look like this:
{
"mcpServers": {
"tiktok-mcp": {
"command": "node",
"args": [
"path\\build\\index.js"
],
"env": {
"TIKNEURON_MCP_API_KEY": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
}
}
}