tweetytweets Skill 技能

技能简介

tweetytweets 是一款完全自主运营 X/Twitter 账号的 AI Agent 工具，让 Agent 在无人值守情况下每天自动研究行业新闻、按用户文风写推文、通过真实登录浏览器发布到 X，并对每条发布做"回读 profile 验证"确保真的发出来了。不需要 X API Key、不需要 $215/月的开发者账户、不需要付费爬虫，仅依赖 Python 3.10+ + websockets 一行依赖。这是给"想用 AI Agent 自动化运营 X 账号但被 API 配额卡住"用户准备的真正零成本方案，通过 Chrome DevTools Protocol 直接驱动真实浏览器，与真人操作无法区分。

核心能力

1. 零 API Key 真实发布：通过 Chrome DevTools Protocol 驱动真实登录的浏览器在 X composer 中输入推文并点击 Post，与真人发推无法被平台识别。
2. 每日新闻研究：自动从 Hacker News Algolia API、RSS 订阅、Reddit（6 个子版）和 X 搜索（8 个查询）拉取约 150 条候选新闻，按互动量和时效性排序。
3. 用户文风建模：Agent 会通过 Step 0 interview 采访用户，让用户提供 5-20 条历史最佳推文（理想 10 万+曝光），自动生成 voice_profile（长度分布、节奏特征、hook 风格、禁用词清单），每条新推文都按 voice profile 写。
4. 每条推文必带源链接：Agent 写推前会先打开实际文章核实论据，无法验证的论据直接丢弃；杜绝 hallucination 发推。
5. 空闲期零成本：cron 监控脚本每 10 分钟检查 due.py 输出 IDLE 时不调用大模型，仅当有 slot 到点时才启动 Agent run；空闲期不烧 token。
6. Profile 回读验证：发布后用 vision 模型读回 profile 截图核对文本和发布时间，不一致则告警，绝不静默失败。
7. 可自定义每日计划：支持多 slot（如 13:00、16:00 等），每个 slot 在时间窗内随机分钟发布，避免"机器人节奏"被识别。
8. 超 6 小时未发自动 retire：超过截止时间 6 小时的 draft 直接放弃，永不发"陈旧推文"。

安装配置

1. 环境要求：Python 3.10+、Chrome / Chromium / Edge 浏览器（自动检测）、一个能跑 shell 的 AI Agent（Claude Code / Hermes Agent / Cursor / Codex 等）。
2. 克隆与依赖安装：git clone tweetytweets && cd tweetytweets && pip install -r requirements.txt（仅依赖 websockets）。
3. 配置文件：复制 cp config.example.json config.json，填写 X handle 等必填项；可选 premium 字段会自动测量并保存。
4. 启动专用浏览器：python scripts/browser.py launch 打开一个独立 Chrome 窗口，仅在该窗口登录 X.com（用 username 登录，不要用 Google 登录以免建错账号）。
5. 测量账号字符上限：python scripts/post.py measure --save 自动测量本账号的真实字符限制并写入 config。

使用步骤

1. Step 0 关键步骤：让 Agent 读 SKILL.md 并采访用户，要求用户提供 5-20 条历史最佳推文（理想 10 万+曝光），运行 python scripts/voice_profile.py --in scratch/my_top_tweets.txt 生成 voice-profile.local.md。
2. 采集当日素材：python scripts/research.py collect --hours 36（默认 36 小时窗口）；可选 python scripts/research.py sources 查看每个 feed 健康度。
3. 生成每日草稿：Agent 阅读 swipe file 后为每个 slot 写一条推文（含 daily news roundup 计数）；运行 python scripts/due.py make-plan 创建空 slot，再用 python scripts/due.py fill --slot 13:00 --file scratch/x1.txt 填充。
4. 发布与验证：python scripts/post.py post --text-file scratch/x1.txt 发布；运行 python scripts/post.py verify 用 vision 模型读回 profile 确认。
5. 调度模式：推荐 Hermes Agent 两个 cron job——x-plan 每天 11:00（采集+写+填 slot）、x-autopost 每 10 分钟（due 时才调 Agent）；也支持 plain cron 模式。

适用场景

1. 独立开发者 / 创业者个人品牌自动化：每天自动发行业观察、产品更新、技术见解，节省 1-2 小时/天手动推文时间。
2. AI 公司官方账号运营：每天自动发 AI 产品动态、研究亮点，附带源链接确保信息准确。
3. 行业 KOL 副账号：在主账号由人工发布的同时，副账号由 Agent 自动发行业新闻评论。
4. 多账号矩阵管理：同一团队用同一份 voice profile 模板运营多个细分行业 X 账号。
5. 跨境电商品牌账号：自动发海外市场的产品评测、活动新闻。
6. 学术 / 研究机构账号：自动发新论文、行业会议摘要、研究进展。

适用人群

• 独立开发者与创业者（个人品牌运营）
• AI 公司内容运营 / 社区经理
• 行业 KOL 与分析师（多账号矩阵）
• 研究机构 / 学术机构对外传播
• 跨境电商品牌营销人员
• AI Agent 工程师（学习真实浏览器自动化发布）

工作原理

tweetytweets 由四个核心组件构成：1) research.py 跨平台聚合候选新闻，按互动量+时效性排序；2) Agent 根据 voice profile 写推文，强制要求每条 claim 必须 trace 到实际打开过的源文章；3) due.py 是调度中心，空闲时打印 byte-identical IDLE 让 cron 跳过；4) post.py 通过 Chrome DevTools Protocol 驱动真实浏览器在 X composer 中发推，发后用 shot --what profile 截图并用 vision 模型读回核对。voice profile 模块通过分析用户历史最佳推文提取 11 个维度的写作特征（长度、节奏、hook 形状、首 6 字模板等），每条新推都对照此 profile 写，确保输出风格与用户历史高曝光推文一致。

官方链接

• GitHub 仓库：https://github.com/vedantdhande04/tweetytweets
• 配置文件示例：仓库内 config.example.json
• 调度示例（Hermes / plain cron）：仓库内 examples/
• 许可证：MIT License