今日头条发布工具

---

name: personal-toutiao-pub

description: 今日头条微头条自动发布工具。触发词："发布头条"、"发微头条"、"头条发布"

version: 1.0.0

---

# 今日头条发布工具

自动发布微头条到今日头条，支持复用本地 Chrome 登录态，支持智能等待登录。

功能特性

触发方式

发布头条：今天天气真好
发微头条 今天学到了很多新知识
头条发布 "分享一个有趣的故事..."

使用方法

命令行使用

# 基本使用（发布默认内容）
python3 toutiao_publish.py

# 发布指定内容
python3 toutiao_publish.py "今天天气真好，心情也不错！"

# 从文件读取内容
python3 toutiao_publish.py -f content.txt

# 带图片发布
python3 toutiao_publish.py "内容" --image ~/Desktop/pic.jpg

# 使用无头模式（新浏览器）
python3 toutiao_publish.py "内容" --headless

# 未登录时不等待，直接退出
python3 toutiao_publish.py "内容" --no-wait

前置要求

**必须启动 Chrome 远程调试：**

# Mac
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222

# Windows
"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222

# Linux
google-chrome --remote-debugging-port=9222

发布流程

1. 连接本地 Chrome 浏览器

2. 检查登录状态

- **已登录**：直接进入发布页面

- **未登录**：显示提示，自动等待登录（最长5分钟）

3. 打开发布页面

4. 输入内容（自动扩展到100字以上）

5. 上传图片（如提供）

6. 勾选发布选项：

- 声明首发：头条首发（如存在）

- 作品声明：个人观点，仅供参考

7. 点击发布按钮

8. 保存成功截图

参数说明

| 参数 | 说明 | 示例 |

|------|------|------|

| `content` | 发布内容 | `"今天天气很好"` |

| `-f, --file` | 从文件读取 | `-f post.txt` |

| `-i, --image` | 图片路径 | `--image pic.jpg` |

| `--headless` | 无头模式 | `--headless` |

| `--no-wait` | 不等待登录 | `--no-wait` |

智能等待登录

当检测到未登录时，脚本会：

1. 显示提示信息：

```

⏳ 等待登录...

请在 Chrome 浏览器中完成登录

登录成功后将自动继续...

（最长等待 300 秒）

```

2. 每2秒检查一次登录状态

3. 检测到登录成功后自动继续发布流程

4. 超过5分钟未登录则超时退出

**使用 `--no-wait` 参数可禁用等待功能，未登录时直接退出。**

输出

故障排除

| 问题 | 解决方案 |

|------|----------|

| 无法连接 Chrome | 确保 Chrome 已启动并开启 9222 端口 |

| 未检测到登录 | 在 Chrome 中访问 mp.toutiao.com 完成登录 |

| 等待登录超时 | 检查网络，重新运行脚本 |

| 找不到输入框 | 页面结构可能变化，检查错误截图 |

| 图片上传失败 | 检查图片路径和格式 |

| 发布失败 | 检查网络连接，查看错误截图 |

依赖

pip3 install playwright --break-system-packages
playwright install chromium

文件结构

skills/toutiao-publisher/
├── SKILL.md              # 本说明文件
└── toutiao_publish.py    # 主脚本

---

*Created: 2026-03-08*

*Updated: 2026-03-08（新增智能等待登录）*