Skill: wtl01/toutiao-article-publish (version 1.0.0)

--- 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) - ✅ 初始版本创建 - ✅ 基础发布流程文档

path: package.json
content: {
  "name": "toutiao-article-publish",
  "version": "4.0.0",
  "description": "今日头条（头条号）全链路自动发布技能。支持微头条和头条文章两种内容形式的自动化发布，覆盖选题 → 写作 → 配图上传 → 发布全流程。集成 browser-cdp 支持 CDP 直连浏览器。",
  "keywords": [
    "今日头条",
    "头条号",
    "微头条",
    "文章发布",
    "内容创作",
    "browser-cdp",
    "自动化"
  ],
  "author": "MR.W",
  "license": "MIT",
  "dependencies": {
    "browser-cdp": ">=1.0.0"
  },
  "openclaw": {
    "skill": true,
    "emoji": "📰",
    "triggers": [
      "发布文章",
      "头条文章",
      "微头条",
      "头条号发布",
      "发布头条",
      "写文章发布",
      "文章配图"
    ]
  },
  "files": [
    "SKILL.md",
    "scripts/",
    "assets/",
    "references/"
  ],
  "scripts": {
    "test": "python scripts/toutiao_cdp_publisher.py"
  }
}

path: README.md
content: # 今日头条自动化发布 Skill

基于 browser-cdp 的今日头条（头条号）全链路自动发布技能。

## 功能特性

- ✅ **CDP 直连浏览器**：使用 browser-cdp skill 直连 Chrome/Edge/QQ浏览器
- ✅ **登录态复用**：复用用户浏览器登录态，无需重复登录
- ✅ **双内容形式**：支持微头条和头条文章两种发布形式
- ✅ **智能配图**：AI 自动判断是否配图，支持图片上传
- ✅ **定时发布**：支持定时任务，实现自动化运营
- ✅ **完整流程**：选题 → 写作 → 配图 → 发布全流程覆盖

## 快速开始

### 1. 安装依赖

确保已安装 browser-cdp skill：

```bash
skillhub_install install_skill browser-cdp
```

## 文件结构

```
toutiao-article-publish/
├── SKILL.md                    # 技能详细文档
├── package.json               # 技能元数据
├── README.md                  # 本文件
├── assets/                    # 资源文件
└── references/                # 参考文档
```

## 使用场景

### 个人内容创作者
- 自动化发布日常内容
- 定时发布提高曝光
- 批量处理多平台发布

### 自媒体运营
- 规模化内容生产
- 数据驱动的选题策略
- 自动化运营流程

### 企业营销
- 品牌内容自动化发布
- 营销活动定时推送
- 多账号协同管理

## 配置说明

### 浏览器配置
- 默认使用 Chrome 浏览器
- 支持 Edge、QQ浏览器
- 复用用户 profile 保持登录态

### 发布配置
- 微头条：150-250字，可选配图
- 文章：500-800字，必配图
- 话题标签：自动添加 `#话题#`

### 定时任务
- 微头条：每30分钟（7:00-次日1:00）
- 文章：每2小时（8:00-22:00）

## 注意事项

1. **首次使用需要授权**：CDP 连接需要用户授权
2. **登录处理**：遇到登录页面需手动登录
3. **发布频率**：避免短时间大量发布
4. **内容审核**：遵守平台内容规范
5. **图片版权**：确保图片有合法使用权

## 技术支持

- 查看详细文档：`SKILL.md`
- 运行测试：`python scripts/toutiao_cdp_publisher.py`
- 问题反馈：检查浏览器控制台日志

## 版本历史

- **v4.0.0** (2026-04-05)：集成 browser-cdp，新增 CDP 发布器
- **v3.0.0** (2026-04-05)：完善配图决策和定时任务
- **v2.0.0** (2026-04-04)：修复图片上传流程
- **v1.0.0** (2026-04-04)：初始版本发布

## 许可证

MIT License

Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)