douyin-ops-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@douyin-ops-mcp parse this share link and download the video without watermark"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
抖音运营 MCP(douyin-ops-mcp)
⚠️ 使用前必读
本项目是跑在你自己电脑上的个人工具,与抖音/字节跳动无任何关联、未获授权。 它通过驱动你本机 Chrome 完成操作,等同于你本人操作,因此:
只能用于运营你本人拥有或已获授权的账号,发布你拥有权利的内容;
禁止用于刷量、批量养号、规避平台安全机制、大规模抓取或转售数据、以及任何违法违规用途;
自动化操作可能违反平台协议,存在限流、封号风险;发布前请务必
dryRun: true自行审核;登录 cookie 存在本机
data/(已 gitignore),请自行保管。完整条款见 DISCLAIMER.md(这不是法律意见,商业用途请咨询律师)。
仓库:https://github.com/kungful/douyin-ops-mcp · 配套 Pi 技能:~/.pi/agent/skills/douyin-ops
一个给 agent 用的抖音运营工具:采集解析 → 爆款拆解 → 内容排期 → 自动发布 → 数据复盘,全链路。
融合了四个上游项目各自的长处,但代码是重写的(因为它们的核心部分在国内网络下都跑不通或已经过时):
上游 | 它的长处 | 我们怎么用 |
十年踩坑攒下来的接口参数表、数据模型、无水印地址选择逻辑、a_bogus 签名的成因分析 | 端点/参数表、 | |
链接 → 视频 → 音频 → 文案 的 ASR 链路 | 文案提取做成三级降级(硅基流动 → 百炼 → 本地 faster-whisper) | |
采集/批量/导出的产品化思路(它是 Tauri 壳,功能在闭源发行版里) | 批量下载、去重清单、素材库这些运营侧的信息架构 | |
MCP 工具面的划分方式(登录/发布/搜索/详情/评论/通知),以及"登录态持久化"这套工程范式 | 工具命名与分组、扫码登录 + profile 复用、发布前 dryRun 预览的习惯 |
关键设计:为什么必须有浏览器
抖音 Web 的每个 /aweme/v1/web/* 请求都要带 a_bogus 签名,算法藏在字节码 VM 里(bdms.js),
而且站点自己已经给 fetch 打了补丁:任何从抖音页面上下文里发出的 /aweme/v1/web/* 请求,
a_bogus、msToken、指纹 cookie 全都会自动补齐。
所以本项目的接口调用方式是——在真实 Chrome 的抖音标签页里 page.evaluate(fetch(...)):
✅ 免登录:作品详情、用户资料、作品列表、评论、热榜、热点视频流
❌ 需要登录:搜索、发布、我的作品数据、评论/通知、点赞评论等写操作代价是必须有浏览器;好处是签名规则变了不用跟(上游那个项目为此维护了 4000 行签名代码, 还需要 cookie 池 + 代理池)。而"运营账号"本来就得登录浏览器,所以这个代价是白送的。
Related MCP server: Caelario MCP
快速开始
cd "C:\Users\hua\Documents\备份代码\douyin-mcp-fusion"
npm install # 只依赖 playwright-core,用系统 Chrome,不下载浏览器
npm run smoke # 自检:热榜/解析/评论/登录态(会弹一次 Chrome 窗口)
npm run smoke -- --full # 再跑下载 + 文案提取注册到 pi(已写入 ~/.pi/agent/mcp.json)后,在 pi 里执行 /reload 即可看到 29 个工具。
首次使用先登录一次(登录态存进 data/browser-profile,之后不用再扫):
douyin_login_qrcode({ waitSeconds: 120 }) # 抓二维码 → 用户用抖音 App 扫码
douyin_login_status({}) # 确认 www / 创作者中心 都登录了工具清单(29 个)
采集 · 免登录
工具 | 干什么 |
| 分享链接/文案/ID/主页 → 结构化作品(无水印地址、图集、话题、音乐、互动数据) |
| 下一条作品(视频取最高可用 H.264、图集全下、可选 BGM),带去重清单 |
| 批量:博主主页 / 关键词搜索 / 热点视频流,带游标与限速 |
| 博主资料 + 作品列表(对标账号分析) |
| 热榜(总榜/娱乐/社会/挑战)+ 热点视频流(带数据的选题池) |
| 作品评论(点赞数、IP 属地、作者是否回复、二级回复) |
| 视频转文案:硅基流动 → 百炼 → 本地 faster-whisper 三级降级 |
| 爆款拆解:数据定性 + 前 3 秒钩子 + 口播前中后三段 + 热评需求 |
| 发布前自查:时长/分辨率/宽高比/音轨/大小 |
登录 · 发布
工具 | 干什么 |
| 抓扫码登录二维码(base64 PNG + 文件),等扫码,登录态持久化 |
| 看登录态 / 清登录态(换号用) |
| 发布视频:标题、正文、话题、封面、定时;支持 dryRun 预览截图 |
| 发布图文(≤35 张) |
| 不开浏览器,先校验素材与定时参数 |
数据 · 互动
工具 | 干什么 |
| 我的作品列表 + 每条的播放/点赞/评论/分享(创作者中心真实数据) |
| 单条作品数据 |
| 账号概览:粉丝、新增、播放、获赞、主页访问、完播率 |
| 读评论 / 展开二级回复 |
| 发评论 / 回复评论 |
| 点赞 / 取消点赞 |
| 通知列表 / 未读数 |
排期 · 自动化
工具 | 干什么 |
| 把内容排进发布队列(含定时时间) |
| 看队列 / 取消 |
| 立刻执行到期任务(agent 定时调用即可) |
常驻发布:npm run queue(或双击 start-queue.cmd),每 30 秒检查一次队列,到点自动发。
一条完整的运营链路长这样
1) 选题 douyin_trending({board:'hot', videos:10})
→ 今天有什么在涨;挑 3 个和你赛道交叉的
2) 对标 douyin_search({keyword:'咖啡拉花'}) → douyin_breakdown({target: 爆款链接})
→ 搞清楚它为什么起:钩子句式、结构、热评里的真实需求
3) 采集 douyin_batch_download({source:'user', target:'竞品主页', limit:10})
→ 素材库;配 douyin_transcribe 拆口播
4) 创作 用 videostudio 技能剪片(或本地已有成片)
douyin_local_check({file}) → 规格过不了就别发了
5) 发布 douyin_publish_video({file, title, desc, topics, dryRun:true})
→ 看预览截图确认 → dryRun:false 真发
或者 douyin_queue_add 排进一周的档期
6) 复盘 douyin_my_videos({limit:20}) + douyin_account_overview({})
→ 哪条值得投流/切片;douyin_notifications 及时回评论环境变量
变量 | 作用 | 默认 |
| 数据根目录(profile/下载/队列/模型) |
|
| 下载目录 |
|
|
| 有头 |
|
|
|
| 指定 Chrome 路径(覆盖 channel) | — |
| 硅基流动 ASR,最快最便宜 | — |
| 阿里云百炼 qwen3-asr | — |
| 本地 whisper 尺寸 |
|
|
|
|
| 外部命令路径 | PATH 里的 |
没有 ASR key 也能用:会自动落到本地 faster-whisper(首次从 ModelScope 下模型,small 约 484MB)。
反爬与稳定性(踩过的坑)
无头浏览器必然吃滑块。默认有头;用户能看到 Chrome 窗口,需要过验证码时手动过一下,之后 profile 里就干净了。
命中验证码/登录墙/风控时,工具不会静默失败,而是返回带截图路径的明确提示(
BrowserBlockedError)。频率:批量采集每条间隔 1.2~2.7 秒随机;一次
limit建议 ≤30。version_code=290100是当前 Web 客户端版本,抖音大版本升级后可能需要更新src/douyin/params.js。公开接口的
play_count对别人的作品永远是 0(不是真 0 播放);真实播放量只有创作者中心有 → 用douyin_my_videos。
目录结构
src/
server.js MCP stdio 服务(手写 JSON-RPC,不依赖 SDK)
tools/index.js 29 个工具的定义与描述(描述是写给模型看的)
browser/manager.js 持久化 Chrome(唯一 profile)+ 页面池
browser/pagekit.js 导航、验证码/风控识别、多候选选择器点击填写
douyin/client.js ★ 页内 fetch(站点自动签名)+ 错误码语义
douyin/params.js 接口参数表
douyin/parse.js 链接/ID/主页 定位 + 详情/列表/搜索/热榜
douyin/normalize.js aweme/user/comment → 运营关心的字段
douyin/media.js 下载、ffmpeg 探针、抽帧、发布规格校验
douyin/asr.js ASR 三级降级
douyin/breakdown.js 爆款拆解
creator/login.js 扫码登录、登录态判定、会话预热
creator/publish.js 视频/图文发布(多候选选择器 + dryRun + 逐步报告)
creator/stats.js 我的作品 / 账号概览 / 单条数据
creator/interactions.js 评论、回复、点赞、通知
creator/scrape.js 创作者中心表格抓取与指标解析
store.js 队列 / 素材库 / 下载清单(原子写 JSON)
python/asr_whisper.py 本地 faster-whisper(ModelScope 下模型)
scripts/ smoke / protocol-test / login / queue-daemon实测记录(2026-10-31,账号「苏维埃」)
node scripts/test-suite.js all 的成绩:12/14 通过(报告在 data/test-report-all.md)。
能力 | 状态 | 备注 |
解析 / 下载 / 评论读 / 热榜 / 主页 / 热点流 | ✅ | 免登录 |
搜索视频 / 搜索用户 | ✅ | 需要登录;响应里的 |
我的作品列表 / 账号概览 / 单条数据 | ✅ | 创作者中心真实数据(播放、完播率、2秒跳出率、吸粉量) |
待回复评论(替代通知) | ✅ | 抖音 Web 通知中心已不存在(/notice、/messages 全 404),改用"评论待回复" |
扫码登录 + 登录态持久化 | ✅ | www 登录弹窗里的 base64 二维码 |
发布视频(标题+描述+话题) | ✅ | 已真发 |
发布图文(多图) | ✅ 预览 | dryRun 全流程通过(真发没跑,避免再留测试帖) |
定时发布 | ✅ | 时间输入框读回校验通过 |
发评论(UI 路径) | ✅ | 在作品页评论区输入并回车,读回验证通过 |
点赞 | ⚠️ | 同一颗心有时点得动有时不动(DOM 里只有 0×0 的隐藏副本),偶发 no-op |
自定义封面 | ❌ 已知限制 | 平台封面弹窗要求人工裁切/确认,自动点「完成」不生效;已做到"失败就关弹窗、不挡发布" |
踩过并已修掉的坑:
上传页是 React,
input[type=file]要等挂载完才出现(约 10s)。发布编辑页真实路径是
/content/post/video,不是/content/publish。标题要
.type()并读回inputValue();描述必须鼠标点进.zone-container再insertText(点 locator 不聚焦,第一版就这么发出去一条空描述)。图文必须先点「发布图文」切模式,否则拿到的是只收
video/*的单文件 input。话题走页面
#添加话题→ 输入 → 点联想项,并读回校验。页面
innerText里常驻"上传中"文案,不能拿来判断上传状态;要用发布按钮状态 + 预览视频 duration。点完发布 ≠ 发完:抖音先提交再后台上传(右下角百分比),上传没走完关浏览器就断了。
定时发布是
<label><input type=checkbox><span>定时发布</span></label>的自定义单选,getByText().click()会被 span 拦截超时,只能label.click()。抖音大量
data-e2e节点是 0×0 的隐藏副本:waitForSelector默认等 visible 会一直超时,必须state:'attached'。封面弹窗装不下 Esc / 取消,只有右上角那颗 svg X 能关;关不掉会挡住"发布"按钮。
Web 写接口(comment/publish、commit/item/digg)直接被风控:
status_code=8/4,所以互动走 UI。连续高频操作会被限流(页面 30s 渲染不出内容)——测试的时候要把节奏放慢。
已知限制
创作者中心改版后选择器会失效。第一次发请务必
dryRun: true看截图;失败时返回的steps会指出卡在哪一步,改那一步的选择器即可。自定义封面不可用(平台要人工裁切):建议不传
cover,用平台自动封面;工具会在失败时自动关掉弹窗,不影响发布。点赞偶发 no-op:页面只暴露 0×0 的隐藏节点,点了没反应时重试一次即可;批量养号别指望它。
抖音会限流连续高频操作(页面 30s 渲染不出来),批量采集/互动要放慢节奏。
创作者中心的表格结构随版本变化,
douyin_my_videos解析不到时会退回返回页面文本,供人工定位。只支持抖音(中国区),不含 TikTok。
不做刷量、不做多账号矩阵(同一 profile 只能登一个号;多号就复制一份 data 目录并改
DOUYIN_DATA)。
许可
代码许可:MIT(见 LICENSE)
使用边界与免责:DISCLAIMER.md —— 请在使用前读一遍
第三方组件与知识来源的完整清单:NOTICE
致谢
本项目代码为自研。接口参数/数据结构的知识来源见上表(上游均为 Apache-2.0,只借鉴了参数名、
数据字段和工程判断,没有拷贝其代码)。a_bogus 的成因分析出自上游 docs/design/17-signature-reversing.md —
但本项目没有实现签名算法,用的是"在页面里让站点自己签"这条更稳的路。
Available Tools
29 toolsdouyin_account_overviewA
账号层面的数据:粉丝总数、新增粉丝、播放量、获赞、主页访问、完播率等(从创作者中心首页/数据中心读)。
Inputs: no named parameters.
douyin_batch_downloadA
批量下载:某个博主主页的全部/部分作品、关键词搜索命中的作品、或当前热点视频流。带 limit 与游标控制,自动去重、自动跳过已下载。适合做选题拆解、竞品分析、素材库。注意有频率风控,一次别拉太多(建议 limit ≤ 30)。
Inputs: limit (required), source (required), dir, music, +2 more.
douyin_breakdownA
把一条爆款作品拆成可以直接复用的结构包:互动数据(判断爆款类型)、前 3 秒钩子、口播的前中后三段结构、热门评论(用户的真实需求)、话题与音乐。做选题和模仿结构的第一步。会比 douyin_parse 慢(要下载+语音识别),只要数据就关掉 transcribe。
Inputs: target (required), engine, comments, transcribe.
douyin_comment_publishA
在作品下发一条新评论,或者回复某条已有评论(给 commentId 就是回复)。这是真实对外发言(以使用者账号身份发出),注意语气与频率;一次别连发多条(容易被限流)。不要用于刷评论/导流。
Inputs: text (required), awemeId (required), commentId.
douyin_comment_repliesB
展开一条评论下的二级回复。
Inputs: awemeId (required), commentId (required), count.
douyin_commentsB
读一条作品的评论区(含点赞数、作者回复标记、IP 属地、前 3 条二级回复)。用来抓用户真实需求、找选题、找可以互动的潜在客户。
Inputs: target (required), count, cursor.
douyin_comments_listA
读任意作品评论(我的或别人的)。回复评论前先用它拿到评论 ID。
Inputs: target (required), count, cursor.
douyin_diggB
给某条作品点赞或取消点赞(养号互动用,别刷)。
Inputs: awemeId (required), unlike.
douyin_downloadA
下载一个抖音作品到本地:视频取无水印最高可用画质(优先 H.264),图集会下全部图片,可选连背景音乐一起下。已下过的会自动跳过(有 manifest 去重)。返回本地文件路径,可用于后续剪辑/发布。
Inputs: target (required), dir, raw, music.
douyin_local_checkA
发布前自查:时长、分辨率、宽高比、是否有音轨、码率、大小,并给出问题清单。也能顺便抽一帧看画面。
Inputs: file (required), frameAt.
douyin_login_qrcodeA
打开浏览器并抓取创作者中心的登录二维码(返回本地图片路径)。用户用抖音 App 扫码后登录态会持久保存在浏览器 profile 里,之后所有工具都不需要再登录。等待期间请让用户完成扫码。
Inputs: waitSeconds.
douyin_login_statusA
检查抖音登录态:www(浏览/搜索/评论)与创作者中心(发布/数据)分别是否登录,已登录时返回账号资料。
Inputs: no named parameters.
douyin_logoutA
清掉浏览器 profile 里的所有抖音 cookie(换号或登录态异常时用)。
Inputs: no named parameters.
douyin_my_videosA
从创作者中心作品管理页读出我的作品列表,含每个作品的播放、点赞、评论、分享、状态。做复盘/找哪条该投流的第一手数据。
Inputs: limit.
douyin_notificationsA
把我最近几条作品下的评论抓出来,标出哪些是别人发的、我还没回复的(按时间倒序)。抖音 Web 端没有可用的通知中心页面(/notice、/messages 都是 404),所以这里用"评论待回复"来替代通知——对运营来说这本来也是更该先处理的那部分。
Inputs: limit, works.
douyin_parseA
把一个抖音分享链接、分享文案、裸作品 ID 或用户主页链接,解析成结构化数据:作品类型(视频/图文)、文案、话题、作者、互动数据、无水印播放地址、图集图片、背景音乐。不需要登录。批量粘贴多个链接时请逐个调用。
Inputs: target (required), raw.
douyin_publish_imagesB
把一组本地图片发布成抖音图文(最多 35 张):标题(≤20 字)、正文、话题、定时发布。同样建议先 dryRun=true 预览截图。图片版权与内容合规由使用者负责。
Inputs: files (required), desc, title, dryRun, +3 more.
douyin_publish_preflightA
不打开浏览器,先检查素材:文件是否存在、时长/分辨率/音轨/大小是否满足抖音要求、定时时间是否合法。
Inputs: kind (required), files (required), scheduleAt.
douyin_publish_videoA
把本地视频发布到抖音(走创作者中心真实上传流程):标题、正文、话题、自定义封面、定时发布。强烈建议先用 dryRun=true 走一遍:它会一路填到"发布按钮就在眼前"并截图,确认无误再 dryRun=false 真发。需要先 douyin_login_qrcode 登录。注意:发布内容的合规性(是否原创/是否侵权/是否符合平台规则)由使用者负责,只会发到使用者本人账号。
Inputs: file (required), desc, cover, title, +4 more.
douyin_queue_addA
把一条准备好的内容排进定时发布队列(视频或图文)。到时间由队列守护进程(scripts/queue-daemon.js)或 douyin_queue_run 自动发布。适合"一次排一周内容"的运营节奏。
Inputs: kind (required), files (required), desc, cover, +4 more.
douyin_queue_cancelB
按 id 取消一条待发布内容。
Inputs: id (required).
douyin_queue_listB
列出队列里所有内容与状态(pending/running/done/failed),看今天该发什么。
Inputs: status.
douyin_queue_runA
立刻执行队列里所有到期(scheduleAt 已过或未设)的内容并发布。适合让 agent 定时调用(比如每 10 分钟一次);也可以直接跑 scripts/queue-daemon.js 常驻。
Inputs: force.
douyin_searchA
用关键词搜索抖音视频或用户。抖音只对已登录会话开放搜索,未登录会返回"请先登录"。用于找选题、找对标账号、找爆款结构。
Inputs: keyword (required), sort, type, count, +1 more.
douyin_transcribeA
把视频/音频里的口播转成文字(可带时间轴)。三级降级:硅基流动 SenseVoice(快、便宜)→ 阿里云百炼 qwen3-asr → 本地 faster-whisper(离线免费,首次要下模型)。用于拆解爆款口播结构、给自己拍的口播生成字幕稿。
Inputs: target (required), engine, saveDir, segments.
douyin_trendingA
拿抖音热榜(总榜/娱乐/社会/挑战榜)和"热点视频"流(每条都带完整互动数据,可判断这个热点值不值得跟)。免登录,是每天选选题的第一站。
Inputs: board, videos.
douyin_unread_countA
待回复评论的条数(按作品分组)。这是"该去回评论了"的信号,用评论接口算出来的真实数字。
Inputs: works.
douyin_user_profileA
读一个抖音博主的公开资料(粉丝、作品数、简介、认证)以及最近的作品列表。做竞品/对标账号分析的第一步。
Inputs: target (required), posts.
douyin_video_statsA
查自己某条作品在创作者中心的数据(播放/点赞/评论/分享)。作品不在第一页时会退回公开数据(播放量对非本人不公开)。
Inputs: awemeId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Agent-first social media publishing, scheduling, analytics, and unified inbox API + 16-tool MCP server across 18 social platforms (X, LinkedIn, Instagram, YouTube, TikTok, Threads, Bluesky, Reddit, Telegram, Discord, Mastodon, Facebook, Pinterest).
Create, schedule, and publish social posts, manage accounts, and read analytics as MCP tools.
Hosted MCP with 91 agent tools: X, domains, SEO, Maps, Trends, Search, YouTube, TikTok, and more.
Schedule and publish social posts across 9 platforms (Instagram, LinkedIn, X, TikTok, Facebook, Threads, Pinterest, Bluesky, Mastodon) straight from Claude, ChatGPT, Cursor, or any MCP client. Create, edit, and reschedule posts, upload media, and pull account and post analytics, follower demographics, and best-time windows. 20 tools, free on every plan.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides unified access to social media data across nine networks (Instagram, TikTok, YouTube, etc.) through a set of MCP tools for profiles, posts, search, and comments, backed by the SocialBridge API.-
- AlicenseNot gradedqualityCmaintenanceEnables retrieval and management of social media data from Instagram, TikTok, YouTube, X, and Facebook through MCP tools, supporting extractions, search, discovery, batches, schedules, and saved results.71 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables AI-powered LinkedIn automation, including content generation, profile and company data extraction, connection requests, and post scraping through MCP tools.-
- FlicenseNot gradedqualityBmaintenanceEnables AI agents to collect and localize content from WeChat, Douyin, Kuaishou, Xiaohongshu, and Bilibili, with 47 MCP tools for fetching articles, parsing media, and managing a unified local content library.1-