toutiao-article-publish

SKILL.md

---
name: toutiao-article-publish
description: |
  今日头条（头条号）全链路自动发布技能。支持微头条和头条文章两种内容形式的自动化发布：
  覆盖选题 → 写作 → 配图上传 → 发布全流程。
  触发关键词：发布文章、头条文章、微头条、头条号发布、发布头条、写文章发布、文章配图。
---

# 头条号全链路发布 Skill（v3 - 已验证稳定版）

## 概述

自动化完成今日头条（头条号）微头条和文章的全流程发布，包括热门选题、仿写内容、下载配图、自动上传图片、发布。

**已验证特性（v3）：**
- ✅ 使用 OpenClaw 内置 `browser` 工具，CDP 直连浏览器
- ✅ 复用用户浏览器登录态，无需重复登录
- ✅ 微头条配图上传三步法（已验证成功）
- ✅ 纯工具链，无外部脚本依赖

**适用内容形式：**
- 微头条：短内容，高频发布，配图由 AI 自行判断是否添加
- 头条文章：中长内容，深度沉淀，每篇配图 1 张

**核心规范：**

- 配图路径：`E:\自媒体\今日头条\{yyyy-MM-dd}\`，按日归档
- 发布节奏：微头条每 30 分钟（7:00 - 次日 1:00），文章每 2 小时（8:00 - 22:00）
- 配图复用：可跨日调用前一日配图目录的素材

---

## 🚀 快速开始（使用 browser 工具）

### 前置要求

1. **确保 Chrome 浏览器已安装**（版本 ≥ 144）
2. **确保 OpenClaw 浏览器服务已启动**：
   ```bash
   # 检查浏览器状态
   browser(action="status")
   ```

### 使用 browser 工具发布

**核心工具链：**
- `browser(action="navigate")` - 导航到页面
- `browser(action="snapshot")` - 获取页面快照
- `browser(action="act")` - 点击、输入等操作
- `browser(action="upload")` - 上传文件

**发布流程示例：**
```javascript
// 1. 导航到微头条发布页
browser(action="navigate", url="https://mp.toutiao.com/profile_v4/weitoutiao/publish")

// 2. 输入内容
browser(action="act", kind="type", text="微头条内容...")

// 3. 如需配图，执行三步法
browser(action="act", kind="click", ref="图片按钮ref")
browser(action="upload", paths=["图片路径"])
// 验证图片预览出现

// 4. 发布
browser(action="act", kind="click", ref="发布按钮ref")
```

---

## 配图决策机制

### 微头条是否配图：AI 自行判断

**是否配图，由 AI 根据以下因素综合判断：**

| 判断维度 | 建议配图 | 建议不配图 |
|----------|----------|------------|
| 话题类型 | 情感故事、热点事件、视觉冲击类 | 纯观点输出、数据罗列 |
| 文字量 | 文字已承载全部信息 | 图片能补充文字说不清的内容 |
| 历史表现 | 无图版本数据一般 | 有图版本明显更高 |
| 发布时间 | 非高峰时段（需争取注意力） | 高峰时段（流量自带热度） |

**配图数量**：如决定配图，每篇 3 张，图片与主题高度相关。

### ✅ 微头条图片上传流程（已验证成功 - 2026-04-05 12:21）

```
第一步：点击「图片」按钮（ref=e146）
        ↓
第二步：等待上传面板展开，点击「Choose File」按钮（ref=e319）
        ↓
第三步：使用 browser upload action 上传图片
        browser(action="upload", paths=["C:\\tmp\\openclaw\\uploads\\图片.jpg"])
        ↓
第四步：点击「确定」按钮（ref=e352）确认上传
        ↓
