x-automation
通过 CDP 协议让 AI 直接操控 X 账号的自动化 Skill
x-automation 是一款基于 Chrome DevTools Protocol(CDP)的 X 平台(原 Twitter)社区运营自动化 Skill,支持 Codex、Claude、Hermes、OpenClaw 等主流 AI 编码助手平台。通过 CDP 协议连接用户已登录 X 账号的浏览器,由 AI 判断相关度并执行发帖、回复、转推、评论等操作,全程支持干运行预览和源级验证,确保每一步操作可追溯可控制。
技能简介
x-automation 的核心思路是将 AI 的推理能力与 X 平台的交互能力解耦:AI 负责理解用户意图、判断内容相关度和生成回复文本,具体的浏览器操作则由确定性脚本通过 CDP 协议执行。这种架构让用户无需为 AI 提供 X 平台的 API Key,仅需一个已登录账号的浏览器连接即可。
核心能力
x-automation 提供以下核心能力:
第一,多来源内容收集。支持从 X 首页信息流和搜索结果两个维度收集候选内容,用户可配置关注话题倾向、包含/排除关键词和人工审核规则。
第二,AI 相关度判断与草稿生成。收集到候选内容后,AI 根据用户配置的焦点和决策策略判断每条内容的相关度,选择需要互动的目标并生成候选回复或原创内容。
第三,干运行预览与人工审批。所有操作在正式执行前都会先以干运行模式展示候选帖子、来源、选中理由和生成内容,用户确认后才执行实际发布,避免 AI 生成错误内容。
第四,多类型交互支持。支持回复、转推、引用推文、原创作帖和话题线程互动等多种操作类型,每种操作均在源推文下进行验证确认。
第五,多平台集成。安装时支持选择目标平台(Codex、Claude、Hermes、OpenClaw),自动安装到对应平台的 Skill 目录并配置依赖。
第六,可选 Telegram 通知。支持配置 Telegram Bot,在工作流执行过程中和完成后发送进度和状态通知,方便在移动端随时掌握运营动态。
安装配置
安装 x-automation 需要满足以下前置条件:
支持 CDP 的浏览器。需要一个已安装且支持 Chrome DevTools Protocol 的浏览器(如 Chrome、Edge)。
Remote Browser 服务。需要部署 remote-browser(https://remote-browser.dev)作为 CDP 代理服务,将本地或远程浏览器暴露为可访问的 CDP 端点。
Node.js 环境。Skill 运行依赖 Node.js,安装脚本会自动执行 npm install 安装依赖。
目标 AI 平台。至少安装以下平台之一:OpenAI Codex(桌面版)、Anthropic Claude(桌面版或 CLI)、Hermes 或 OpenClaw。
安装步骤如下:
第一步,克隆或下载 Skill 包。
git clone https://github.com/HuberTRoy/x-automation.git
第二步,运行安装脚本。
bash install.sh
安装脚本会交互式询问目标平台(codex / claude / hermes / openclaw),自动复制文件到对应平台的 Skill 目录,执行 npm install,然后清理临时文件。
第三步,首次运行时进行对话式配置。首次调用 Skill 时,AI 会依次询问:CDP 端点地址、账号关注话题、包含/排除关键词和人工审核信号、允许的操作类型和风险限制、是否启用 Telegram 通知及 Bot 凭证。
使用步骤
第一步,调用 Skill 并完成初始化配置。
在目标 AI 平台中自然语言调用 x-automation Skill,按提示完成对话式配置,Skill 会将设置写入本地运行时配置文件。
第二步,发起干运行收集候选。
请求示例:「用 X 社区自动化 Skill 收集我配置的焦点相关帖子,以干运行方式展示候选帖子和候选回复。」
Skill 会通过 CDP 连接浏览器,收集首页或搜索结果中的相关帖子,以干运行模式展示候选列表和 AI 生成的回复草稿。
第三步,审批干运行结果。
用户审查展示的候选帖子、选中理由和生成内容,确认无误后明确批准。
第四步,执行实际发布并验证。
用户批准后,Skill 通过 CDP 执行实际操作:发布回复、转推或原创帖子。每条操作均在对应源推文下进行验证,失败的操作会阻止后续流程并通知用户。
第五步,Telegram 状态通知。
配置了 Telegram 通知后,工作流各阶段进展和最终状态会实时推送到指定 Telegram 群组或联系人。
适用场景
x-automation 适用于以下典型场景:
个人品牌建设与社区参与。创业者、独立开发者和内容创作者通过 AI 自动追踪所在行业动态,对相关讨论进行有价值的回复,建立专业影响力。
产品用户支持自动化。SaaS 团队配置关键词监控,当 X 上出现产品相关问题时自动识别并发送预设的解决方案回复。
内容分发与再创作。将优质长文章或博客内容,通过 AI 改写为适合 X 平台的短推文或引用推文,在信息流中扩大传播。
竞争对手动态追踪。监控行业竞争者的 X 账号动态和用户反馈,收集有价值的洞察用于产品决策。
适用人群
需要在 X 平台进行社区运营但时间有限的独立开发者、内容创作者和创业者,以及希望借助 AI 规模化进行社交媒体运营的个人和小型团队。
工作原理
x-automation 的技术架构分为四层:用户交互层(自然语言请求)、AI 推理层(判断相关度、生成内容)、路由层(Skill 核心逻辑,解析配置、协调流程)和执行层(CDP 脚本,具体操作浏览器)。整个流程中,AI 推理与浏览器操作通过干运行机制解耦,用户始终保持最终审批权。
官方链接
GitHub 仓库:https://github.com/HuberTRoy/x-automation 在线文档(简体中文):https://github.com/HuberTRoy/x-automation/blob/main/README.zh-CN.md
评论与建议
登录 后参与评论或提建议