掘金工具（免费版）

概述

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

核心能力

核心功能执行

用input_params参数进行配置.

处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志.

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

参数配置与调用

用config_options参数进行配置.

处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志.

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

结果处理与输出

用output_format参数进行配置.

处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志.

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

使用场景

场景一：查询热门文章

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

# 分类列表
GET https://api.juejin.cn/tag_api/v1/query_category_briefs
# ...
# 热门文章
POST https://api.juejin.cn/recommend_api/v1/article/recommend_cate_feed

场景二：下载单篇文章

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

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

场景三：草稿发布

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

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

不适用场景

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

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

触发条件

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

快速开始

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

示例

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

最佳实践

• 默认草稿：发布默认只存草稿，避免误公开.
• 路径要显式：用户必须显式给 md 路径，AI 不代填.
• 下载限 output：下载结果只写 ./output/，防越权.
• Cookie 及时清：用完执行 rm ~/.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 域名链接.

进阶用法

热门排行查询进阶

# 全站热门
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

# 下载单篇（保留元信息）
{baseDir}/（请参考skill目录中的脚本文件） download https://juejin.cn/post/7300000000000000000
# ...
# 下载作者全部文章（默认上限 20 篇，需显式确认）
{baseDir}/（请参考skill目录中的脚本文件） download-author --user-id XXX --confirm

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

草稿发布安全流程

发布流程:
  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

依赖详情

API Key 配置

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

可用性分类

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

错误处理

输出格式

{
  "success": true,
  "data": {
    "result": "掘金工具处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "juejin"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}