juejin-smart-publish

用途

掘金智能发布用于将 Markdown 文章发布到掘金技术社区，支持通过 Playwright 自动化操作编辑器，或通过 API 通道（需认证 Token）完成草稿保存与文章发布。触发场景包括：发掘金、掘金发布、juejin publish、掘金文章、技术博客发布。

平台入口

新建文章：https://juejin.cn/editor/drafts/new
草稿箱：https://juejin.cn/editor/drafts
登录方式：手机号验证码 / GitHub OAuth / 微信扫码

主要能力

排版规则

编辑器：Markdown（完整 GFM 支持）
标题：15-35字最佳，≤50字，含核心关键词
正文：1,500-5,000字（技术深度文章）
代码块：必须指定语言标识（```python）
图片：拖拽/URL/剪贴板，建议≥800px
表格：GFM 表格语法
分割线：--- 分隔大章节
目录：长文章自动生成

分类（必选1个）

后端 / 前端 / Android / iOS / 人工智能 / 开发工具 / 代码人生 / 阅读

封面 & 摘要

封面：可选，推荐宽屏 JPG/PNG/GIF ≤5MB
摘要：50-150字，不填则取正文前N字
摘要策略：含关键词，突出文章价值

使用方式

Playwright 自动化流程

打开 juejin.cn/editor/drafts/new（检查登录态）
填写标题 → input[placeholder*="标题"]
在 Markdown 编辑区写入正文
点击「发布」按钮打开设置面板
选择分类（必选）
搜索+添加标签（1-5个）
上传封面（可选）
填写摘要（可选）
点击「确认并发布」或「保存草稿」

API 通道（需认证 Token）

# 保存草稿
POST /content_api/v1/article/draft/create
# Body: { title, markdown_content, category_id, tag_ids[], cover_image }

# 发布文章
POST /content_api/v1/article/publish
# Body: { draft_id }

# 上传图片
POST /content_api/v1/upload_pic

脚本用法

# Markdown 文件发布（草稿模式）
python scripts/publish.py \
  --title "文章标题" \
  --content-file article.md \
  --category "人工智能" \
  --tags "AI,Agent,OpenClaw" \
  --mode draft

# 带封面和摘要
python scripts/publish.py \
  --title "标题" \
  --content-file article.md \
  --category "前端" \
  --tags "React,TypeScript" \
  --cover cover.png \
  --abstract "50-150字摘要" \
  --mode draft

# API模式（需cookie-file）
python scripts/publish.py \
  --title "标题" \
  --content-file article.md \
  --category "后端" \
  --tags "Python,FastAPI" \
  --mode draft \
  --api --cookie-file cookies.json

UI 选择器参考（Vue.js SPA，类名含 hash）

标题输入：input[placeholder*="标题"]
编辑区：[class*="editor"] [contenteditable] / .CodeMirror
预览区：[class*="preview"]
发布按钮：button:has-text("发布")
分类下拉：[class*="category"]
标签输入：[class*="tag"] input
封面上传：[class*="cover"] input[type="file"]
摘要输入：[class*="abstract"] textarea
确认发布：button:has-text("确认并发布")
保存草稿：button:has-text("保存草稿") / 自动保存

注意：掘金编辑器有自动保存草稿功能，内容输入后几秒即存。

Markdown 快捷键

Ctrl/Cmd + B：加粗
Ctrl/Cmd + H：标题
Ctrl/Cmd + K：链接
Ctrl/Cmd + Shift + C：代码块
Ctrl/Cmd + Shift + I：图片
Ctrl/Cmd + Z：撤销

内容适配模板

技术文章标准结构：

# {标题：动词开头或数字开头}

> {一句话摘要/导言}

## 背景 / 为什么

{痛点描述，1-2段}

## 方案 / 怎么做

{核心内容，代码+图+表}

### Step 1: ...
### Step 2: ...

## 效果 / 结果

{数据对比，before/after}

## 总结

{关键收获，1-3个要点}

---

**参考链接**:
- [link1](url)
- [link2](url)

标题公式：

数字型：「5个让你写出优雅代码的Python技巧」
实战型：「从0到1搭建AI Agent系统——完整指南」
问题型：「为什么你的SQL查询这么慢？」
经验型：「踩了3个月的坑，我总结出这套CI/CD方案」

适用场景

将本地 Markdown 技术文章发布到掘金
批量或脚本化保存草稿、发布文章
按掘金规范优化标题、分类、标签、封面与摘要
使用模板快速生成技术教程、开源项目展示、经验分享类文章

限制与注意事项

API 通道需认证 Token（cookie-file）
登录过期时需手动登录，使用 --headless false
分类未选时自动选择"后端"（默认）
标签搜索无结果时输入后按 Enter 创建新标签
图片上传失败重试3次，回退到 URL 引用
Markdown 渲染异常需检查语法，移除不支持的扩展
发布频率限制：建议每天≤3篇，间隔≥30分钟

发布时间建议

8:00-9:00：早通勤阅读
12:00-13:00：午休学习
20:00-22:00：晚间深度阅读黄金档
周末：长文适合周末

SEO 优化要点

标题含核心关键词（前15字最重要）
正文前100字包含关键词
标签选择热门+精准组合
摘要包含核心关键词
内链自己的其他文章
参与官方活动增加曝光权重

发布前检查清单

标题 15-35字，含关键词
分类已选（必选项）
标签 2-4个，热门+精准
代码块均有语言标识
图片清晰 ≥800px
正文无错别字/格式错误
摘要 50-150字（不填会自动截取）
非搬运内容，声明原创

文件结构

juejin-smart-publish/
├── SKILL.md
├── scripts/
│   └── publish.py          # Playwright + API 双通道发布
├── references/
│   └── api-spec.md         # 掘金 API 文档
└── templates/
    ├── tech-tutorial.md     # 技术教程模板
    ├── project-showcase.md  # 开源项目展示模板
    └── experience-share.md  # 经验分享模板