📚 自动化 全难度 📦 community

x-post-publisher

从 Claude/Codex 到 X 平台的内容发布自动化。

7.8 /10 ★★★★☆
#免费#自动化#编程
📄 相关文章

📊 评分明细

📦 打包完整度
2 2 / 2.5
🎯 实用性
2 2 / 2.5
📖 文档清晰度
1.6 1.6 / 2
👥 社区影响力
1.2 1.2 / 1.5
🔗 集成度
1.2 1.2 / 1.5

🎯 适用场景

免费自动化编程

x-post-publisher 快速入门

写完一段长文/代码片段,直接让 AI 顺手发到 X(原 Twitter),省得复制粘贴。

这是什么?解决什么问题?

做技术内容、个人 IP、独立开发者,常常会有这种场景:刚在 Claude/Codex 里产出的一段高质量内容,想立刻分享到 X。传统做法:复制 → 打开 X → 粘贴 → 改格式 → 配图 → 发布,流程割裂,容易打断”心流”。 x-post-publisher 是 awesome-agent-skills 仓库下的自动化 Skill,核心思路是让 AI 在产出内容后,通过 X 平台 API + 凭据,直接把”适合 X 长度”的内容发布出去。它内部有几个关键动作:

  • 自动把长内容裁剪成 ≤ 280 字符的多条 thread(可选);
  • 自动加 hashtag、@ 提及;
  • 失败重试 + 速率限制保护;
  • 草稿模式(“先生成,不真发”),让你人工 review 再点确认。 适合:日更技术博主、独立开发者 ship-log、社交媒体运营。

准备工作

  • 一个 X 开发者账号,申请了 API v2 的”读写”权限(基础套餐即可)
  • 准备好 API Key、API Secret、Access Token、Access Token Secret 四个值
  • 一个支持 SKILL.md 的 agent
  • Python ≥ 3.10(用于跑 SDK)
  • 可选:一个云函数/Serverless,做”定时发布”用

3 步快速上手

第 1 步:克隆与软链

git clone https://github.com/JackyST0/awesome-agent-skills.git
ln -sf "$(pwd)/awesome-agent-skills/skills/x-post-publisher" \
~/.claude/skills/x-post-publisher

第 2 步:把 X 凭据放进环境变量

export X_API_KEY="..."
export X_API_SECRET="..."
export X_ACCESS_TOKEN="..."
export X_ACCESS_SECRET="..."

echo $X_API_KEY 能正常输出表示就位。注意:别提交到 git,建议放 .env 配 .gitignore。

第 3 步:让 AI 帮你发第一条 X

在 agent 对话里说:

用 x-post-publisher 帮我发一条 X,
内容是:我们今天开源了一个 ClickHouse 写入模式 Skill,
地址 https://github.com/...,欢迎试用。
用 dry-run 模式先给我看。

AI 会先调用 Skill,产出 1-2 条候选推文(可能自动加 1-2 个 hashtag),你确认后改 prompt:

确认,正式发布。

AI 调用 API 发布,返回 tweet_id,你点开 X 链接就能看到。

常见踩坑

  1. X 开发者账号没批”读写”权限:基础开发者账号只允许”读”,要在开发者后台的”User authentication settings”勾上 Read and Write。
  2. 凭据填反了行/列:X 的 4 个值顺序容易混,Skill 应该会校验,但如果你在 .env 里顺序不一致,会直接 401。
  3. 内容超过 280 字符没自动 thread:默认 Skill 是”单条发送”,超长会失败,明确说”切分成 thread”才会自动拆。
  4. 限流(429)没处理:免费版 X API 一小时只能发 50 条左右,Skill 内部应该带 backoff,但如果短时间内连发会触发,留意错误信息。
  5. 重复内容被 X 判定 spam:X 对”几乎完全相同”的连续推文敏感,如果你连续发”今天我们发布了 X”,会限流或影子封禁,加一些变量。
  6. 没看草稿就发:千万别跳过 dry-run 模式,AI 自动生成的措辞不一定符合你的语气,先看再发。

初级用法

  • ship-log 自动化:每次 git tag 发布,触发一个 webhook → 让 Skill 生成 ship-log X 帖 → 人工一键发。
  • 每日一帖:把”今天学到的 X 知识”丢给 Skill,自动润色成 280 字符内的 X 帖,加入待发队列。

高级玩法

  • 接飞书/钉钉审核流:发布前先推给企业群,@ 主编确认,确认后再让 Skill 真发,做内容风控。
  • 多账号矩阵:把凭据做成字典,Skill 支持”按账号轮询”,可以同时管理 3-5 个账号,降低单账号限流风险。
  • A/B 测文案:发同一条主题的两版文案,Skill 自动对照 24 小时后的点赞/转评数据,挑优的继续推类似内容。

小技巧

  • 把”我的语气示例”(3-5 条历史 X 帖)放进 SKILL.md 的 style 段,AI 学得更快。
  • 高频词标签最多 2 个,多了 X 算法会降权。
  • 周三、周四上午 9-11 点是技术圈 X 互动高峰,定时发布挑这个窗口。
  • 配图用 16:9(1200x675)效果最好,Skill 如果没自动加图,手动用 media_ids 字段补。
  • 注意 X 的”敏感词”在某些地区会限流,发完看一下”分析”页,impressions 异常低就要改措辞。

参考链接

x-post-publisher Skill 多维度简评

