Douyin API New MCP Server

# Douyin Api New MCP Server English | [简体中文](./README.md) | [繁體中文](./README_ZH-TW.md) An MCP server for accessing Douyin Api New API. ## 🚀 Quick Start with EMCP Platform **[EMCP](https://sit-emcp.kaleido.guru)** is a powerful MCP server management platform that allows you to quickly use various MCP servers without manual configuration! ### Quick Start: 1. 🌐 Visit **[EMCP Platform](https://sit-emcp.kaleido.guru)** 2. 📝 Register and login 3. 🎯 Go to **MCP Marketplace** to browse all available MCP servers 4. 🔍 Search or find this server (`bach-douyin_api_new`) 5. 🎉 Click the **"Install MCP"** button 6. ✅ Done! You can now use it in your applications ### EMCP Platform Advantages: - ✨ **Zero Configuration**: No need to manually edit config files - 🎨 **Visual Management**: Easy-to-use GUI for managing all MCP servers - 🔐 **Secure & Reliable**: Centralized API key and authentication management - 🚀 **One-Click Install**: Rich selection of servers in MCP Marketplace - 📊 **Usage Statistics**: Real-time service call monitoring Visit **[EMCP Platform](https://sit-emcp.kaleido.guru)** now to start your MCP journey! --- ## Introduction This is an MCP server for accessing the Douyin Api New API. - **PyPI Package**: `bach-douyin_api_new` - **Version**: 1.0.0 - **Transport Protocol**: stdio ## 安装 ### 从 PyPI 安装: ```bash pip install bach-douyin_api_new ``` ### 从源码安装: ```bash pip install -e . ``` ## 运行 ### 方式 1: 使用 uvx（推荐，无需安装） ```bash # 运行（uvx 会自动安装并运行） uvx --from bach-douyin_api_new bach_douyin_api_new # 或指定版本 uvx --from bach-douyin_api_new@latest bach_douyin_api_new ``` ### 方式 2: 直接运行（开发模式） ```bash python server.py ``` ### 方式 3: 安装后作为命令运行 ```bash # 安装 pip install bach-douyin_api_new # 运行（命令名使用下划线） bach_douyin_api_new ``` ## Configuration ### API Authentication This API requires authentication. Please set environment variable: ```bash export API_KEY="your_api_key_here" ``` ### Environment Variables | Variable | Description | Required | |----------|-------------|----------| | `API_KEY` | API Key | Yes | | `PORT` | N/A | No | | `HOST` | N/A | No | ### Using with Cursor Edit Cursor MCP config file `~/.cursor/mcp.json`: ```json { "mcpServers": { "bach-douyin_api_new": { "command": "uvx", "args": ["--from", "bach-douyin_api_new", "bach_douyin_api_new"], "env": { "API_KEY": "your_api_key_here" } } } } ``` ### Using with Claude Desktop Edit Claude Desktop config file `claude_desktop_config.json`: ```json { "mcpServers": { "bach-douyin_api_new": { "command": "uvx", "args": ["--from", "bach-douyin_api_new", "bach_douyin_api_new"], "env": { "API_KEY": "your_api_key_here" } } } } ``` ## 可用工具 此服务器提供以下工具: ### `post` post **端点**: `POST /v1/social/douyin/app/user/post` --- ### `profile` profile **端点**: `POST /v1/social/douyin/app/user/profile` --- ### `info` info **端点**: `POST /v1/social/douyin/app/user/info` --- ### `follower` follower **端点**: `POST /v1/social/douyin/app/user/follower` --- ### `hotvideolist` hotvideolist **端点**: `POST /v1/social/douyin/web/search/hotvideolist` --- ### `susggestwords` susggestwords **端点**: `POST /v1/social/douyin/web/search/susggestwords` --- ### `single` single **端点**: `POST /v1/social/douyin/web/search/single` --- ### `item` item **端点**: `POST /v1/social/douyin/web/search/item` --- ### `sug` sug **端点**: `POST /v1/social/douyin/web/search/sug` --- ### `related` related **端点**: `POST /v1/social/douyin/web/aweme/related` --- ### `post_1` post **端点**: `POST /v1/social/douyin/web/aweme/post` --- ### `detailurl` detailUrl **端点**: `POST /v1/social/douyin/web/aweme/detailurl` --- ### `detail` detail **端点**: `POST /v1/social/douyin/web/aweme/detail` --- ### `poi` poi **端点**: `POST /v1/social/douyin/app/search/poi` --- ### `detailid` detailId **端点**: `POST /v1/social/douyin/app/aweme/detail_id` --- ### `channel` channel **端点**: `POST /v1/social/douyin/web/feed/channel` --- ### `list` list **端点**: `POST /v1/social/douyin/app/comment/list` --- ### `longvideometa` longVideoMeta **端点**: `GET /v1/social/douyin/web/other/long_video_meta` **参数**: - `episode_id_current` (string): Example value: - `album_id` (number): Example value: 7316087737772147251 - `aweme_id_current` (string): Example value: --- ### `hotlist` hotList **端点**: `POST /v1/social/douyin/web/search/live` --- ### `reply` reply **端点**: `POST /v1/social/douyin/app/comment/listreply` --- ### `discover` discover **端点**: `POST /v1/social/douyin/app/search/discover` --- ### `list_1` list **端点**: `POST /v1/social/douyin/app/mix/list` --- ### `getpcbanner` getPcBanner **端点**: `GET /v1/social/douyin/web/other/getPcBanner` --- ### `brandweeklylist` brandWeeklyList **端点**: `POST /v1/social/douyin/app/hot/brand_weekly_list` --- ### `single_1` single **端点**: `POST /v1/social/douyin/app/search/single` --- ### `seokeywordrelated` seoKeywordRelated **端点**: `GET /v1/social/douyin/web/other/seo_keyword_related` **参数**: - `id` (number): Example value: 6984256064577441061 --- ### `following` following **端点**: `POST /v1/social/douyin/app/user/following` --- ### `city` city **端点**: `GET /v1/social/douyin/app/poi/city` --- ### `aweme` aweme **端点**: `POST /v1/social/douyin/app/music/aweme` --- ### `webshorten` webShorten **端点**: `GET /v1/social/douyin/web/other/web_shorten` --- ### `emojilist` emojiList **端点**: `GET /v1/social/douyin/web/other/emoji_list` --- ### `chart` chart **端点**: `POST /v1/social/douyin/app/music/chart` --- ### `aweme_1` aweme **端点**: `POST /v1/social/douyin/app/challenge/aweme` --- ### `music` music **端点**: `POST /v1/social/douyin/app/search/music` --- ### `challenge` challenge **端点**: `POST /v1/social/douyin/app/search/challenge` --- ### `index` index **端点**: `GET /v1/social/douyin/app/feed/index` **参数**: - `max_cursor` (number): Example value: 0 --- ### `item_1` item **端点**: `POST /v1/social/douyin/app/search/item` --- ### `wallpaper` wallpaper **端点**: `POST /v1/social/douyin/web/feed/wallpaper` --- ### `brandbillboard` brandBillboard **端点**: `POST /v1/social/douyin/app/hot/brand_billboard` --- ### `mediumrelated` mediumRelated **端点**: `POST /v1/social/douyin/web/feed/medium_related` --- ### `nearby` nearby **端点**: `GET /v1/social/douyin/app/feed/nearby` **参数**: - `max_cursor` (number): Example value: 3 - `city` (number): Example value: 8616124 --- ### `tab` tab **端点**: `POST /v1/social/douyin/web/feed/tab` --- ### `lvideotheater` lvideoTheater **端点**: `POST /v1/social/douyin/web/feed/lvideo_theater` --- ### `follow` follow **端点**: `POST /v1/social/douyin/web/feed/follow` --- ### `detail_1` detail **端点**: `POST /v1/social/douyin/app/poi/detail` --- ### `detail_2` detail **端点**: `POST /v1/social/douyin/app/challenge/detail` --- ### `module` module **端点**: `POST /v1/social/douyin/web/feed/module` --- ### `searchlist` searchList **端点**: `GET /v1/social/douyin/app/hot/search_list` **参数**: - `detail_list` (number): Example value: 1 --- ### `appointlivelist` appointLiveList **端点**: `GET /v1/social/douyin/web/other/appoint_live_list` --- ### `queryaccounttype` queryAccountType **端点**: `GET /v1/social/douyin/web/other/query_account_type` **参数**: - `sec_user_id` (string): Example value: MS4wLjABAAAAIqOcUlkHRYn3R9QrxuXwCrQbarxTKLqYNDByv_hGbGU --- ### `aweme_2` aweme **端点**: `POST /v1/social/douyin/app/poi/aweme` --- ### `index_1` index **端点**: `POST /v1/social/douyin/app/shorten/index` --- ### `trans` trans **端点**: `POST /v1/social/douyin/app/schema/trans` --- ### `live` live **端点**: `POST /v1/social/douyin/app/search/live` --- ### `sug_1` sug **端点**: `GET /v1/social/douyin/app/search/sug` **参数**: - `keyword` (string): Example value: anime --- ### `poi_1` poi **端点**: `GET /v1/social/douyin/app/feed/poi` **参数**: - `id` (number): Example value: 6601124549775853572 - `cursor` (number): Example value: 0 - `count` (number): Example value: 10 --- ### `reply_1` reply **端点**: `POST /v1/social/douyin/web/comment/listreply` --- ### `list_2` list **端点**: `POST /v1/social/douyin/web/comment/list` --- ### `social` social **端点**: `POST /v1/social/douyin/web/search/social` --- ### `recommend` recommend **端点**: `POST /v1/social/douyin/web/mix/recommend` --- ### `detail_3` detail **端点**: `POST /v1/social/douyin/web/mix/detail` --- ### `list_3` list **端点**: `POST /v1/social/douyin/web/mix/list` --- ### `ab` ab **端点**: `POST /v1/social/douyin/web/search/ab` --- ### `aweme_3` aweme **端点**: `POST /v1/social/douyin/web/mix/aweme` --- ### `brandcategory` brandCategory **端点**: `GET /v1/social/douyin/app/hot/brand_category` --- ### `aweme_4` aweme **端点**: `POST /v1/social/douyin/web/music/aweme` --- ### `detail_4` detail **端点**: `POST /v1/social/douyin/web/user/detail` --- ### `favorite` favorite **端点**: `POST /v1/social/douyin/app/aweme/favorite` --- ### `detailurl_1` detailUrl **端点**: `POST /v1/social/douyin/app/aweme/detail_url` --- ### `searchvideolist` searchVideoList **端点**: `POST /v1/social/douyin/app/hot/search_video_list` --- ### `billboardaweme` billboardAweme **端点**: `GET /v1/social/douyin/app/hot/billboard_aweme` --- ### `detail_5` detail **端点**: `POST /v1/social/douyin/web/music/detail` --- ### `aweme_5` aweme **端点**: `POST /v1/social/douyin/app/mix/aweme` --- ### `self` self **端点**: `POST /v1/social/douyin/web/user/self` --- ### `index_2` index **端点**: `GET /v1/social/douyin/app/hashtag/index` **参数**: - `id` (number): Example value: 7023579918135008293 - `offset` (number): Example value: 0 - `limit` (number): Example value: 20 --- ### `detail_6` detail **端点**: `POST /v1/social/douyin/app/mix/detail` --- ### `detail_7` detail **端点**: `POST /v1/social/douyin/app/music/detail` --- ### `suggestwords` suggestWords **端点**: `GET /v1/social/douyin/app/search/suggest_words` **参数**: - `keyword` (string): Example value: anime - `business_id` (number): Example value: 30003 - `from_group_id` (string): Example value: --- ### `seoinnerlink` seoInnerLink **端点**: `GET /v1/social/douyin/web/other/seo_inner_link` --- ## Tech Stack - **Transport Protocol**: stdio - **HTTP Client**: httpx ## License MIT License - See [LICENSE](./LICENSE) file for details. ## Development This server is generated by [API-to-MCP](https://github.com/BACH-AI-Tools/api-to-mcp) tool. Version: 1.0.0