第五步：【验证】检查页面显示「共 3 张，还能上传 15 张」
```

**成功经验总结：**
1. **CDP 直连稳定**：使用 `browser` 工具 + `profile="openclaw"`，无需 Python 脚本
2. **文件路径处理**：需先将图片复制到 `C:\tmp\openclaw\uploads\` 目录
3. **上传时机**：必须等待上传面板完全展开后再调用 `upload`
4. **确认步骤**：上传后必须点击「确定」按钮，否则图片不会添加到编辑器

**配图复用机制：**
- 当日目录为空时，可复用前一日配图目录（如 `2026-04-04` 的图片）
- 图片命名规范：`{主题关键词}{序号}.jpg`，如 `health1.jpg`

### 文章配图流程（已验证成功 - 2026-04-05 10:46）

文章发布页面的图片上传采用 **后台推荐配图** 方式：
1. 发布文章时，系统自动推荐相关配图
2. 从推荐配图中选择 1 张
3. 无需手动上传，简化流程

---

## 发布流程

### Step 1: 选题

**双渠道选题（优先级从高到低）：**

1. **头条号后台创作灵感**（右侧「创作热点推荐」）—— 高互动话题，带热度数据
2. **澎湃新闻**（https://www.thepaper.cn/）—— 时政、社会热点
3. **36氪**（https://www.36kr.com/hot-list/catalog）—— 科技、商业

**内容领域偏好（按热度权重）：**
消费维权 > 国际局势 > 励志故事 > 体育热点 > 社会话题 > 健康/育儿 > 职场生存 > 教育政策 > 科技/国产替代 > 核能/能源政策

热门话题选择标准：优先选「阅读量大、讨论数高」的实时话题，互动数据越好爆款概率越高。

### Step 2: 内容仿写

**微头条（150-250 字）：**
- 开头直击痛点或悬念
- 中间简述事件/观点
- 结尾留讨论空间或亮观点
- 末尾附加话题标签 `#话题名#`

**头条文章（500-800 字）：**
- 标题：2-30 字，含关键词，吸引眼球但不夸张
- 正文：开头引入 → 核心内容（3-5段，配小标题）→ 总结观点
- 分段清晰，每段 2-4 句

### Step 3: 浏览器自动化发布

#### 使用 browser 工具发布微头条（已验证成功）

```
1. 打开微头条发布页
   browser(action="navigate", url="https://mp.toutiao.com/profile_v4/weitoutiao/publish")

2. 输入正文
   browser(action="act", kind="click", ref="编辑器ref")  # 先点击编辑器
   browser(action="act", kind="type", text="微头条内容...")

3. 判断是否配图（如需配图，执行已验证的五步法）：
   - 点击「图片」按钮（ref=e146）
   - 点击「Choose File」按钮（ref=e319）
   - 使用 upload 上传图片：
     browser(action="upload", paths=["C:\\tmp\\openclaw\\uploads\\图片.jpg"])
   - 点击「确定」按钮（ref=e352）
   - 验证：页面显示「共 3 张，还能上传 15 张」

4. 添加话题标签（插入正文末尾）

5. 发布
   - 点击发布按钮（ref=e248）
   - 确认页面跳转到微头条管理页（URL 变为 /weitoutiao）
   - 记录发布时间和状态
```

**关键要点：**
- 使用 `browser` 工具 + `profile="openclaw"` 进行 CDP 直连
- 图片需先复制到 `C:\tmp\openclaw\uploads\` 目录
- 上传后必须点击「确定」按钮确认

#### 文章发布

```
1. 打开文章发布页
   URL: https://mp.toutiao.com/profile_v4/graphic/publish

2. 填写标题

3. 填写正文（JS 注入，同微头条）

4. 添加配图：
   - 方式一：从右侧创作助手推荐图片中选择
   - 方式二：从素材库选择（需提前手动上传）
   - 方式三：与微头条三步法相同（待验证）

5. 设置封面（单图/三图/无封面）

6. 其他设置：
   - 投放广告：开启赚收益
   - 声明首发：头条首发（72小时内仅在头条发布）
   - 作品声明：根据内容选择

