Juejin Skills

提供掘金技术社区文章排名查询、自动发布与批量下载，支持中文交互与高效自动化工作流管理。

Install

openclaw skills install @thcjp/juejin-skills

核心功能: 本技能提供中文交互、时使用、化工作流场景等能力。

掘金技能集

专业版专属特性

能力	免费版	付费版
基础功能	支持	支持
掘金技能集持热门文章排行榜查询	不支持	支持
复杂工作流可视化编排	不支持	支持
条件分支与异常重试	不支持	支持
定时触发与事件驱动	不支持	支持
执行日志与审计追踪	不支持	支持

能力概览

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

子功能	说明
获取分类列表	获取掘金所有文章分类（前端、后端、Android、iOS、人工智能等）
热门文章排行	获取指定分类或全部分类的热门文章排行榜
文章趋势分析	按时间维度（3天/7天/30天/历史）查看文章热度趋势
排行榜筛选	支持按分类、时间范围、排序方式筛选

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

📝 功能二：文章自动发布

子功能(续)	说明
浏览器登录	通过 Playwright 打开掘金登录页面，用户扫码或密码登录后自动获取 Cookie
Cookie 管理	保存、加载、验证 Cookie 状态
Markdown 解析	读取本地 Markdown 文件，提取标题、正文内容
文章发布	通过掘金 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 浏览器登录获取）

📥 功能三：文章下载

子功能(续)(续)	说明
单篇下载	通过文章 URL 下载单篇文章，保存为 Markdown
批量下载	下载指定作者的所有/部分文章
格式转换	将掘金文章 HTML 内容转换为标准 Markdown
图片处理	可选下载文章中的图片到本地
元数据保留	保留文章标题、作者、发布时间、标签等元信息

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

快速上手

确认运行环境满足依赖说明中的要求
在AI Agent对话中调用本技能,提供必要的输入参数
检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

场景示例

场景	输入	输出
基础使用	用户请求	处理结果

不适用于：需要人工判断的复杂决策场景

操作流程

确认运行环境满足依赖说明中的要求
根据适用场景选择合适的使用方式
执行操作并检查输出结果
如遇错误，参考错误处理章节

输入参数

参数名	类型	必填	说明
content	string	否	juejin-skills处理的内容输入
strict_level	string	否	审查严格度, 可选: strict/normal/loose, 默认: normal

输出说明

json

{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}

异常应对

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达

环境要求

运行环境

Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
操作系统: Windows / macOS / Linux

依赖说明(补充)

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

可用性分类

分类: MD+execute()
说明: 基于Markdown的AI Skill,

API Key配置方式:

bash

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

案例展示

text

用户：帮我获取掘金前端分类的热门文章排行榜
AI：正在获取掘金前端分类的热门文章...
# ...
用户：把 ./my-article.md 发布到掘金，分类选前端，标签加上 Vue.js 和 TypeScript
AI：正在登录掘金账号并发布文章...
# ...
用户：下载这篇掘金文章 https://juejin.cn/post/7300000000000000000
AI：正在下载文章并转换为 Markdown 格式...

疑问解答

Q1: 如何开始使用掘金技能集？

A: 请参考使用流程和依赖说明章节，确保运行环境满足要求后调用本技能。

异常恢复指南

错误场景(续)	原因	处理方式
LLM响应超时或无响应	网络延迟或模型负载过高	请求重试；确认Agent平台LLM服务正常
输入内容格式不正确	用户输入不符合skill预期格式	检查输入是否符合skill使用说明中的格式要求，参考示例章节
执行结果与预期不符	指令描述不够明确或上下文不足	提供更详细的指令描述，补充必要的上下文信息
命令执行失败	运行环境不满足要求或权限不足	确认运行环境符合依赖说明中的要求；检查命令权限设置

能力边界

本技能在文件读写、网络访问和内容发布方面存在以下安全限制与已知约束，使用前请充分了解：

本地文件写入安全限制（`filesystem_write`）

