Douyin Messager | 抖音私信助手

核心用法

抖音私信自动化工具（douyin-messager）基于浏览器自动化技术，实现抖音网页版的私信发送与聊天记录获取功能。核心流程包括：打开抖音首页→等待加载→人工确认登录状态与弹窗→获取页面快照定位元素→点击私信按钮→选择目标用户→定位输入框→通过 type + submit 方式发送消息→截图确认发送成功。

显著优点

• 原生模拟操作：采用 type + submit 的浏览器原生交互方式，避免 JavaScript DOM 操作导致的中文乱码问题
• 结构化流程：提供详细的元素特征描述（如私信按钮、用户列表、输入框的识别特征），降低自动化定位失败率
• 问题诊断完善：针对 xdg-open 系统弹窗、ref 动态变化、消息不可见等常见问题提供明确解决方案
• 用户可控性强：关键步骤（登录确认、弹窗关闭）必须由用户人工确认，避免未经授权的操作

潜在缺点与局限性

• 强依赖人工干预：每次使用前需用户手动登录并关闭系统级弹窗，无法实现完全无人值守
• 平台反爬风险：抖音作为大型内容平台，具有完善的风控机制，频繁自动化操作可能触发账号限制或封禁
• 元素识别脆弱性：依赖文本内容和相对位置定位，抖音前端更新可能导致元素特征失效
• 环境限制：基于 Linux 系统的 xdg-open 弹窗问题目前无自动化解决方案
• 网络稳定性敏感：快照数据量大，弱网环境易超时

适合人群

• 需要批量发送抖音私信的内容创作者、运营人员
• 希望通过自动化回复提升客服效率的商家账号
• 有技术理解能力、能配合处理系统弹窗的用户

常规风险

• 账号安全风险：自动化行为可能违反抖音用户协议，导致私信功能限制或账号封禁
• 隐私合规风险：获取聊天记录涉及个人信息处理，需确保符合《个人信息保护法》要求
• 消息发送风险：自动化发送内容若被滥用（如垃圾信息），可能对接收方造成骚扰并引发平台处罚
• 技术稳定性风险：浏览器自动化依赖抖音网页版稳定性，功能可能随平台更新而中断

功能概述

douyin-messager 是一款通过浏览器 MCP（Model Context Protocol）自动化实现抖音私信功能的工具类 Skill。它允许用户在 Claude Code 环境中直接发送私信、回复消息及获取聊天记录，无需离开当前工作流。

核心用法

该 Skill 采用纯 Markdown 文档架构，依赖 browser MCP 工具完成所有操作。标准流程包括：打开抖音首页 → 等待加载 → 用户确认登录状态 → 获取页面快照定位 UI 元素 → 点击私信按钮 → 选择目标用户 → 发送消息（type + submit 方式）→ 截图确认。支持获取对方回复时通过 JavaScript evaluate 滚动聊天区域到底部。

显著优点

1. 工作流整合：在 AI 对话环境中直接完成抖音私信操作，避免多窗口切换
2. 操作规范清晰：文档详细定义了标准执行流程、UI 元素特征识别方式及错误处理方案
3. 安全机制明确：强制要求用户手动确认登录状态和系统弹窗处理，降低误操作风险
4. 问题诊断完善：提供完整的常见问题排查指南（乱码、超时、无响应等）

潜在局限

1. 依赖外部登录：必须用户提前在浏览器中登录抖音账号，AI 无法自动完成认证
2. 系统弹窗阻塞：Linux 系统的 xdg-open 弹窗无法被 AI 检测或操作，必须由用户手动关闭
3. UI 脆弱性：依赖 DOM 快照和 ref 定位，抖音页面结构更新可能导致功能失效
4. 来源可信度：T3 级别（个人开发者/社区项目），无企业背书

适合人群

• 抖音社群运营者需要批量或程序化发送私信
• 客服场景下需要快速回复用户消息
• 希望将社交媒体沟通整合到 AI 工作流的技术用户
• 熟悉浏览器自动化并接受手动确认步骤的用户

常规风险

• 账号风险：自动化操作可能触发抖音反垃圾机制，导致私信功能受限或账号处罚
• 隐私暴露：需登录个人账号，聊天记录通过 AI 环境处理
• 稳定性风险：页面结构变化、网络波动、快照数据量大导致的超时断网
• 操作中断：xdg-open 弹窗未及时处理会完全阻塞浏览器操作

安全认证

CLS-Certify v2.1.0 扫描结果：A 级（85 分）。无恶意代码、无提示词投毒、无数据外泄风险，唯一 evaluate 调用仅用于页面滚动操作。网络流量仅限 www.douyin.com 官方域名。