social-publish-skills

内容来源:README.md(说明文档) · 原始地址 · 查看安装指南

原始内容

social-publish-skills

一站式社媒内容生产与发布工具集 · 从选题到分发,全链路 Agent 化

GitHub stars GitHub forks License: MIT Node Platform

覆盖 7 大主流平台 · 13 个可复用 Skill · 支持 Codex / Claude Code / OpenClaw


⭐ Star 增长曲线

---
config:
    xyChart:
        xAxis:
            label: "月份"
            showLine: true
        yAxis:
            label: "Stars"
        title: "Star 增长趋势"
---
xychart-beta
    title "Star Growth Trend"
    x-axis ["4月", "5月", "6月", "7月"]
    y-axis "Stars" 0 --> 10
    bar [3, 5, 7, 8]
    line [3, 5, 7, 8]

自 2026 年 4 月开源以来持续增长,感谢每一位 Star 支持 🙏


📖 目录


🎯 这是什么

social-publish-skills 是一个基于 TypeScript + Playwright 的社媒内容生产与发布工具集。它把两件事打包成 Agent 可调用的 Skill:

  1. 内容生产(新增)— 从选题、文案创作到发布运营的全流程提示词资产
  2. 平台发布(核心)— 在本机完成扫码登录、登录态校验、内容发布(短视频 + 图文)

设计理念:让 Agent 既能"写",也能"发"。一份内容,多平台分发,全链路自动化。

适合什么场景

  • ✅ 首次登录某个平台账号
  • ✅ 检查本机已有 cookie 是否仍然可用
  • ✅ 将一个视频发布到单个或多个平台
  • ✅ 自动将 Markdown / GitHub / 网页文章格式化后发布到公众号、知乎、百家号
  • ✅ 让 Agent 帮你从 0 到 1 创作爆款内容(选题→标题→正文→优化)
  • ✅ 拆解单条爆款视频/文案的可复用结构,抽象成创作模板
  • ✅ 建立个人/品牌 LLM 知识库(Karpathy LLM wiki 范式),让创作引用私有资料
  • ✅ 在自动化工作流中编排"创作 → 审核 → 发布"全链路

🌐 平台支持

平台 标识 视频 图文 状态
微信视频号 tencent 稳定
抖音 douyin 稳定
快手 kuaishou 稳定
小红书 xiaohongshu 稳定
微信公众号 wechatmp 稳定
知乎 zhihu 稳定
百家号 baijiahao 稳定
B 站 bilibili 暂不支持

🧩 Skill 能力矩阵

仓库中的 Skill 分两大类:内容生产(提示词资产,纯方法论)和平台发布(CLI 实现,可执行)。

内容生产

增长三件套(按获客链路分层,双向交叉路由)

Skill 定位 核心能力 状态
skills/growth-content-strategy/ 策略层 选题挖掘、账号定位、对标拆解、矩阵裂变 可用
skills/growth-content-writing/ 创作层 爆款标题、各平台正文、口播脚本、仿写改写 可用
skills/growth-content-ops/ 运营层 文案优化、爆款拆解、评论区互动、发布时间 可用

内容工具包 + 知识库(单点深挖 + 横切地基)

Skill 定位 核心能力 状态
skills/content-toolkit/ 单点工具 视频结构分析(钩子/铺垫/高潮/结尾)、竞品模式拆解、去 AI 味改写 可用
skills/personal-knowledge-wiki/ 知识地基 LLM wiki 范式私有资料库(品牌/行业/爆款/对标四类 Schema) 可用

平台发布

