mcpField
W
wjs-syndicating-articles

wjs-syndicating-articles

github.com/jianshuo营销与增长137137 次安装今天更新
代码仓库

关于 wjs-syndicating-articles

用于将最新未分发的公众号文章同步到社交平台的 skill，使用一套文案；支持的平台通过已配置 API 发布，其余生成待手动发布的 outbox，并记录状态以避免重复。

主要功能

  1. 01选择下一篇未分发文章
  2. 02生成统一发布文案
  3. 03通过已配置的平台 API 发布
  4. 04为手动发布平台生成 outbox
  5. 05记录状态以避免重复发布

适用场景

  1. 01每日分发一篇新文章
  2. 02向支持 API 的社交平台发布
  3. 03准备文案供手动发布到社交平台

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jianshuo/claude-skills --skill wjs-syndicating-articles

安装后在 Claude Code 中输入/wjs-syndicating-articles确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.gitignore
config.json
run-scheduled.sh
secrets.json.example
scripts/
build-outbox.sh
history.sh
lib.sh
pick-next-article.sh
post-bluesky.sh
post-linkedin.sh
post-threads.sh
post-x.sh
syndicate.sh
scripts/test/
assert.sh
test_build_outbox.sh
test_e2e_dryrun.sh
test_history.sh
test_pick.sh
test_post_bluesky.sh
test_post_linkedin.sh
test_post_threads.sh
test_post_x.sh
test_syndicate.sh

详细介绍

来自项目 README

wjs-syndicating-articles

每天把最新一篇还没分发过的公众号文章，扇出（syndicate）到各社交平台。一套文案走天下，有 API 的真发，没 API 的备好待发件箱让你手动粘。

Core Principles

  • 稳定第一：每个平台是独立步骤，一个失败绝不影响其它。
  • 幂等去重：state/history.jsonl 按 (slug, platform) 记录；重复跑只补发没成功的，永不重复发。
  • 凭证降级：API 平台缺/过期凭证 → 自动转 outbox（手动），不报错。
  • 署名 / CTA 用「王建硕」（用户全局偏好），不写营销腔、不堆 hashtag/@/emoji（除非原文有）。

Inputs

/wjs-syndicating-articles                 # 选最新未分发文章，走完整流程（默认/定时用）
/wjs-syndicating-articles <article-folder># 显式指定文章
/wjs-syndicating-articles --open          # 交互模式：打开手动平台 web 页 + 文案进剪贴板
/wjs-syndicating-articles --dry-run       # 只草拟，不发、不写 history
/wjs-syndicating-articles --mark <slug> <platform>  # 手动标记某平台已发

SKILL_DIR = ~/.claude/skills/wjs-syndicating-articles

Workflow (default / scheduled run)

Step 0: --mark short-circuit

若调用是 --mark <slug> <platform>：bash $SKILL_DIR/scripts/history.sh record <slug> <platform> posted 然后告诉用户已标记，结束。

Step 1: 选文章
bash $SKILL_DIR/scripts/pick-next-article.sh
  • 显式指定了 <article-folder> 则跳过此脚本，直接用它。
  • 输出为空 → 最近文章都分发完了，今天 rest day，结束。
  • 记 FOLDER，SLUG=$(basename "$FOLDER")。
Step 2: 抽一套核心文案（你来做，不是脚本）

读 $FOLDER/article.md 和 $FOLDER/meta.json。抽出一段最 quotable 的核心句/小段，≤120 字（保证塞进 X 的 280 字符；中文每字算 2），保留王建硕语气。再加一行软 CTA + 文章链接（公众号链接，没有就用 meta.json 里信息+ article_url_base）。

把最终文案写进 $SKILL_DIR/outbox/<date>-<SLUG>/post.txt（先 mkdir -p）。<date>=$(date +%F)。

--dry-run 时：打印 post.txt 内容 + 下面每个平台「将发什么」，不继续 Step 3+，结束。

Step 3: 扇出（一个确定性脚本搞定，LLM 不碰 key）
bash $SKILL_DIR/scripts/syndicate.sh "$FOLDER" "$POST_TXT"

syndicate.sh 内部：slug 一律取 basename "$FOLDER"；API 平台（X/Bluesky/Threads/LinkedIn）逐个 try/catch 真发，X 会先查 tweeting skill 的 history 防双发，缺凭证的自动降级记 queued；手动平台（Facebook/小红书/即刻/知乎）调 build-outbox.sh 备好 outbox/<slug>/ 并记 queued。不要自己手写平台循环或拼 slug —— 全交给脚本，避免 key 漂移。--dry-run 时改跑 syndicate.sh "$FOLDER" "$POST_TXT" --dry-run（不发、不写 history）。脚本 stdout 的每行 <platform>: ... 和末尾 outbox=... 就是 Step 5 汇总的数据来源。

Step 5: 通知 + 汇总

打印一张表：每个平台 status（posted+URL / queued(outbox) / failed / skipped）。 无人值守（定时）跑：发一条 PushNotification，例：「✅ X、Bluesky 已发；📋 Facebook/小红书/即刻/知乎 在 outbox 待粘：$OUTBOX」。 不要在 Step 5 自动开浏览器——那是 --open 的事。

--open mode（交互，发手动平台时）

  1. 找到今天的 outbox：$SKILL_DIR/outbox/$(date +%F)-<SLUG>（或最新一个）。
  2. cat OUTBOX/post.txt | pbcopy（文案进剪贴板）。
  3. 用 /browse skill 打开 config 里 facebook、jike、zhihu 的 web_compose。
  4. 小红书：open "$OUTBOX/image.png"（Finder 弹出），提示用户 AirDrop 到手机、文案已在剪贴板。
  5. 逐个提示：粘贴 → 发布。用户发完某个可 --mark <slug> <platform>。

File Layout

$SKILL_DIR/
├── SKILL.md  config.json  secrets.json(gitignored)
├── scripts/  lib.sh history.sh pick-next-article.sh post-*.sh build-outbox.sh
├── outbox/<date>-<slug>/  post.txt image.png OPEN.md
└── state/history.jsonl

配置 API 平台（可选，配了才真发）

拷 secrets.json.example → secrets.json，按需填 bluesky / threads / linkedin。不填的平台自动走 outbox。

Daily 自动化

/schedule daily 10:00 /wjs-syndicating-articles

评论

支持 Markdown