7. 预览并发布
```

### Step 4: 发布后确认

- 检查页面跳转到作品管理
- 确认内容状态（审核中 / 已发布）
- 记录发布时间、内容标题、话题标签

---

## 图片素材管理

### 配图归档规范

| 项目 | 规范 |
|------|------|
| 存放路径 | `E:\自媒体\今日头条\{yyyy-MM-dd}\` |
| 命名规则 | `{主题关键词}{序号}.jpg`，如 `health1.jpg`、`nuclear1.jpg` |
| 微头条配图数 | 如配图，每篇 3 张（AI 自行判断是否配图） |
| 文章配图数 | 每篇 1 张 |
| 复用机制 | 支持跨日调用前日配图目录 |

### 配图来源

- **AI 下载**：根据话题关键词从网络下载相关图片
- **复用已有**：调用前一日配图目录素材（已验证可行）

---

## 定时任务

 采用双轨定时发布体系：

| 轨道 | 内容形式 | 频率 | 时段 | 每日篇数 |
|------|----------|------|------|----------|
| 轨道一 | 微头条 | 每 30 分钟 | 7:00 - 次日 1:00 | ~30 篇 |
| 轨道二 | 头条文章 | 每 2 小时 | 8:00 - 22:00 | 8 篇 |

定时任务 payload 使用 `agentTurn`，sessionTarget 为 `isolated`。

**定时任务执行流程：**
1. 使用 `browser` 工具 CDP 直连浏览器
2. 导航到微头条/文章发布页
3. 执行发布流程（含配图上传五步法）
4. 验证发布成功，返回结果

**已验证成功案例：**
- 2026-04-05 12:21：微头条发布成功（话题：#育儿路上，你焦虑了吗#）
- 2026-04-05 10:46：文章发布成功（话题：#日本加速推动核能计划#）

---

## 常见问题

### 1. 浏览器连接失败

**症状**：`browser` 工具返回连接错误
**解决**：
1. 检查 Chrome 浏览器是否已安装（版本 ≥ 144）
2. 检查 OpenClaw 浏览器服务状态：`browser(action="status")`
3. 确保使用 `profile="openclaw"` 进行 CDP 直连

### 2. 页面跳转到微头条

文章发布页和微头条发布页共用部分状态，可能导致跳转。
**解决**：新建标签页访问文章发布页，或使用 `window.open()` 打开新页面。

### 3. 正文无法输入

头条编辑器使用自定义组件，直接点击可能失效。
**解决**：使用 `browser(action="act", kind="type")` 直接输入，无需 JavaScript 注入。

### 4. 图片上传失败

**症状**：图片上传后未出现在编辑器中
**解决**：
1. 确保执行完整的五步法（点击图片 → 点击 Choose File → upload → 点击确定 → 验证）
2. 图片需先复制到 `C:\tmp\openclaw\uploads\` 目录
3. 上传后必须点击「确定」按钮

### 5. 错别字检测

头条创作助手会自动检测错别字。
**处理**：点击「修改」按钮自动修正，或手动编辑。

---

## 注意事项

1. **发布频率**：避免短时间大量发布，建议间隔 30 分钟以上
2. **内容原创**：声明首发需确保 72 小时内仅在头条发布
3. **审核时间**：通常几分钟到几小时不等
4. **敏感内容**：避免涉及政治敏感、虚假信息等内容
5. **发布前必查**：正文是否完整、话题标签是否正确、配图是否已添加（如需配图）
6. **文件路径**：图片需先复制到 `C:\tmp\openclaw\uploads\` 目录再上传
7. **登录处理**：遇到登录页面时立即停止自动化，提示用户手动登录
8. **工具链**：使用纯 `browser` 工具链，无需外部 Python 脚本

---

## 文件结构

```
toutiao-article-publish/
├── SKILL.md                    # 技能文档（本文件）
├── assets/                     # 资源文件（可选）
└── references/                 # 参考文档（可选）
```

## 更新日志

### v3 (2026-04-05) - 稳定回滚版
- ✅ **回滚**：删除无用的 Python 脚本依赖
- ✅ **验证**：微头条配图上传五步法（已验证成功）
- ✅ **简化**：纯 `browser` 工具链，CDP 直连
- ✅ **经验**：总结 2026-04-05 12:21 成功发布经验

### v2 (2026-04-04)
- ✅ 修复图片上传流程
- ✅ 添加配图验证步骤
- ✅ 总结发布经验教训

### v1 (2026-04-04)
- ✅ 初始版本创建
- ✅ 基础发布流程文档