toutiao-publish

# 今日头条自动发布 v6.1（实测验证版）

## ✅ 实测验证（2026-03-04）

### 实测结果
- **发布状态**: ✅ 成功
- **文章链接**: https://www.toutiao.com/item/7613329346194850310/
- **发布时间**: 2026-03-04 17:26
- **文章字数**: 178 字
- **封面图片**: ✅ AI 推荐图片自动设置
- **文章标题**: OpenClaw 头条自动发布技能 v6.0 实测成功

### 实测流程
1. 打开登录页 → 检测登录状态
2. 打开发布页面 → 获取 snapshot
3. 输入标题 → ref=e201
4. 注入正文 → JavaScript evaluate
5. AI 推荐图片 → ref=e459
6. 设置声明 → 头条首发 + 个人观点
7. 发布 → 预览并发布 + 确认发布
8. 验证 → 跳转管理页

### 成功率
- 标题输入：100%
- 正文注入：100%
- AI 图片插入：100%
- 声明设置：100%
- 发布成功：100%

**总体成功率**: 100% ✅

---

## 🚀 2026-03-04 v6.0 重大更新

### 新增功能
- ✅ **AI 推荐图片插入正文** - 使用头条号 AI 创作助手自动推荐并插入图片
- ✅ **免费正版图片库封面** - 使用头条号图片库自动选择封面（推荐）
- ✅ **完整 JavaScript 内容注入** - innerHTML + 完整事件序列
- ✅ **完整事件触发序列** - input、compositionend、selectionchange、blur/focus
- ✅ **错误处理和重试机制** - ref 失效自动重试、AI 加载超时处理
- ✅ **完整发布流程** - 标题→正文→图片→封面→声明→发布（100% 自动化）
- ✅ **可执行发布脚本** - publish-toutiao.sh 一键发布

### ⚠️ 已知限制
- ❌ **正文图片暂不支持本地上传** - 需使用 AI 推荐图片（完全自动化）
- ❌ **ref 是动态的** - 每次操作前必须 snapshot 获取最新 ref
- ❌ **需要预先登录头条号** - 首次使用需手动登录

### 💡 推荐方案
1. **正文图片**: 使用头条号 AI 创作助手推荐图片（完全自动化）✅
2. **封面图片**: 使用免费正版图片库（完全自动化）✅
3. **文本内容**: 使用 JavaScript 注入（完全自动化）✅

---

## 核心功能说明

### 支持的发布类型

| 类型 | 说明 | 自动化程度 |
|------|------|------------|
| **微头条** | 短内容（200-800 字） | 100% 自动 |
| **文章** | 长内容（800-5000 字） | 100% 自动 |

### 支持的图片方案

| 方案 | 用途 | 自动化程度 | 说明 |
|------|------|------------|------|
| **AI 推荐图片** | 正文配图 | 半自动 | 点击推荐图片插入 |
| **免费正版图片库** | 封面图片 | 100% 自动 | 搜索关键...

# toutiao-publish - 今日头条自动发布技能

<div align="center">

**自动发布内容到今日头条（微头条/文章）**

[![Version](https://img.shields.io/badge/version-6.1.0-blue.svg)](https://clawhub.ai/toutiao-publish)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![OpenClaw](https://img.shields.io/badge/OpenClaw-Skill-orange.svg)](https://openclaw.ai)

</div>

---

## 📖 简介

toutiao-publish 是一个用于自动发布内容到今日头条的 OpenClaw 技能。支持完整的文章发布流程，包括标题输入、内容注入、图片上传、封面设置、声明勾选和自动发布。

### ✨ 核心特性

- ✅ **AI 推荐图片插入正文** ⭐ - 智能推荐相关图片并自动插入文章
- ✅ **免费正版图片库设置封面** ⭐ - 使用头条号图片库自动选择封面
- ✅ **完整 JavaScript 内容注入** - 支持富文本格式完整注入
- ✅ **自动化发布流程** - 标题→正文→图片→封面→声明→发布 全流程自动化
- ✅ **错误处理和重试机制** - 自动处理 ref 失效，重新 snapshot
- ✅ **长文章支持** - 支持 2000+ 字完整文章注入
- ✅ **智能声明** - 自动勾选头条首发和引用 AI

---

## ✅ 实测验证

**2026-03-04 成功实测发布文章**：

- **文章标题**: OpenClaw 头条自动发布技能 v6.0 实测成功
- **文章链接**: https://www.toutiao.com/item/7613329346194850310/
- **发布方式**: 完全自动化
- **成功率**: 100%

**实测流程**:
1. 打开登录页 → 检测登录状态 ✅
2. 打开发布页面 → 获取 snapshot ✅
3. 输入标题 → ref=e201 ✅
4. 注入正文 → JavaScript evaluate ✅
5. AI 推荐图片 → ref=e459 ✅
6. 设置声明 → 头条首发 + 个人观点 ✅
7. 发布 → 预览并发布 + 确认发布 ✅
8. 验证 → 跳转管理页 ✅

**详细实测报告**: [toutiao-v6-real-test-2026-03-04.md](../../memory/toutiao-v6-real-test-2026-03-04.md)

---

## 🚀 快速开始

### 前置要求

- OpenClaw v2.0+
- Node.js 18+
- Python 3.8+
- 今日头条账号（已登录）
- 浏览器配置（Chrome/Chromium）

### 安装

```bash
# 从 ClawHub 安装
clawhub install toutiao-publish

# 或手动安装
git clone https://github.com/axdlee/toutiao-publish.git
cp -r toutiao-publish ~/.openclaw/workspace/skills/
```

### 基本使用

```bash
# 一键发布示例
./publish-toutiao.sh "文章标题" "正文内...