类别：沟通写作 来源：Upload-Post / 社区贡献 定位：通过 Claude Code 自动发布内容到 X（Twitter），含 AI 配图和最佳发布时间优化。

说明：本文基于官方文档和公开资料整理，未经 MagicNetWorld 实测。

一、核心定位与价值

x-post-publisher 是一个面向开发者营销和个人品牌建设的 Skill。它使 Claude Code 能够通过 X（Twitter）API 自动发布推文，适合 build-in-public 场景。

根据社区信息，目前实现 X 自动化发布的主要方案包括：

  • Upload-Post Skill：支持文字推文、图片推文、视频推文、自动线程拆分
  • Twitter MCP Server：通过 Model Context Protocol 与 X API 交互
  • Playwright 浏览器自动化：通过 webapp-testing Skill 模拟网页操作

二、核心能力清单

能力实现方式适用场景
X API v2 集成OAuth 1.0a / OAuth 2.0开发者营销、build-in-public
AI 配图生成结合 AI 图像生成产品发布、技术分享
发布时间优化基于受众活跃数据最大化曝光
线程自动拆分280 字限制自动断句长内容发布
数据分析追踪展示/互动/点击统计内容效果评估

三、典型使用场景

场景 1：发布产品更新

使用 x-post-publisher：我刚发布了一个新功能，帮我写一条 280 字以内的英文推文，
附上截图，用 #buildinpublic 标签。

场景 2：技术文章推广

使用 x-post-publisher：将这篇博客文章总结为 3 条推文线程，
第一条吸引眼球，第二条说核心观点，第三条 CTA 导向原文链接。

场景 3：链式调用

1. 用 content-creator 撰写技术文章
2. 用 x-post-publisher 将文章转化为推文线程
3. 定时发布到 X

四、技术实现

目前社区中主要的 X 自动化方案：

方案成熟度说明
Upload-Post Skill生产可用专门的 Claude Code Skill，支持文本/图片/视频推文
Twitter MCP可用社区开发的 MCP Server，通过 API 交互
Playwright 自动化实验性通过浏览器模拟操作，但受反爬限制

安装示例（Upload-Post）：

npx skills add Upload-Post/upload-post-skill

五、注意事项

  • X API 目前对免费层限制较严（每月 500 条推文），需要申请 Elevated Access
  • OAuth 2.0 认证流程需在 X Developer Portal 提前配置
  • 视频推文限制：MP4 格式、最大 512MB、最长 140 秒
  • 自动线程功能要求文本在自然句边界处断开

六、总结

核心价值：让开发者通过 Claude Code 终端直接发布 X 内容，减少上下文切换。

适用人群：独立开发者、技术博主、build-in-public 实践者。

参考资料

📊 评分与标签

评分说明

总分 7.8/10 · S_入选

📊 可观测社区指标（数据核验日期：2026-07-23）

  • 官方仓库与维护入口：JackyST0/awesome-agent-skills。GitHub API 核验时触发限流，未记录无法再次确认的 Stars/Forks 精确快照，避免用估算值替代事实。

📦 可安装性 1.9/2.5

  • 官方来源提供可复制的 Skill、MCP 或 Markdown 目录；安装前仍需按 README 配置宿主客户端、运行时和最小权限凭据。
  • 与 Anthropic Skills、OpenCode Skills 对比，本项遵循开放目录思路，但插件命令、脚本依赖和更新方式并不完全统一。

🎯 实用性 2.0/2.5

  • 从内容生成到 X 平台发布的自动化步骤；这里只确认官方材料明确描述的范围，未把未经实测的准确率、性能或生产收益计入评分。
  • 与 GitHub CLI、Zapier 等专用工具对比，Skill 更适合把操作步骤交给 Agent 复用，不能替代完整运行时、监控和人工验收。

📖 文档质量 1.5/2.0

  • README、技能目录或官方参考页可核对安装、能力和约束；未发现统一的端到端性能基准，因此采用保守文档分。
  • 与 Vercel Agent Skills、Obra Superpowers 对比，目标任务说明直接，但版本迁移、失败恢复和跨平台案例仍依赖上游维护。

👥 社区活跃 1.1/1.5

  • 仓库公开提交历史、Issue 与 Pull Request 入口可追踪维护；因 API 限流未写入易变精确计数，社区分不依据未经复核的热度数字。
  • 与 anthropics/skills、obra/superpowers 对比，具备公开协作入口，但不能据此推导响应时效、长期承诺或企业支持等级。

🔗 兼容性 1.3/1.5

  • 可在能够读取 Skills/MCP 指令并具备相应工具权限的 Agent 环境使用；API、Token、浏览器和本地工具链会形成额外约束。
  • 与 Claude Code、Codex、Cursor 的原生扩展对比，开放文件格式便于迁移，但触发、脚本执行和资源加载行为存在客户端差异。

评分依据可追溯至公开来源，每项分数均有明确理由和数据支撑。

🏷️ 标签说明

  • 免费: 公开来源可访问；外部服务费用不计入 Skill 本身。来源：官方来源
  • 自动化: 核心能力与“从内容生成到 X 平台发布的自动化步骤”直接对应。来源：官方来源
  • 编程: 官方材料显示其面向该使用方式。来源：官方来源

局限说明：本次为官方仓库与文档核验，未执行跨客户端、跨操作系统端到端基准测试；外部 API 配额、授权和价格可能变化，应以上游最新说明为准。

📋 来源与核验记录