douyin-ops-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| API_KEY | No | 硅基流动 ASR key 的别名(等同 SILICONFLOW_API_KEY) | |
| DOUYIN_DATA | No | 数据根目录(profile/下载/队列/模型),默认为 <项目>/data | |
| DOUYIN_FFMPEG | No | ffmpeg 可执行文件路径,默认为 PATH 里的 ffmpeg | |
| DOUYIN_PYTHON | No | Python 可执行文件路径,默认为 PATH 里的 python | |
| DOUYIN_FFPROBE | No | ffprobe 可执行文件路径,默认为 PATH 里的 ffprobe | |
| DOUYIN_HEADLESS | No | `1` = 无头(不推荐,必被风控);默认为有头 | |
| DASHSCOPE_API_KEY | No | 阿里云百炼 qwen3-asr 的 API key | |
| DOUYIN_DOWNLOAD_DIR | No | 下载目录,默认为 <数据>/downloads | |
| SILICONFLOW_API_KEY | No | 硅基流动 ASR key,最快最便宜(也可用 API_KEY 变量) | |
| DOUYIN_WHISPER_MODEL | No | 本地 whisper 尺寸 tiny/base/small/medium/large-v3,默认 `small` | |
| DOUYIN_CHROME_CHANNEL | No | 浏览器通道:`chrome` / `msedge`,默认 `chrome` | |
| DOUYIN_CHROME_EXECUTABLE | No | 指定 Chrome 路径(覆盖 channel) | |
| DOUYIN_QUEUE_ALLOW_SUBMIT | No | `0` = 队列只填不点发布(人工确认),默认 `1` |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
抖音运营工具箱(个人自用工具,与抖音官方无关联;仅限运营使用者本人拥有或已获授权的账号与内容,禁止刷量/批量养号/绕过风控/大规模抓取,详见 DISCLAIMER.md)。免登录就能用:douyin_parse / douyin_download / douyin_transcribe / douyin_trending / douyin_user_profile / douyin_comments。发布与搜索需要登录:先 douyin_login_qrcode 扫码(登录态持久保存)。发布前一律先用 dryRun=true 出预览截图给用户确认,内容是否合规、是否侵权由使用者负责。
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| douyin_parseA | 把一个抖音分享链接、分享文案、裸作品 ID 或用户主页链接,解析成结构化数据:作品类型(视频/图文)、文案、话题、作者、互动数据、无水印播放地址、图集图片、背景音乐。不需要登录。批量粘贴多个链接时请逐个调用。 |
| douyin_downloadA | 下载一个抖音作品到本地:视频取无水印最高可用画质(优先 H.264),图集会下全部图片,可选连背景音乐一起下。已下过的会自动跳过(有 manifest 去重)。返回本地文件路径,可用于后续剪辑/发布。 |
| douyin_batch_downloadA | 批量下载:某个博主主页的全部/部分作品、关键词搜索命中的作品、或当前热点视频流。带 limit 与游标控制,自动去重、自动跳过已下载。适合做选题拆解、竞品分析、素材库。注意有频率风控,一次别拉太多(建议 limit ≤ 30)。 |
| douyin_user_profileA | 读一个抖音博主的公开资料(粉丝、作品数、简介、认证)以及最近的作品列表。做竞品/对标账号分析的第一步。 |
| douyin_searchA | 用关键词搜索抖音视频或用户。抖音只对已登录会话开放搜索,未登录会返回"请先登录"。用于找选题、找对标账号、找爆款结构。 |
| douyin_trendingA | 拿抖音热榜(总榜/娱乐/社会/挑战榜)和"热点视频"流(每条都带完整互动数据,可判断这个热点值不值得跟)。免登录,是每天选选题的第一站。 |
| douyin_commentsB | 读一条作品的评论区(含点赞数、作者回复标记、IP 属地、前 3 条二级回复)。用来抓用户真实需求、找选题、找可以互动的潜在客户。 |
| douyin_transcribeA | 把视频/音频里的口播转成文字(可带时间轴)。三级降级:硅基流动 SenseVoice(快、便宜)→ 阿里云百炼 qwen3-asr → 本地 faster-whisper(离线免费,首次要下模型)。用于拆解爆款口播结构、给自己拍的口播生成字幕稿。 |
| douyin_breakdownA | 把一条爆款作品拆成可以直接复用的结构包:互动数据(判断爆款类型)、前 3 秒钩子、口播的前中后三段结构、热门评论(用户的真实需求)、话题与音乐。做选题和模仿结构的第一步。会比 douyin_parse 慢(要下载+语音识别),只要数据就关掉 transcribe。 |
| douyin_local_checkA | 发布前自查:时长、分辨率、宽高比、是否有音轨、码率、大小,并给出问题清单。也能顺便抽一帧看画面。 |
| douyin_login_qrcodeA | 打开浏览器并抓取创作者中心的登录二维码(返回本地图片路径)。用户用抖音 App 扫码后登录态会持久保存在浏览器 profile 里,之后所有工具都不需要再登录。等待期间请让用户完成扫码。 |
| douyin_login_statusA | 检查抖音登录态:www(浏览/搜索/评论)与创作者中心(发布/数据)分别是否登录,已登录时返回账号资料。 |
| douyin_logoutA | 清掉浏览器 profile 里的所有抖音 cookie(换号或登录态异常时用)。 |
| douyin_publish_videoA | 把本地视频发布到抖音(走创作者中心真实上传流程):标题、正文、话题、自定义封面、定时发布。强烈建议先用 dryRun=true 走一遍:它会一路填到"发布按钮就在眼前"并截图,确认无误再 dryRun=false 真发。需要先 douyin_login_qrcode 登录。注意:发布内容的合规性(是否原创/是否侵权/是否符合平台规则)由使用者负责,只会发到使用者本人账号。 |
| douyin_publish_imagesB | 把一组本地图片发布成抖音图文(最多 35 张):标题(≤20 字)、正文、话题、定时发布。同样建议先 dryRun=true 预览截图。图片版权与内容合规由使用者负责。 |
| douyin_publish_preflightA | 不打开浏览器,先检查素材:文件是否存在、时长/分辨率/音轨/大小是否满足抖音要求、定时时间是否合法。 |
| douyin_video_statsA | 查自己某条作品在创作者中心的数据(播放/点赞/评论/分享)。作品不在第一页时会退回公开数据(播放量对非本人不公开)。 |
| douyin_my_videosA | 从创作者中心作品管理页读出我的作品列表,含每个作品的播放、点赞、评论、分享、状态。做复盘/找哪条该投流的第一手数据。 |
| douyin_account_overviewA | 账号层面的数据:粉丝总数、新增粉丝、播放量、获赞、主页访问、完播率等(从创作者中心首页/数据中心读)。 |
| douyin_comments_listA | 读任意作品评论(我的或别人的)。回复评论前先用它拿到评论 ID。 |
| douyin_comment_repliesB | 展开一条评论下的二级回复。 |
| douyin_comment_publishA | 在作品下发一条新评论,或者回复某条已有评论(给 commentId 就是回复)。这是真实对外发言(以使用者账号身份发出),注意语气与频率;一次别连发多条(容易被限流)。不要用于刷评论/导流。 |
| douyin_diggB | 给某条作品点赞或取消点赞(养号互动用,别刷)。 |
| douyin_notificationsA | 把我最近几条作品下的评论抓出来,标出哪些是别人发的、我还没回复的(按时间倒序)。抖音 Web 端没有可用的通知中心页面(/notice、/messages 都是 404),所以这里用"评论待回复"来替代通知——对运营来说这本来也是更该先处理的那部分。 |
| douyin_unread_countA | 待回复评论的条数(按作品分组)。这是"该去回评论了"的信号,用评论接口算出来的真实数字。 |
| douyin_queue_addA | 把一条准备好的内容排进定时发布队列(视频或图文)。到时间由队列守护进程(scripts/queue-daemon.js)或 douyin_queue_run 自动发布。适合"一次排一周内容"的运营节奏。 |
| douyin_queue_listB | 列出队列里所有内容与状态(pending/running/done/failed),看今天该发什么。 |
| douyin_queue_cancelB | 按 id 取消一条待发布内容。 |
| douyin_queue_runA | 立刻执行队列里所有到期(scheduleAt 已过或未设)的内容并发布。适合让 agent 定时调用(比如每 10 分钟一次);也可以直接跑 scripts/queue-daemon.js 常驻。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 29 tools
Several pairs have unclear boundaries: douyin_comments vs douyin_comments_list both read a work's comments, and douyin_local_check vs douyin_publish_preflight both validate local files (duration, resolution, audio, size) before publishing. douyin_notifications vs douyin_unread_count, douyin_parse vs douyin_breakdown (parse with optional transcription), and douyin_video_stats vs douyin_my_videos also overlap. Descriptions help somewhat, but an agent can easily pick the wrong twin.
All names are snake_case with a consistent douyin_ prefix, which is good. But the verb/noun ordering is mixed: publish_video / publish_images are verb_noun, while comment_publish and the queue_add/queue_list/queue_cancel family are noun_verb, and others are noun-only (trending, comments, breakdown, digg). Singluar/plural inconsistency between comments and comment_* adds to the confusion.
29 tools exceeds the comfortable 25-tool range, but the domain genuinely spans ingestion (parse/download), discovery (search/trending/profile), publishing (video/images/queue), analytics, comments, and login. Most tools earn their place; consolidating the duplicate pairs (comments/comments_list, local_check/preflight) would bring it to a healthy size.
Coverage is strong across the whole operational loop: parse/download, search/trending, login lifecycle, preflight + dryRun publishing, scheduling queue, analytics, and comment read/reply/publish. Gaps include no update/delete of published works and no follow/engagement actions beyond digg, but core workflows have no dead ends.