skill-toutiao-publisher

skill-toutiao-publisher（发布层 · 今日头条图文）

把图文内容发布到今日头条（头条号后台 mp.toutiao.com）。 核心脚本：scripts/toutiao_publish.py（CWD=项目根）。平台约束与改版应对见 references/platform-specs.md 与 references/publish-flow.md。

---

与其他 SKILL 的关系

SKILL	定位
skill-toutiao-publisher（本 SKILL）	头条单平台图文落地发布：登录、填编辑器、封面、话题、存草稿/发布
skill-cross-platform-publish	一稿多发的编排层，按平台约束改写后委派各平台 publisher（含本 SKILL）
skill-content-repurposing	把一个内容改写成多平台原生形态（头条偏资讯/科普长文）
copywriting / article-outline	制作层，生产头条正文；本 SKILL 只负责发出去

---

输入

• 必填：正文文件（Markdown 或纯文本）+ 标题（≤30 字）
• 选填：正文插图（--images，逗号分隔）、封面图、话题标签（≤5 个）、--draft（存草稿）

输出

• 发布结果 JSON（platform/title/tags/steps/published/url），并留痕到 outputs/_publish/toutiao_<时间戳>.json
• 真发布成功后建议再跑 skill-publish-log 记录、skill-publish-notify 通知

---

执行步骤

一、前置：登录头条号（首次或登录态失效时）

python skills/builtin/skill-toutiao-publisher/scripts/toutiao_publish.py --login

浏览器弹窗扫码，登录态持久化在 ~/.easel-browser-profiles/ToutiaoProfile（与小红书/知乎/公众号 publisher 同款方案，后续免登录）。

二、准备内容

正文与标题由制作层产出，落到 outputs/<主题>/（用人类可读主题名，禁 test/xhs 之类泛名）。头条读者偏资讯与科普，正文按"结论先行 + 小标题分段 + 数据说话"组织，细节见 references/platform-specs.md。

插图：头条号正文是 ProseMirror 富文本，本地图片路径塞进 <img src> 会被清掉，必须让脚本走「工具栏图片按钮 → 本地上传」让平台自己传 CDN。因此图片要通过 --images 交给脚本，并在正文里用独占一行的 ![](路径) 决定插图位置；正文里没写占位符的图会追加到末尾（头条自动取正文首图作封面）。

第一段文字…

![](outputs/我的主题/图1.png)

第二段文字…

三、先跑 dry-run（默认，不发布）

python skills/builtin/skill-toutiao-publisher/scripts/toutiao_publish.py \
  --input outputs/主题名/article.md --title "文章标题" --tags "AI,效率工具"

默认 dry-run 只预览计划，不打开浏览器、不向平台写入。头条编辑器本身会自动保存草稿，因此只有明确选择 --draft 或 --exec 才进入编辑器并经过出站检查；没有收到可核实的保存响应时，不把“草稿保存中”当成已存入草稿箱。

四、让用户确认标题与封面

把标题、字数、话题、封面、存草稿 or 直接发布 展示给用户，取得明确确认后才加 --exec。

五、真发布

# 存草稿（推荐先存草稿，登录后台复核后再发）
# 头条号草稿自动保存：--draft = 填完就停，等平台自动存进草稿箱，不点「预览并发布」
python skills/builtin/skill-toutiao-publisher/scripts/toutiao_publish.py \
  --input outputs/主题名/article.md --title "文章标题" \
  --tags "AI,效率工具" --cover outputs/主题名/cover.png --exec --draft

# 带插图直接发布
python skills/builtin/skill-toutiao-publisher/scripts/toutiao_publish.py \
  --input outputs/主题名/article.md --title "文章标题" \
  --images outputs/主题名/图1.png,outputs/主题名/图2.png --exec

# 直接发布
python skills/builtin/skill-toutiao-publisher/scripts/toutiao_publish.py \
  --input outputs/主题名/article.md --title "文章标题" --exec