头条全自动发布

自动发布图文文章和微头条到头条号，支持选题、写文、配图生成、Cookie登录、图文混排发布的全自动流程，也可定时自动化执行。

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "头条全自动发布" with this command: npx skills add kevin1220/kevin-toutiao-auto-publisher

头条全自动发布 Skill

全自动发布图文文章和微头条到头条号的 AI Agent Skill。

功能特性

  • 图文文章发布：从选题 → 写文 → 配图 → 发布的完整流程
  • 微头条发布：快速发布短内容（~200字）到微头条
  • 配图生成：自动生成水墨中国风配图（支持自定义风格）
  • Cookie 登录：通过 Cookie 注入实现免验证码登录
  • 图文混排：正文与配图混排，排版美观
  • 飞书通知：发布成功/失败后自动推送通知
  • 定时自动化：支持每小时自动发布（可配置时间段）
  • 热门话题获取：自动从话题邀请中筛选围观最多的话题

前置条件

  1. 已有头条号（mp.toutiao.com）
  2. 已安装 Python 3.8+ 和 Playwright
  3. Chrome 浏览器已安装
  4. 已获取头条号的 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

  1. 用 Chrome 打开 https://mp.toutiao.com 并登录
  2. 按 F12 → Application → Cookies → 复制所有 Cookie 到 JSON 文件
  3. 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

关键步骤：

  1. 通过 Playwright CDP 连接已有 Chrome（端口 9222）
  2. Cookie 注入后导航到发布页
  3. 标题用 JS 原生 setter + 事件触发（避免 ProseMirror 拦截）
  4. 正文用 insertHTML 一次性插入段落
  5. 配图通过工具栏图片按钮 → file input 上传
  6. 封面选择"单图"模式上传
  7. 勾选"个人观点，仅供参考"声明
  8. 点击"预览并发布" → "确认发布"

微头条发布

获取热门话题 → 生成短内容（~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 - 包含完整代码，通用化配置，可直接使用

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open Registry RecordOpen in ClawHub

Related Skills

Related by shared tags or category signals.

General

openEuler RPM Packaging

🚨 openEuler 专项 RPM 打包规范。任何涉及 openEuler 打包的场景，都必须读取此技能。**openEuler 规则与通用 RPM 不同**：5 包拆分规则、专用 changelog 格式（Type/ID/SUG/DESC）、openEuler 专用宏、检视原则。不适用于其他发行版。

Registry SourceRecently Updated
1200weidongkl
General

Tianyi Cloud Game

天翼云游戏搜索与启动。当用户想玩云游戏、搜索游戏、或提到天翼云游戏时使用。支持自然语言匹配游戏并快速启动。

Registry SourceRecently Updated
1920akahello
General

Ugc Ad Script Maker

Creates timed, authentic UGC-style ad scripts with strong hooks, natural product proof, and varied CTAs for TikTok, Reels, Shorts, FB, and Snapchat.

Registry SourceRecently Updated
140harrylabsj
General

Campaign Angle Spark

Generates and scores unique, relevant campaign angles from product briefs, recommending targeted marketing hooks and test priorities without generic templates.

Registry SourceRecently Updated
150harrylabsj