TikTok MCP Service
A Model Context Protocol service for TikTok video discovery and metadata extraction. This service provides a robust interface for searching TikTok videos by hashtags and retrieving trending content, with built-in anti-detection measures and error handling.
Features
- Search videos by hashtags
- Configurable video count per search (default: 30)
- Anti-bot detection measures
- Proxy support
- Automatic API session management
- Rate limiting and error handling
- Health status monitoring
Configuration
The service uses environment variables for configuration. Create a
.env file with:Installation and Setup
Claude Desktop Integration
Once your service is running, you can integrate it with Claude Desktop. Since we're using Poetry for dependency management, make sure to run the MCP CLI commands through Poetry:
After installation, the service will be available in Claude Desktop and will run using Poetry for proper dependency management.
API Endpoints
Health Check
GET /health- Check service health and API initialization status
Search Videos
POST /search- Search for videos with hashtagsResponse includes video URLs, descriptions, and engagement statistics (views, likes, shares, comments).
Resource Management
POST /cleanup- Clean up resources and API sessions
Error Handling
The service includes comprehensive error handling for:
- API initialization failures
- Bot detection issues
- Network errors
- Rate limiting
- Invalid search terms
Development
Built with:
- TikTokApi
- FastMCP
- Poetry for dependency management
- Playwright for browser automation
License
MIT
TikTok MCP Service
A Model Context Protocol service for TikTok video discovery and metadata extraction. This service provides a robust interface for searching TikTok videos by hashtags and retrieving trending content, with built-in anti-detection measures and error handling.
Features
- Search videos by hashtags
- Configurable video count per search (default: 30)
- Anti-bot detection measures
- Proxy support
- Automatic API session management
- Rate limiting and error handling
- Health status monitoring
Configuration
The service uses environment variables for configuration. Create a
.env file with:Installation and Setup
Claude Desktop Integration
Once your service is running, you can integrate it with Claude Desktop. Since we're using Poetry for dependency management, make sure to run the MCP CLI commands through Poetry:
After installation, the service will be available in Claude Desktop and will run using Poetry for proper dependency management.
API Endpoints
Health Check
GET /health- Check service health and API initialization status
Search Videos
POST /search- Search for videos with hashtagsResponse includes video URLs, descriptions, and engagement statistics (views, likes, shares, comments).
Resource Management
POST /cleanup- Clean up resources and API sessions
Error Handling
The service includes comprehensive error handling for:
- API initialization failures
- Bot detection issues
- Network errors
- Rate limiting
- Invalid search terms
Development
Built with:
- TikTokApi
- FastMCP
- Poetry for dependency management
- Playwright for browser automation
License
MIT