头条全自动发布 Skill
全自动发布图文文章和微头条到头条号的 AI Agent Skill。
功能特性
- 图文文章发布：从选题 → 写文 → 配图 → 发布的完整流程
- 微头条发布：快速发布短内容（~200字）到微头条
- 配图生成：自动生成水墨中国风配图（支持自定义风格）
- Cookie 登录：通过 Cookie 注入实现免验证码登录
- 图文混排：正文与配图混排，排版美观
- 飞书通知：发布成功/失败后自动推送通知
- 定时自动化：支持每小时自动发布（可配置时间段）
- 热门话题获取：自动从话题邀请中筛选围观最多的话题
前置条件
- 已有头条号（mp.toutiao.com）
- 已安装 Python 3.8+ 和 Playwright
- Chrome 浏览器已安装
- 已获取头条号的 Cookie（JSON 格式）
快速开始
第一步：配置账号
复制 config/account_config.json.example 为 config/account_config.json，填入你的信息：
{
"account_id": "你的头条账号ID",
"account_name": "你的头条号名称",
"cookie_file": "/path/to/toutiao_cookies.json",
"inject_script": "/path/to/inject_cookies.sh",
"feishu_config": {
"app_id": "可选，飞书机器人APP_ID",
"app_secret": "可选，飞书机器人APP_SECRET",
"open_id": "可选，飞书通知接收人OPEN_ID"
}
}
第二步：获取 Cookie
- 用 Chrome 打开 https://mp.toutiao.com 并登录
- 按 F12 → Application → Cookies → 复制所有 Cookie 到 JSON 文件
- Cookie 有效期约 30 天，过期需重新获取
第三步：安装依赖
pip install playwright
playwright install chromium
pip install -r requirements.txt
使用方法
方式一：AI Agent 自动执行（推荐）
安装此 Skill 后，直接用自然语言指示 Agent：
- "帮我发布一篇关于「中年焦虑」的头条文章"
- "写一篇微头条，主题是职场困境，200字"
- "生成一张水墨中国风的配图"
- "设置每天 6 点到 23 点每小时自动发微头条"
Agent 会自动完成：选题 → 内容生成 → 配图生成 → Cookie 注入 → 发布 → 通知
方式二：脚本调用
# 发布图文文章
python3 scripts/publish_article.py
python3 scripts/publish_article.py --topic "中年困境"
python3 scripts/publish_article.py --no-publish # 只生成不发布
# 发布微头条
python3 scripts/publish_weitoutiao.py
python3 scripts/publish_weitoutiao.py --content "你的内容"
python3 scripts/publish_weitoutiao.py --auto-topic # 自动选题
# 定时自动化
python3 scripts/run_scheduler.py --type article
python3 scripts/run_scheduler.py --type weitoutiao
python3 scripts/run_scheduler.py --type both
工作流程
图文文章发布
选题/指定话题 → 生成文章内容 → 生成1张水墨风配图
→ Cookie注入登录 → 导航到发布页 → 填写标题 → 填写正文
→ 插入配图到正文 → 设置封面 → 勾选声明 → 发布 → 通知
发布 URL：https://mp.toutiao.com/profile_v4/graphic/publish
关键步骤：
- 通过 Playwright CDP 连接已有 Chrome（端口 9222）
- Cookie 注入后导航到发布页
- 标题用 JS 原生 setter + 事件触发（避免 ProseMirror 拦截）
- 正文用
insertHTML 一次性插入段落
- 配图通过工具栏图片按钮 → file input 上传
- 封面选择"单图"模式上传
- 勾选"个人观点，仅供参考"声明
- 点击"预览并发布" → "确认发布"
微头条发布
获取热门话题 → 生成短内容（~200字） → 生成配图
→ Cookie注入登录 → 导航到微头条发布页 → 填写内容
→ 上传配图 → 发布 → 通知
发布 URL：https://mp.toutiao.com/profile_v4/weitoutiao/publish
配置说明
account_config.json
| 字段 | 必填 | 说明 |
|---|
| account_id | 是 | 头条账号 ID |
| account_name | 是 | 头条号名称 |
| cookie_file | 是 | Cookie JSON 文件路径 |
| inject_script | 否 | Cookie 注入脚本路径 |
| feishu_config | 否 | 飞书通知配置 |
automation_settings.json
{
"article": {
"enabled": true,
"schedule": "0 * 6-23 * * *",
"max_retries": 3,
"timeout": 300
},
"weitoutiao": {
"enabled": true,
"schedule": "0 * 6-23 * * *",
"auto_select_topic": true,
"timeout": 180
}
}
核心模块 API
PlaywrightPublisher（浏览器自动化发布引擎）
from core.playwright_publisher import PlaywrightPublisher
pub = PlaywrightPublisher(headless=False, account_name="你的账号名")
await pub.start() # 启动 CDP 连接
await pub.load_cookies("/path/to/cookies.json") # 注入 Cookie
await pub.navigate_to_publish() # 导航到发布页
await pub.fill_title("文章标题") # 填写标题
await pub.fill_content("文章正文") # 填写正文
await pub.insert_image("/path/to/img.png") # 插入正文配图
await pub.upload_cover_image("/path/to/img.png") # 设置封面
await pub.check_declarations() # 勾选声明
success = await pub.publish() # 发布
PublisherManager（API 方式发布）
from core.publisher import PublisherManager
pub = PublisherManager(config_file="config/account_config.json")
# 图文发布
result = await pub.publish_article(
title="标题", content="内容",
images=["/path/to/img1.png"],
options={"personal_view": True}
)
# 微头条发布
result = await pub.publish_weitoutiao(
content="微头条内容", image="/path/to/img.png"
)
# 获取热门话题
topics = await pub.get_topic_invitations()
topic = pub.get_hot_topic(topics) # 围观最多的话题
配图生成
支持通过 AI 工具自动生成水墨中国风配图：
# 推荐提示词模板
prompt = "水墨中国风画，竹子，宣纸底色，红色印章，极简留白"
size = "1024x1024"
风格关键词：竹子、宣纸、红色印章、极简、留白、山水、松树
故障排查
| 问题 | 原因 | 解决方案 |
|---|
| 发布失败，提示重新登录 | Cookie 过期 | 重新获取 Cookie（有效期约30天） |
| 封面上传失败 | DOM 选择器变化 | 查看 logs/ 目录截图调试 |
| 配图生成失败 | AI 服务不可用 | 检查网络或换时段重试 |
| 预览对话框未弹出 | 页面加载慢 | 增加等待时间或检查截图 |
| 定时任务不执行 | schedule 配置错误 | 检查 automation_settings.json |
| AI 助手抽屉遮挡操作 | 头条 SPA 的 AI 浮层 | 自动用 JS 隐藏所有 drawer |
项目结构
toutiao-publisher/
├── SKILL.md # 本文件（ClawHub 标准格式）
├── README.md # 详细文档
├── requirements.txt # Python 依赖
├── config/
│ ├── account_config.json.example # 账号配置模板
│ └── automation_settings.json # 自动化设置
├── core/
│ ├── playwright_publisher.py # Playwright 自动化发布引擎
│ ├── publisher.py # API 方式发布器
│ ├── article_generator.py # 文章内容生成
│ ├── image_generator.py # 配图生成
│ ├── cookie_manager.py # Cookie 管理
│ └── notifier.py # 通知系统
├── scripts/
│ ├── publish_article.py # 图文发布脚本
│ ├── publish_weitoutiao.py # 微头条发布脚本
│ └── run_scheduler.py # 定时任务脚本
├── templates/
│ ├── article_prompts/ # 文章生成提示词
│ └── weitoutiao_prompts/ # 微头条提示词
└── logs/ # 日志目录
安全建议
- 不要将 Cookie 文件或包含密钥的配置文件上传到公开仓库
- 使用
.gitignore 忽略 config/account_config.json
- 定期更新 Cookie（有效期约 30 天）
- 遵守头条平台规则，避免违规操作
许可证
MIT License - 欢迎自由使用和修改
变更日志
v2.0.0 - 包含实际可执行代码
- 新增完整 Python 核心代码（core/ 目录）
- 所有硬编码个人信息替换为配置变量（从 config/account_config.json 读取）
- 新增 publish_article.py / publish_weitoutiao.py / run_scheduler.py 脚本
- 支持命令行参数调用
- 支持自定义个人画像（ArticleGenerator 支持传入 personal_profile）
- 新增 .gitignore 保护敏感配置
v1.0.0 - 初始发布
版本
v2.0.0 - 包含完整代码，通用化配置，可直接使用
