Juejin Smart Publish

掘金智能发布

平台入口

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

排版规则

文章规范

分类（必选1个）

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

标签

封面 & 摘要

内容适配模板

技术文章标准结构：

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

> {一句话摘要/导言}

## 背景 / 为什么

{痛点描述，1-2段}

## 方案 / 怎么做

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

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

## 效果 / 结果

{数据对比，before/after}

## 总结

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

---

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

标题公式：

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

发布流程

Playwright 自动化

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

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）

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

Markdown 快捷键

发布时间建议

错误处理

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  # 经验分享模板