⚠️ 凭证与权限声明

本技能在登录成功后会把掘金会话 Cookie 以明文 JSON 形式保存到 ~/.juejin_cookie.json（文件权限会被设置为 0600，仅当前用户可读写）。 只要该文件存在且未过期，后续调用即可以你的身份访问掘金账号（发布文章、 读取草稿等）。

• 仅在你愿意把掘金登录态保存在本机时才登录，避免在共享/CI 环境运行；
• 使用结束后请执行 rm ~/.juejin_cookie.json 主动撤销；
• 不要将该文件提交版本库（仓库已默认忽略）；
• 本技能默认只创建草稿：API 层 ArticlePublisher.publish_markdown() 的默认行为是 save_draft_only=True，且公开发布还需要调用方额外显式 传入 allow_public_publish=True。入口脚本 run_publish.py 和 publish_article.py 则在此之上再加了命令行/交互式的人工确认门。

Juejin Skills - 掘金技术社区操作技能

🚀 快速使用

本技能支持以下自然语言指令，直接对 AI 说出即可：

热门文章排行榜

• "获取掘金热门文章排行榜"

• "查看掘金前端分类的热门文章"

• "掘金有哪些文章分类？"

• "获取掘金后端/前端/Android/iOS/人工智能分类的热门趋势"

• "帮我看看掘金最近最火的文章是哪些"

文章发布

• "帮我把这篇 Markdown 文章发布到掘金"

• "发布文章到掘金，分类为前端，标签为 Vue.js"

• "一键发布文章到掘金平台"

• "登录掘金账号"（会通过 Playwright 打开浏览器让你登录）

文章下载

• "下载掘金文章并保存为 Markdown"

• "把这篇掘金文章保存到本地"

• "批量下载掘金某个作者的所有文章"

• "下载这个链接的掘金文章：https://juejin.cn/post/xxx"

技能描述

激活条件

当用户说出或暗示以下内容时，做出回应：

1. 热门文章排行榜技能

• 用户想要获取掘金网站热门文章排行榜

• 用户需要查询掘金文章分类列表

• 用户想了解各分类的热门文章趋势

• 用户需要获取全部领域或特定领域的热门文章

• 用户想要了解掘金技术文章排行、阅读量排名

• 关键词：掘金、热门、排行榜、文章分类、趋势、热榜

2. 文章发布技能

• 用户想要将 Markdown 文章发布到掘金平台

• 用户需要登录掘金账号（通过 Playwright 浏览器登录获取 Cookie）

• 用户想要设置文章分类、标签、摘要和封面图

• 用户需要一键发布文章到掘金

• 关键词：发布、发文、投稿、掘金、Markdown

3. 文章下载技能

• 用户想要下载掘金文章并保存为 Markdown 格式

• 用户需要批量下载某作者的掘金文章

• 用户想要保存掘金文章到本地

• 关键词：下载、保存、导出、Markdown、掘金文章

功能清单

📊 功能一：热门文章排行榜

API 接口：

• 分类列表：GET https://api.juejin.cn/tag_api/v1/query_category_briefs

• 热门文章：POST https://api.juejin.cn/recommend_api/v1/article/recommend_all_feed

• 分类文章：POST https://api.juejin.cn/recommend_api/v1/article/recommend_cate_feed

• 标签列表：POST https://api.juejin.cn/tag_api/v1/query_category_tags

📝 功能二：文章自动发布

API 接口：

• 创建草稿：POST https://api.juejin.cn/content_api/v1/article_draft/create

• 发布文章：POST https://api.juejin.cn/content_api/v1/article/publish

• 获取标签：POST https://api.juejin.cn/tag_api/v1/query_category_tags

鉴权方式：Cookie 鉴权（通过 Playwright 浏览器登录获取）

📥 功能三：文章下载

API 接口：

• 文章详情：POST https://api.juejin.cn/content_api/v1/article/detail

• 用户文章列表：POST https://api.juejin.cn/content_api/v1/article/query_list

技术架构

juejin/
├── SKILL.md              # 技能定义文档
├── README.md             # 项目说明文档
├── requirements.txt      # Python 依赖
├── juejin_skill/         # 主模块
│   ├── __init__.py
│   ├── config.py         # 配置管理
│   ├── api.py            # 掘金 API 封装
│   ├── auth.py           # 登录鉴权（Playwright）
│   ├── hot_articles.py   # 热门文章排行榜
│   ├── publisher.py      # 文章发布
│   ├── downloader.py     # 文章下载
│   └── utils.py          # 工具函数
└── output/               # 下载文章输出目录

环境要求

• Python >= 3.9

• Playwright（用于浏览器登录）

• 网络可访问 https://juejin.cn/

Prompt 示例

用户：帮我获取掘金前端分类的热门文章排行榜
AI：正在获取掘金前端分类的热门文章...

用户：把 ./my-article.md 发布到掘金，分类选前端，标签加上 Vue.js 和 TypeScript
AI：正在登录掘金账号并发布文章...

用户：下载这篇掘金文章 https://juejin.cn/post/7300000000000000000
AI：正在下载文章并转换为 Markdown 格式...