download_article(...)、download_user_articles(...) 以及内部的 _write_markdown_file / _download_images 在写入磁盘之前都会调用 juejin_skill.downloader._validate_output_dir()：
- 写入路径必须位于 ./output（或 $JUEJIN_OUTPUT_ROOT）之下；
- 使用 os.path.realpath 解析后再比对，可抵御符号链接、.. 馑越，以及伪造后缀绕过检查.
任何越出根目录的 output_dir 传入都会被以 {"success": False, "message": ...} 形式拒绝，不会创建目录也不会调用 open().
这保证了 SKILL.md 中 filesystem_write 边界与代码实际行为一致.

批量下载安全限制（`bulk_download_policy`）

download_user_articles() 需要显式 confirm_bulk=True 才会执行；
max_count 默认 20、硬上限 BULK_DOWNLOAD_HARD_CAP=50，超出会被静默降级；
防止在用户仅下载一两篇文章时被意外启动为全量抓取，控制运营风险与平台合规风险.

本地文件读取安全限制（`filesystem_read`）

publish_markdown(filepath=...) 会经过 juejin_skill.publisher._validate_markdown_path() 校验，仅接受：
- 位于当前工作目录（或 $JUEJIN_MD_ROOT）之下的 .md / .markdown 文件；
- 文件大小 ≤ 2 MiB；
- 不在 /etc、/var、/proc、/sys、/dev、/root、/boot、 `[REDACTED_SSH_PATH] 等敏感前缀下的文件.
路径会使用 os.path.realpath 解析后再比对，以防止符号链接逃逸、 .. 路径馑越、以及伪造后缀绕过检查.
违反任一规则都会抩出 ValueError，不会走到 open()，也不会被填到草稿 / 发布 / 任何外发请求中.

图片下载安全限制

图片下载功能仅允许下载来自掘金官方域名的图片
支持的域名：juejin.cn, p1-juejin.byteimg.com, p3-juejin.byteimg.com, p6-juejin.byteimg.com, p9-juejin.byteimg.com
其他域名的图片将被自动跳过，防止SSRF攻击和未经授权的出站请求

发布安全机制

默认只创建草稿，不公开发布
公开发布需要双重确认：save_draft_only=False 和 allow_public_publish=True
命令行工具需要额外的环境变量和交互式确认

网络访问限制

仅允许访问 juejin.cn 和 api.juejin.cn 域名
图片下载有严格的域名白名单限制
防止潜在的策略绕过和跟踪风险

差异化分析

效率提升量化分析

操作步骤	手动耗时	自动化耗时	时间节约	准确率提升
获取热门文章排行榜	30分钟	5分钟	25分钟	100%
文章自动发布	1小时	10分钟	50分钟	100%
文章下载	1小时	15分钟	45分钟	100%
文件格式转换	30分钟	5分钟	25分钟	100%
图片下载	1小时	10分钟	50分钟	100%

差异化对比

对比维度	本技能	手动操作	Python脚本	专业软件
功能丰富度	高	低	中	高
易用性	高	低	中	高
成本	低	高	中	高
扩展性	高	低	中	高
维护成本	低	高	中	高

核心痛点解决

痛点	描述	影响范围	解决方案	量化效果
手动操作效率低	需要大量手动操作，耗时且容易出错	影响个人或团队工作效率	自动化操作，提高效率	时间节约25分钟/次
文章发布流程复杂	需要多次登录、填写信息，流程繁琐	影响内容发布效率	自动化发布，简化流程	时间节约50分钟/次
文章下载困难	需要逐篇下载，费时费力	影响资料收集效率	自动化下载，批量处理	时间节约45分钟/次

常见问题FAQ

Q1: 掘金技能集支持哪些平台？

A: 掘金技能集主要支持掘金技术社区，提供一站式操作和辅助功能。

Q2: 如何获取掘金技能集的热门文章排行榜？

A: 通过掘金技能集的API接口，可以获取掘金所有文章分类的热门文章排行榜。

Q3: 掘金技能集如何实现文章自动发布？

A: 通过Playwright浏览器登录掘金，并使用掘金API创建草稿并发布，支持设置分类、标签、摘要、封面图。

Q4: 掘金技能集支持哪些文章下载格式？

A: 掘金技能集支持将掘金文章下载为Markdown格式，并可选下载文章中的图片。

Q5: 掘金技能集如何处理文章下载中的图片？

A: 掘金技能集在下载文章时，会自动识别并下载文章中的图片，并保存在本地。

排障手册

错误现象	可能原因	诊断步骤	解决方案
无法登录掘金	网络问题或账号问题	检查网络连接，尝试重新登录或使用其他账号	重新登录或更换账号
文章发布失败	Cookie失效或API限制	检查Cookie状态，尝试刷新或更换Cookie	刷新或更换Cookie
文章下载失败	网络问题或文章不存在	检查网络连接，尝试重新下载或检查文章是否存在	重新下载或检查文章
图片下载失败	图片链接错误或网络问题	检查图片链接，尝试重新下载或检查网络连接	重新下载或检查网络连接

安全须知

确保掘金技能集运行环境的网络安全，避免被恶意攻击。
使用掘金技能集时，请确保账号安全，避免账号被盗用。
不要将掘金技能集的API密钥泄露给他人，以免造成不必要的损失。
使用掘金技能集时，请遵守相关法律法规，不得用于非法用途。
定期更新掘金技能集，以修复已知的安全漏洞。

安全风险防范

风险项	等级	防护措施	验证方法
API密钥泄露	高	通过环境变量配置，禁止硬编码	定期检查代码和配置文件
命令执行风险	高	仅执行白名单命令，避免拼接用户输入	使用沙箱环境测试
网络通信安全	中	使用HTTPS协议，验证SSL证书	定期检查证书有效期
敏感数据暴露	高	输出结果中不包含密钥、令牌等敏感信息	日志脱敏审查
未授权访问	中	限制访问权限，实施认证机制	定期审计访问日志

主要功能

自动化执行: 掘金技术社区一站式操作
文件处理: 支持多种文件格式的读取、解析和写入操作
API集成: 通过标准化接口调用外部服务并处理响应
命令执行: 在安全沙箱中执行系统命令并收集结果
信息检索: 快速搜索和过滤目标数据

掘金技能集通用排查步骤

检查输入参数: 确认所有必填参数已提供且格式正确
查看日志输出: 定位具体错误行和异常类型
验证环境配置: 确认依赖库版本和运行环境满足要求
逐步调试: 缩小问题范围,隔离故障模块

掘金技能集通用排查步骤

检查输入参数: 确认所有必填参数已提供且格式正确
查看日志输出: 定位具体错误行和异常类型
验证环境配置: 确认依赖库版本和运行环境满足要求
逐步调试: 缩小问题范围,隔离故障模块

Juejin Skills

Install

掘金技能集

专业版专属特性

能力概览

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

📝 功能二：文章自动发布

📥 功能三：文章下载

快速上手

场景示例

操作流程

输入参数

输出说明

异常应对

环境要求

运行环境

依赖说明(补充)

API Key 配置

可用性分类

案例展示

疑问解答

Q1: 如何开始使用掘金技能集？

异常恢复指南

能力边界

本地文件写入安全限制（filesystem_write）

批量下载安全限制（bulk_download_policy）

本地文件读取安全限制（filesystem_read）

图片下载安全限制

发布安全机制

网络访问限制

差异化分析

效率提升量化分析

差异化对比

核心痛点解决

常见问题FAQ

Q1: 掘金技能集支持哪些平台？

Q2: 如何获取掘金技能集的热门文章排行榜？

Q3: 掘金技能集如何实现文章自动发布？

Q4: 掘金技能集支持哪些文章下载格式？

Q5: 掘金技能集如何处理文章下载中的图片？

排障手册

安全须知

安全风险防范

主要功能

掘金技能集通用排查步骤

掘金技能集通用排查步骤

本地文件写入安全限制（`filesystem_write`）

批量下载安全限制（`bulk_download_policy`）

本地文件读取安全限制（`filesystem_read`）