掘金工具

面向个人用户的掘金社区只读与草稿发布工具，支持热门排行。Use when 需要提升效率、自动化流程、批量处理、工作流优化时使用。不适用于需要人工创意判断的任务。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互，无需复杂配置即开即用。输出结果可直接使用，减少二次加工成本。提供结构化输出和错误处理机制。

功能说明: 本技能涵盖 中文交互、化流程 等核心能力。

掘金工具（免费版）

概述

本工具面向个人用户操作掘金技术社区，覆盖热门文章排行榜查询（只读）、单篇/作者文章下载、Markdown 草稿发布。默认仅创建草稿，公开发布需双重确认，安全限制严格。

核心能力

能力	说明	免费版范围
热门排行	分类/全站热门文章	只读
文章下载	单篇/作者文章转 Markdown	单篇/少量
草稿发布	本地 md 发布为草稿	默认草稿
登录管理	Playwright 浏览器登录	Cookie 0600
技术实现要点：核心能力基于input_params参数与output_format配置实现,支持创建/查询/修改/删除等操作模式,通过config_options进行运行时配置。

核心功能执行

用input_params参数进行配置。

输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：面向个人用户的掘、金社区只读与草稿、发布工具、支持热门排行、金技术社区操作工、热门文章排行榜与、分类查询、作者文章下载为、默认仅草稿、浏览器登录与等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：查询热门文章

text

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

bash

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

# 热门文章
POST https://api.juejin.cn/recommend_api/v1/article/recommend_cate_feed

场景二：下载单篇文章

text

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

下载结果保存到 ./output/ 目录，保留标题、作者、发布时间等元信息。

场景三：草稿发布

text

用户: 把 ./my-article.md 发布到掘金，分类选前端，标签加 Vue.js
AI: 正在登录掘金账号并发布草稿...

默认只创建草稿，不公开发布。

不适用场景

以下场景掘金工具不适合处理：

• 数据库架构设计决策
• NoSQL选型
• 数据仓库ETL设计

触发条件

需要数据库操作、SQL查询、数据存储管理时使用。不适用于非本工具能力范围的需求。

快速开始

1. 用户明确提到「掘金」与具体动作。
2. 只读操作直接执行；写操作需登录态。
3. 发布默认草稿，公开需双重确认。
4. 下载结果写入 ./output/。

示例

激活条件（严格字面匹配）：

场景	触发要求
热门排行	字面含「掘金」+ 热门/排行榜
草稿发布	字面含「发布/草稿」+ 掘金 + md 路径
文章下载	字面给 juejin.cn 链接 + 下载

优选实践

• 默认草稿：发布默认只存草稿，避免误公开。
• 路径要显式：用户必须显式给 md 路径，AI 不代填。
• 下载限 output：下载结果只写 ./output/，防越权。
• Cookie 及时清：用完执行 rm $HOME/.juejin_cookie.json 撤销登录态。
• 别在共享环境登录：Cookie 明文存本地，避免共享/CI 环境。

常见问题

Q1：能批量下载吗？ A：免费版单篇/少量。批量下载（需显式确认，上限 50）支持，但默认 20 篇硬上限。

Q2：能直接公开发布吗？ A：不能。默认草稿，公开需 save_draft_only=False 且 allow_public_publish=True 双重确认。

Q3：Cookie 安全吗？ A：文件权限 0600 仅本人可读写，用完及时删除，勿提交版本库。

Q4：免费版支持多账号吗？ A：不支持。多账号与团队批量发布为专业版能力。

Q5：非掘金链接能下载吗？ A：不能。仅接受 juejin.cn 域名链接。

进阶用法

热门排行查询进阶

bash

# 全站热门
POST https://api.juejin.cn/recommend_api/v1/article/recommend_all_feed
  body: {"cursor":"0","limit":20}

# 分类热门（如前端 category_id=6809637767543259144）
POST https://api.juejin.cn/recommend_api/v1/article/recommend_cate_feed
  body: {"cate_id":"6809637767543259144","cursor":"0","limit":20}

文章下载为 Markdown

bash

# 下载单篇（保留元信息）
{baseDir}/scripts/juejin.sh download https://juejin.cn/post/7300000000000000000

# 下载作者全部文章（默认上限 20 篇，需显式确认）
sh download-author --user-id 未指定 --confirm

text

下载产物（./output/）:
  7300000000000000000.md
  ---
  title: 文章标题
  author: 作者
  published: 2026-07-01
  ---
  正文 Markdown...

草稿发布安全流程

text

发布流程:
  1. 用户提供 md 路径 + 分类 + 标签
  2. Playwright 登录（Cookie 存 0600）
  3. 创建草稿（save_draft_only=True 默认）
  4. 返回草稿链接供用户预览
  5. 公开发布需双重确认（默认拒绝）

已知限制

• 默认草稿：发布默认只存草稿，不公开。
• 路径显式：用户必须显式给 md 路径，AI 不代填。
• 批量上限：批量下载默认 20 篇硬上限，需确认。
• 域名限制：仅接受 juejin.cn 链接。
• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

工作流分类

操作类别	处理方式	示例
信息查询	直接执行	热门排行
设置调整	直接执行	草稿配置
破坏性	先确认	公开发布
需登录	先登录态	草稿发布

依赖说明

运行环境

• Agent 平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
• 操作系统: Windows / macOS / Linux
• Python: 3.9+
• 网络: 可访问 juejin.cn

依赖详情

依赖项	类型	是否必需	获取方式
Python	运行时	必需	python.org
Playwright	浏览器自动化	登录时必需	pip install playwright
LLM API	API	必需	由 Agent 内置 LLM 提供

API Key 配置

• 无需额外 API Key
• 登录后掘金会话 Cookie 保存到 $HOME/.juejin_cookie.json（权限 0600）

可用性分类

• 分类: MD+EXEC（Markdown 指令 + 命令行执行）
• 说明: 通过自然语言指令驱动 Agent 调用掘金 API 完成只读与草稿操作

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

安全注意事项

风险类型	防范措施
API密钥泄露	通过环境变量配置，禁止硬编码到代码或配置文件中
命令执行风险	仅执行白名单命令，避免拼接用户输入到命令行参数中
网络通信安全	使用HTTPS协议，验证SSL证书有效性
敏感数据暴露	输出结果中不包含密钥、令牌等敏感信息

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。