1. 项目定位与用途
Social Push 是 Anthropic Skills 生态系统中的一个技能（Skill），专为 Claude Code AI 编程助手设计。其核心定位是作为浏览器自动化中间层，将用户自然语言指令（如"把这篇文章发到小红书"）转化为跨社交平台的发布操作。它不独立运行，必须依赖 Claude Code 环境和 agent-browser skill 提供底层能力，通过 Markdown 工作流配置文件定义各平台的具体发布步骤，实现"一句话发布内容"的体验。
项目档案插件 / 扩展
jihe520/social-push 插件：用途、安装与配置说明
jihe520/social-push：Social Push 是一个面向 Claude Code 的 AI 社交媒体自动化发布技能，基于 agent-browser 实现多平台内容一本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
Social Push 是一个面向 Claude Code 的 AI 社交媒体自动化发布技能，基于 agent-browser 实现多平台内容一键发布，具备自我进化能力和安全草稿机制。
中文项目介绍
Social Push 是一个专为 Claude Code 设计的 AI 社交媒体发布技能，旨在简化多平台内容分发流程。
它基于 agent-browser 实现浏览器自动化，通过解析交互引用（interaction refs）显著降低 token 消耗，相比传统 Playwright MCP 方案更快速高效。核心创新在于 Self-Evolution 自我进化能力，当社交平台页面改版时，工作流可自动检测并修复，无需人工维护硬编码选择器。
该技能适用于需要频繁将文章、推文等内容同步到小红书、X/Twitter、知乎、微博、微信公众号、掘金等平台的场景。采用 Markdown 文件作为工作流配置，添加新平台只需创建对应配置文件，实现配置即代码。安全设计上仅暂存草稿而不自动发布，由用户最终确认，同时支持可视化操作和登录状态持久化。
详细信息与使用说明
2. 解决的问题
主要解决三个问题：一是传统浏览器自动化脚本在页面改版时维护成本高，硬编码选择器容易失效；二是 Playwright MCP 方案 token 消耗大、运行速度慢；三是多平台发布需要重复编写脚本。Social Push 通过 agent-browser 的交互引用解析减少 token 使用，利用 Self-Evolution 能力自动修复工作流，并采用 Markdown 配置化方式使添加新平台变得简单，同时确保操作可视化且安全可控。
3. 适用场景
适用于内容创作者、社区运营者和技术博主需要将同一内容快速分发到多个社交平台的场景。特别适合：1）经常在微信公众号、掘金等平台发布技术文章的用户；2）需要将长文拆分为小红书图文或 X 推文的跨平台运营；3）希望避免维护复杂自动化脚本、适应网页频繁改版的长期需求；4）偏好通过自然语言与 AI 交互而非编写代码的用户。注意：所有操作需在 Claude Code 终端中执行，且依赖用户手动完成首次平台登录。
4. 安装方式
安装需按顺序执行以下步骤：1）确保已安装 Claude Code；2）全局安装 agent-browser：npm install -g agent-browser；3）安装 agent-browser skill：npx skills add https://github.com/vercel-labs/agent-browser --skill agent-browser；4）下载 Chromium：agent-browser install；5）安装 social-push skill：npx skills add jihe520/social-push。此外需在 Chrome 中启用远程调试（chrome://inspect/#remote-debugging），并建议使用自己常用的浏览器并手动完成首次登录以保存状态。
5. 使用方式
在 Claude Code 终端中直接输入 /social-push 命令启动，例如"/social-push 把这篇文章发到小红书"。AI 会引导完成剩余步骤：自动填充表单、上传图片、选择标签等。首次使用某平台时需手动登录并保存浏览器状态（使用 --state 或 --profile 参数），后续可自动复用。所有操作均在 headed 可视化模式下进行，用户可实时监控，且最终发布前需用户确认，不会自动提交。高级用户可通过修改 SKILL.md 的 Rules 部分自定义发布参数。
6. 实现特点与限制
实现上采用分层架构：Claude Code 作为指令入口，agent-browser 提供浏览器自动化能力，social-push skill 定义工作流逻辑。工作流以 Markdown 格式存储在 references/ 目录，每平台一个文件，描述交互步骤。Self-Evolution 机制通过对比预期与实际页面状态自动调整选择器。当前限制包括：仅支持已配置的平台（仓库中可见 7 个平台），依赖用户浏览器环境，且 Linux do 等小众平台可能需额外调试。扩展新平台需参考现有 references 文件格式创建 Markdown 工作流。
思维导图
social-push
核心文件
SKILL.md
README.md / README_EN.md
工作流配置
references/
依赖技能
agent-browser
关键特性
AI 驱动交互
Self-Evolution 自我进化
Markdown 即配置
安全草稿机制
可视化操作
常见问题
Social Push 是否需要独立运行？
否。Social Push 是 Claude Code 的技能（Skill），必须在 Claude Code 终端中通过 /social-push 命令触发，依赖已安装的 agent-browser skill 提供浏览器自动化能力，无法独立运行。
为什么使用 agent-browser 而不是 Playwright？
agent-browser 通过解析交互引用（interaction refs）显著减少 token 消耗，且在 bash 中使用 --help 参数能快速获取提示，运行速度更快。相比 Playwright MCP 方案，更适合 AI 驱动的长期维护场景，且 Self-Evolution 能力可自动适应页面改版。
添加新平台需要编写代码吗？
不需要。根据仓库说明，添加新平台只需在 references/ 目录下创建一个 Markdown 文件，按照现有工作流格式描述发布步骤即可，无需编写复杂脚本。这是"Markdown 即配置"设计理念的体现。
登录状态如何保存和复用？
推荐使用 --state 参数保存浏览器状态文件，一次登录后可永久复用。首次使用某平台时需手动登录并执行 agent-browser state save 命令保存状态。也可使用 --profile 参数指定浏览器用户数据目录，但可能存在兼容性问题。仓库建议使用自己常用的浏览器并手动完成初始化登录。
Social Push 会自动发布内容吗？
不会。根据安全设计原则，Social Push 仅自动完成表单填充、图片上传等操作并暂存草稿，最终发布需用户手动确认。所有操作在 headed 可视化模式下进行，用户可实时监控每一步，确保内容准确无误后再提交。