# Personal Toutiao Pub

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

- Skill: `dvcrn/personal-toutiao-pub` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add dvcrn/personal-toutiao-pub`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/personal-toutiao-pub/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/personal-toutiao-pub

---


# 今日头条发布工具

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

## 功能特性

- ✅ **复用登录态**：连接本地 Chrome，无需重复登录
- ✅ **智能等待登录**：未登录时自动等待，登录成功后继续
- ✅ **智能内容扩展**：内容不足100字自动扩展
- ✅ **自动勾选选项**：自动勾选"个人观点，仅供参考"
- ✅ **支持图片上传**：可附带图片发布
- ✅ **截图保存**：发布成功后自动截图保存到桌面
- ✅ **支持文件输入**：可从文件读取长文本内容

## 触发方式

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

## 使用方法

### 命令行使用

```bash
# 基本使用（发布默认内容）
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 远程调试：**

```bash
# 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` 参数可禁用等待功能，未登录时直接退出。**

## 输出

- **成功截图**：`~/Desktop/toutiao_publish_success.png`
- **错误截图**：`~/Desktop/toutiao_error.png`

## 故障排除

| 问题 | 解决方案 |
|------|----------|
| 无法连接 Chrome | 确保 Chrome 已启动并开启 9222 端口 |
| 未检测到登录 | 在 Chrome 中访问 mp.toutiao.com 完成登录 |
| 等待登录超时 | 检查网络，重新运行脚本 |
| 找不到输入框 | 页面结构可能变化，检查错误截图 |
| 图片上传失败 | 检查图片路径和格式 |
| 发布失败 | 检查网络连接，查看错误截图 |

## 依赖

```bash
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（新增智能等待登录）*