---

slug: juejin-skills
name: juejin-skills
version: 1.0.9
displayName: 掘金技能集
summary: 掘金技术社区一站式操作
summary_zh: '掘金技术社区一站式操作技能，支持热门文章排行榜查询。掘金技术社区一站式操作技能，支持热门文章排行榜查询。核心能力: - 其他工具领域的专业化AI辅助工具
  - 深度优'
license: MIT
description: 掘金技术社区一站式操作技能，支持热门文章排行榜查询。核心能力:\n\n- 其他工具领域的专业化AI辅助工具\n\n- \n\n- \n\n\。Use when 需要数据库操作、SQL查询、数据存储管理时使用。不适用于数据库架构设计决策。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互，无需复杂配置即开即用。 功能涵盖: skills。
  适用场景:\n\n- 通用工具、辅助功能、扩展能力\n\n- 独立开发者与一人公司效率提升\n\n- 自动化工作流与智能决策辅助。Use when 需要提升效率、自动化流程、批量处理、工作流优化时使用。不适用于纯人工创意场景。"
tags:
- Other
- 工具
- 效率
- 创意
- 图像
- api
- https
- juejin
- post
- 热门文章
tools:
- read
- exec
- write
homepage: ''
category: Automation

---


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

# 掘金技能集

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

## 能力概览
### 📊 功能一：热门文章排行榜
| 子功能 | 说明 |
|:-----|:-----|
| 获取分类列表 | 获取掘金所有文章分类（前端、后端、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`

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

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

## 场景示例
| 场景 | 输入 | 输出 |
|:------|------:|:------|
| 基础使用 | 用户请求 | 处理结果 |

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

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

## 输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---:|:---|---:|---:|
| 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 |
| 文章下载失败 | 网络问题或文章不存在 | 检查网络连接，尝试重新下载或检查文章是否存在 | 重新下载或检查文章 |
| 图片下载失败 | 图片链接错误或网络问题 | 检查图片链接，尝试重新下载或检查网络连接 | 重新下载或检查网络连接 |

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

### 安全风险防范

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

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

### 掘金技能集通用排查步骤

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

### 掘金技能集通用排查步骤

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