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. It allows you to:
- Analyze TikTok videos to determine virality factors
- Retrieve content from TikTok videos
- Chat with TikTok videos
Available Tools
tiktok_available_subtitles
Description:
Looks up the available subtitle (content) for a TikTok video. Returns available subtitles in various languages and formats such as 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
).
tiktok_get_subtitle
Description:
Retrieves the subtitle (content) for a TikTok video. If no language code is provided, the tool will return the subtitle of automatic speech recognition.
Input Parameters:
tiktok_url
(required): TikTok video URL (e.g.,https://www.tiktok.com/@username/video/1234567890
).language_code
(optional): Language code for the subtitle (e.g.,en
for English).
tiktok_get_post_details
Description:
Returns the details of a TikTok post, including:
- Description
- Creator username
- Hashtags
- Engagement metrics (likes, shares, comments, views, bookmarks)
- Date of creation
- Video duration
Input Parameters:
tiktok_url
(required): TikTok video URL (e.g.,https://www.tiktok.com/@username/video/1234567890
).
Requirements
To use the TikTok MCP, you need:
- NodeJS v18 or higher
- Git
- TikNeuron Account and MCP API Key
Setup
-
Clone the repository:
git clone https://github.com/Seym0n/tiktok-mcp.git
-
Install dependencies:
npm install
-
Build the 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": "YOUR_API_KEY_HERE"
}
}
Replace path
with the path to TikTok MCP and YOUR_API_KEY_HERE
with your TikNeuron API Key. The updated mcpServers
section will look like this:
{
"mcpServers": {
"tiktok-mcp": {
"command": "node",
"args": [
"path/build/index.js"
],
"env": {
"TIKNEURON_MCP_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}