Skill 类型 CLI / 实现状态 状态
skills/tencent-upload/ 单平台视频发布 已实现:tencent check|login|upload ✅ 可用
skills/douyin-upload/ 单平台视频发布 已实现:douyin check|login|upload ✅ 可用
skills/kuaishou-upload/ 单平台视频发布 已实现:kuaishou check|login|upload ✅ 可用
skills/xiaohongshu-upload/ 单平台图文/视频发布 已实现:xiaohongshu check|login|upload-video|upload-note ✅ 可用
skills/wechatmp-article-upload/ 单平台图文发布 已实现:wechatmp check|login|publish ✅ 可用
skills/zhihu-article-upload/ 单平台图文发布 已实现:zhihu check|login|publish ✅ 可用
skills/baijiahao-article-upload/ 单平台图文发布 已实现:baijiahao check|login|publish ✅ 可用
skills/multi-platform-publish-orchestrator/ 多平台编排 已实现:orchestrate / verify-scan-login ✅ 可用
skills/douyin-upload-prompt/ 上传前文案补全 无独立 CLI,配合抖音上传使用 🔶 辅助可用
skills/bilibili-upload/ 单平台视频发布 未实现对应 CLI 子命令 ⛔ 占位

状态说明✅ 可用 = 仓库已有 src/platforms/*.tsnode dist/cli.js 子命令;🔶 辅助可用 = 非发布引擎,配合已实现平台使用;⛔ 占位 = 仅保留模板,不可执行。


🚀 快速开始

环境要求

  • Node.js >= 20
  • 本机可运行 Playwright Chromium

安装

首次使用,在仓库根目录执行:

npm install
npx playwright install chromium
npm run build

说明:仓库默认不提交 dist/,完成构建后才能使用 node dist/cli.js ...

三十秒上手

# 1. 登录账号(扫码在本机完成)
node dist/cli.js douyin login --account my_account

# 2. 检查登录态
node dist/cli.js douyin check --account my_account

# 3. 发布视频
node dist/cli.js douyin upload \
  --account my_account \
  --file /absolute/path/to/video.mp4 \
  --title "标题" \
  --tags "话题1,话题2"

🤖 在 Agent 中接入

本仓库既可手动使用,也可接入 CodexClaude CodeOpenClaw 等 Agent。

接入原则

  • 所有命令都在仓库根目录执行
  • 首次运行先完成 npm installnpx playwright install chromiumnpm run build
  • 发布视频使用绝对路径
  • 扫码登录必须在用户本机完成

Codex

先阅读 AGENTS.md,并在仓库根目录执行命令。
如果 dist/cli.js 不存在,先安装依赖、安装 chromium 并构建。
然后使用 node dist/cli.js 完成登录 / 检查 / 上传。

Claude Code

请先阅读 README.md 和 AGENTS.md。
所有 npm 和 node dist/cli.js 命令都在仓库根目录执行。
不要跳过登录,不要伪造 cookie,扫码步骤在本机完成。

OpenClaw

将本仓库的 skills/ 目录提供给 OpenClaw,让 Agent 按需读取对应平台的 SKILL.md。实际执行仍统一调用本仓库 CLI。

常见映射:

能力 Skill
内容创作(选题/文案/优化) skills/growth-content-strategy/growth-content-writing/growth-content-ops/
视频号发布 skills/tencent-upload/
抖音发布 skills/douyin-upload/
快手发布 skills/kuaishou-upload/
小红书发布 skills/xiaohongshu-upload/
公众号图文发布 skills/wechatmp-article-upload/
知乎文章发布 skills/zhihu-article-upload/
百家号文章发布 skills/baijiahao-article-upload/
多平台顺序发布 skills/multi-platform-publish-orchestrator/

更多安装和适配说明见 INSTALL.mdAGENTS.md


📋 使用流程

推荐按下面顺序使用。

1. 登录账号

首次使用某个平台,先扫码登录:

node dist/cli.js tencent login --account my_account
node dist/cli.js douyin login --account my_account
node dist/cli.js kuaishou login --account my_account
node dist/cli.js xiaohongshu login --account my_account
node dist/cli.js wechatmp login --account my_account
node dist/cli.js zhihu login --account my_account
node dist/cli.js baijiahao login --account my_account
  • --account 是你给账号起的别名
  • 同一平台下,不同别名会保存为不同的 cookie 文件

2. 检查登录态

node dist/cli.js <platform> check --account my_account

3. 发布单个平台

微信视频号

node dist/cli.js tencent upload \
  --account my_account \
  --file /absolute/path/to/video.mp4 \
  --title "标题" \
  --tags "标签1,标签2"

抖音

node dist/cli.js douyin upload \
  --account my_account \
  --file /absolute/path/to/video.mp4 \
  --title "标题" \
  --desc "描述" \
  --tags "话题1,话题2"

快手

node dist/cli.js kuaishou upload \
  --account my_account \
  --file /absolute/path/to/video.mp4 \
  --title "标题" \
  --desc "描述" \
  --tags "话题1,话题2"

小红书视频

node dist/cli.js xiaohongshu upload-video \
  --account my_account \
  --file /absolute/path/to/video.mp4 \
  --title "标题" \
  --desc "描述" \
  --tags "话题1,话题2"

小红书图文

node dist/cli.js xiaohongshu upload-note \
  --account my_account \
  --images /absolute/path/to/1.png /absolute/path/to/2.png \
  --title "标题" \
  --note "正文" \
  --tags "话题1,话题2"

微信公众号图文

node dist/cli.js wechatmp publish \
  --account my_account \
  --source /absolute/path/to/article.md \
  --title "文章标题" \
  --author "作者名"

支持 GitHub / URL 来源:

# 从 GitHub 同步
node dist/cli.js wechatmp publish \
  --account my_account \
  --source https://github.com/owner/repo/blob/main/README.md \
  --source-type github \
  --title "从 GitHub 同步的文章"

# 从网页提取
node dist/cli.js wechatmp publish \
  --account my_account \
  --source https://example.com/post/123 \
  --source-type url \
  --title "从网页提取的文章"

知乎 / 百家号文章

# 知乎(默认保存草稿,加 --publish 直接发布)
node dist/cli.js zhihu publish \
  --account my_account \
  --source /absolute/path/to/article.md \
  --title "文章标题"

# 百家号
node dist/cli.js baijiahao publish \
  --account my_account \
  --source /absolute/path/to/article.md \
  --title "文章标题"

4. 多平台顺序发布

复制并修改示例配置:

cp skills/multi-platform-publish-orchestrator/references/orchestrator.config.example.json ./orchestrator.config.json

然后执行:

node dist/cli.js orchestrate --config ./orchestrator.config.json

orchestrate 支持混合任务:tencent / douyin / kuaishou / xiaohongshu / wechatmp / zhihu / baijiahao


⌨️ 常用命令与参数

命令一览

node dist/cli.js <platform> login --account <name>      # 登录
node dist/cli.js <platform> check --account <name>      # 检查登录态
node dist/cli.js <platform> upload [options]            # 发布视频
node dist/cli.js xiaohongshu upload-video|upload-note   # 小红书
node dist/cli.js wechatmp|zhihu|baijiahao publish       # 图文
node dist/cli.js orchestrate --config <config.json>     # 多平台编排

<platform> 可选:tencent / douyin / kuaishou / xiaohongshu / wechatmp / zhihu / baijiahao

常用参数

参数 说明
--account 账号别名
--file 视频绝对路径
--title 标题
--desc 描述(仅抖音、快手)
--tags 逗号分隔标签
--schedule 定时发布 YYYY-MM-DD HH:mm
--source 图文来源(Markdown 路径 / GitHub URL / 网页 URL)
--source-type auto|markdown|github|url
--publish 图文直接发布(默认保存草稿)

🗂️ 数据与配置

数据目录

默认数据目录:

~/.social-publish-skills/

cookie 默认保存在:

~/.social-publish-skills/cookies/<platform>/<account>.json

常用环境变量

变量 说明
SOCIAL_PUBLISH_DATA_DIR 自定义数据目录
SOCIAL_PUBLISH_HEADLESS=0 使用有界面浏览器运行
SOCIAL_PUBLISH_CHROME_PATH 指定本机 Chrome 路径

🔧 开发调试

不经过构建直接运行:

npm run dev -- douyin check --account my_account

💬 联系与反馈

如果这个项目对你有帮助,欢迎 Star ⭐ 支持,这是持续维护的动力。


📄 许可证

MIT