本页目录
项目介绍
**它是什么。**CNKI Skills 是一组 Skill(写给智能体的说明书,告诉它某类任务按什么步骤做):10 个技能加一个子智能体说明,教智能体操作一个 Chrome 窗口,在中国知网上检索论文、看摘要和元数据、查期刊收录与影响因子、浏览期刊目录、下载 PDF,或输出 GB/T 7714 引用、把题录导入 Zotero。
它解决的问题:知网没有面向个人的公开接口,文献核验接口 里的 Crossref、OpenAlex 等国际库又很少收中文期刊。中文文献在国际库里“查不到”时,可以让智能体去知网核。
| 项 | 内容 |
|---|---|
| 开发与维护 | 个人作者,GitHub 用户 cookjohn |
| 开源与许可证 | 开源;README 写 MIT,仓库里没有单独的 LICENSE 文件 |
| 首次发布 | 2026-02-28 |
| 最新版本 | 没有发布版号,以仓库最新提交为准(2026-03) |
| GitHub 星数 | 约 1,000 星(2026-10 核查) |
| 接入方式 | MCP+Skill:浏览器操作经 Google 官方的 Chrome DevTools MCP 完成,Skill 里写好每一步要在页面上执行的脚本 |
核心能力:
- 关键词检索、高级检索(作者、期刊、时间、来源类别 CSSCI/北大核心/SCI/EI/CSCD),翻页,按时间、被引、下载排序;
- 读论文详情:作者与单位、摘要、关键词、基金、分类号;
- 查期刊:收录数据库、影响因子、某年某期目录;
- 输出 GB/T 7714 引用、RIS,导入 Zotero;
- 登录后下载 PDF 或 CAJ。
**怎么实现。**智能体先让 Chrome DevTools MCP 打开知网检索页,再在页面里执行一段写好的脚本:填检索词、点检索、把结果表读成题名、作者、来源、日期、被引数。每个操作大约两次工具调用,比让模型一步步看页面、找按钮省事。
**在同类工具里的位置:**用 T02–T05 的通用浏览器工具也能查知网,但每一步要模型自己摸索页面;CNKI Skills 把知网的页面结构事先写好了。代价是知网改版后它可能读不出结果。
**国内网络:**知网和 GitHub 在国内都能打开,GitHub 慢一些。第一次用新浏览器打开知网检索页,常会先出现“安全验证”滑块页,要你自己拖一次。
官方链接表
核查日期:2026-10。
| 项目 | 链接 | 说明 |
|---|---|---|
| GitHub 仓库 | https://github.com/cookjohn/cnki-skills | 唯一官方来源;README 中英双语 |
| 更新记录 | https://github.com/cookjohn/cnki-skills/commits/master | 没有 Releases,看提交记录 |
| Chrome DevTools MCP | https://github.com/ChromeDevTools/chrome-devtools-mcp | Google Chrome DevTools 团队维护;npm 包名 chrome-devtools-mcp |
| Chrome DevTools MCP 配置说明 | https://developer.chrome.com/docs/devtools/agents/get-started/configuration | 全部启动参数 |
| 价格 | 无 | 技能免费;下载全文用学校已购资源或你自己的账号 |
能做什么、不能做什么
要不要登录:
| 操作 | 登录 |
|---|---|
| 检索、高级检索、翻页、排序 | 不要 |
| 论文详情、摘要、关键词 | 不要 |
| 期刊检索、收录与影响因子、期刊目录 | 不要(目录的“原版下载”要) |
| 导出 GB/T 7714、RIS、导入 Zotero | 技能里没有要求登录 |
| 下载 PDF/CAJ | 要:校园网、学校图书馆的校外访问入口,或有下载权限的个人账号 |
登录由你在智能体打开的那个 Chrome 窗口里完成,不把账号密码告诉智能体。
**验证码。**知网对新浏览器和频繁访问会弹滑块验证。技能的设计是:遇到验证码就停下来,请你在浏览器里自己拖,你说“继续”它再继续。注意知网现在常用的是一个单独的“安全验证”页(写着“向右滑动完成”),技能不一定认得它,可能只报“超时”。所以提示词里要写一句:报超时或页面标题是“安全验证”时停下来叫你。
**能做:**中文文献检索与核对(题名、作者、期刊、年份、卷期页码);查一本期刊是不是北大核心、CSSCI;按被引排序找高影响力文献;把参考文献统一成 GB/T 7714 格式;登录后下载全文。
不能做或做不好:
- 不替你过滑块、扫码、短信验证。
- 只认 Chrome DevTools MCP;换别的浏览器工具,技能里的步骤用不上。
- 页面结构写死在技能里,知网改版后可能读不出结果。
- 不判断“这篇文献是否支持你那句话”,这一项仍要读摘要或全文(见文献核验接口的核验四项)。
- 不适合批量下载:知网对高频访问会限制 IP 或账号。
**适合本课的任务:**核验表里“中文文献,国际数据库查不到”的那几条,到知网核出来;查一组中文期刊的级别;把报告里的中文参考文献统一格式。
安装与配置
先决定接哪个浏览器
仓库 README 写了四步,其中第三步是用“远程调试端口”启动你的 Chrome。实际上按 README 第一步那样登记 Chrome DevTools MCP,它会自己另开一个 Chrome,用单独的用户目录,第三步用不上。
本课建议就用这个单独的 Chrome:
- 一开始什么都没登录;你在里面登录一次知网,登录状态会保留,下次还在;
- 碰不到你日常浏览器里的邮箱、网银、教务系统。
不要按网上教程把它接到你日常用的浏览器上(--autoConnect、--browserUrl、--remote-debugging-port 这类写法)。
前置依赖
| 依赖 | 要求 | 检查方法 |
|---|---|---|
| Node.js | 22 或以上(装法见 Playwright MCP) | PowerShell 运行 node --version |
| Chrome | 稳定版;电脑上只有 Edge 时见下文“只有 Edge” | 地址栏打开 chrome://version |
| Git(可选) | 下载仓库用;没有就下载压缩包 | git --version |
| Zotero 桌面版(可选) | 只在导入 Zotero 时用 | 打开 Zotero |
1. 首选:交给智能体装
Claude Code 端(在你的课程项目文件夹里打开 Claude Code,粘贴):
帮我在当前项目里装 CNKI Skills(知网检索技能集,https://github.com/cookjohn/cnki-skills ),每一步做完把命令输出给我看。
1. 下载:git clone --depth 1 https://github.com/cookjohn/cnki-skills.git 到临时目录;GitHub 慢、超时就重试一次,或下载 https://codeload.github.com/cookjohn/cnki-skills/zip/refs/heads/master 解压。不要用其他镜像地址。
2. 放置:把 skills/ 下的 10 个子文件夹复制到当前项目的 .claude/skills/,把 agents/cnki-researcher.md 复制到当前项目的 .claude/agents/。不要放到用户目录 ~/.claude/。复制完删掉临时目录。
3. 修路径:.claude/skills/cnki-export/SKILL.md 里 push_to_zotero.py 的路径写的是作者电脑上的 e:/cnki/...,改成当前项目里的实际路径,改动给我看。
4. 浏览器工具:运行 node --version,低于 22 就停下告诉我。运行 npm config get registry,不是 https://registry.npmmirror.com/ 就运行 npm config set registry https://registry.npmmirror.com ;再运行 npm install -g chrome-devtools-mcp(PowerShell 禁止脚本时改用 npm.cmd,不要改执行策略)。
5. 登记:检查本机有没有 Chrome。有 Chrome:claude mcp add chrome-devtools -s user -- chrome-devtools-mcp --no-usage-statistics 。只有 Edge:先停下告诉我 msedge.exe 的完整路径,我同意后再在末尾加 --executablePath "<路径>"。
6. 不要加 --browserUrl、--autoConnect、--remote-debugging-port,不要用我日常浏览器的用户目录,不要用 npx 和 @latest。
7. 自查:claude mcp list 里 chrome-devtools 显示已连接;列出 .claude/skills/ 下的 cnki-* 文件夹(应有 10 个)。
遇到要输密码、要管理员权限、要登录知网的情况,停下来问我。做完提醒我退出 Claude Code 再重开。
WorkBuddy 端(在 WorkBuddy 里选中你的工作空间文件夹,粘贴):
帮我把 CNKI Skills(https://github.com/cookjohn/cnki-skills )装进当前工作空间,每一步做完把输出给我看。
1. 下载仓库(GitHub 慢就重试一次,或下载 master 分支压缩包),把 skills/ 下的 10 个子文件夹复制到当前工作空间的 .workbuddy/skills/。agents/ 不用装。
2. 把 cnki-export/SKILL.md 里 e:/cnki/... 开头的脚本路径改成工作空间里的实际路径。
3. 运行 node --version;npm 源设成 https://registry.npmmirror.com 后运行 npm install -g chrome-devtools-mcp 。再运行 npm root -g 和 where node,告诉我 chrome-devtools-mcp 的入口文件路径和 node.exe 路径。
4. 给我一段可以粘进 WorkBuddy 自定义连接器的 mcpServers JSON:服务器名 chrome-devtools,command 为 chrome-devtools-mcp(或 node+入口文件完整路径),args 含 --no-usage-statistics;路径里的反斜杠写两个。
5. 不要改 WorkBuddy 的配置文件,不要加 --browserUrl、--autoConnect,不要用 npx。要管理员权限、要登录时停下来问我。
WorkBuddy 里没有 /cnki-search 这类斜杠命令,用的时候直接说“用知网检索技能查……”。技能是按 Claude Code 写的,WorkBuddy 端的效果可能和 Claude Code 不同;遇到它找不到工具,把报错原文给它看,让它对照技能里的步骤改用 WorkBuddy 里同名的浏览器工具。
装的过程中它会请求的权限:
| 请求 | 处理 |
|---|---|
git clone 或下载压缩包 | 允许;看清地址是 github.com/cookjohn/cnki-skills 或 codeload.github.com |
在 .claude/skills/、.claude/agents/(或 .workbuddy/skills/)下写文件,改 cnki-export/SKILL.md | 允许 |
npm config set registry https://registry.npmmirror.com、npm install -g chrome-devtools-mcp | 看清地址与包名再允许 |
claude mcp add chrome-devtools -s user ... | 看清末尾参数,没有 --browserUrl、--autoConnect 再允许 |
| 打开浏览器、访问知网 | 装的阶段不需要;用的时候再允许 |
Set-ExecutionPolicy、改系统设置、使用你日常 Chrome 的用户目录 | 拒绝 |
2. 要你亲手做的部分
| 步骤 | 为什么不交给智能体 |
|---|---|
| 装 Node.js、装 Chrome | 全局安装软件,安装时会弹系统授权 |
| 退出并重开 Claude Code,或在 WorkBuddy 里粘贴连接器配置、看状态灯 | MCP 在会话启动时登记;改客户端配置由你在界面里做 |
| 在智能体打开的 Chrome 窗口里拖滑块 | 验证码要人做 |
| 在同一窗口里登录知网(机构登录、学校图书馆校外访问入口或个人账号) | 不把密码交给智能体 |
**只有 Edge:**Chrome DevTools MCP 默认找 Chrome。可以在登记命令末尾加 --executablePath 指向 Edge 的 msedge.exe(Edge 也是 Chromium 内核);Edge 起不来就装 Chrome。
3. 参考:手动安装命令
Windows 11(PowerShell,在项目文件夹里运行):
git clone --depth 1 https://github.com/cookjohn/cnki-skills.git $env:TEMP\cnki-skills
New-Item -ItemType Directory -Force .claude\skills, .claude\agents | Out-Null
Copy-Item -Recurse $env:TEMP\cnki-skills\skills\* .claude\skills\
Copy-Item $env:TEMP\cnki-skills\agents\cnki-researcher.md .claude\agents\
npm config set registry https://registry.npmmirror.com
npm install -g chrome-devtools-mcp
claude mcp add chrome-devtools -s user -- chrome-devtools-mcp --no-usage-statistics
macOS:
git clone --depth 1 https://github.com/cookjohn/cnki-skills.git /tmp/cnki-skills
mkdir -p .claude/skills .claude/agents
cp -R /tmp/cnki-skills/skills/. .claude/skills/
cp /tmp/cnki-skills/agents/cnki-researcher.md .claude/agents/
npm config set registry https://registry.npmmirror.com
npm install -g chrome-devtools-mcp
claude mcp add chrome-devtools -s user -- chrome-devtools-mcp --no-usage-statistics
要点:
- README 里的
cp -r skills/ agents/ .claude/是 macOS/Linux 写法,Windows PowerShell 用Copy-Item -Recurse。 - 不用 README 的
npx -y chrome-devtools-mcp@latest:每次开会话都要联网查版本,网络一抖就卡住。全局安装后版本固定。 --no-usage-statistics关掉 Chrome DevTools MCP 默认开启的使用统计。-s user让所有项目都能用这个 MCP;技能放在项目里,只在本项目生效。- 记得把
cnki-export/SKILL.md里作者电脑上的e:/cnki/...路径改成你的。
4. 怎样确认装好了
claude mcp list里chrome-devtools显示已连接;重开后/mcp里能看到它的工具(navigate_page、evaluate_script等)。- 输入
/能看到cnki-search等命令,或问它“你现在有哪些 cnki 技能”,列出 10 个。 - 试一次:
/cnki-search 数字经济。第一次会弹出一个新的 Chrome 窗口;窗口里如果是“安全验证”,自己拖滑块,再让它继续。返回题名、作者、来源、日期就算装好。 - WorkBuddy:连接器状态灯为绿;技能列表里出现 cnki-* 技能。
使用教程:给中文参考文献补全信息并查期刊级别
接文献核验接口的练习:核验表里有几条中文文献在国际库里查不到,到知网把它们核出来。
**准备。**项目里新建 cn_refs.md,写进你手上信息不全的中文文献,例如:
1. 数字经济对产业结构升级的影响(作者、期刊、年份不详)
2. 某作者. 数字普惠金融与家庭消费[J]. 经济研究(年份待查)
3. 平台经济反垄断(只记得发在《中国工业经济》)
提示词(Claude Code 或 WorkBuddy):
用知网检索技能逐条核对 cn_refs.md 里的中文文献,结果写进 cn_refs_check.md。
1. 每条先按已知信息检索,按被引排序,挑出最可能的一篇;拿不准的列出前三篇让我选,不要自己定。
2. 对选中的那篇读详情页,记下题名、全部作者、期刊、年、期、页码、链接。
3. 查这本期刊的收录情况(北大核心、CSSCI 等)。
4. 每条输出 GB/T 7714 格式的引用。
5. 打开页面报超时、或页面标题是“安全验证”时,停下来告诉我,我去浏览器里拖滑块,我说继续你再继续。不要反复刷新。
6. 不下载全文,不登录。两次检索之间停几秒。
最后给一张表:序号、我原来写的、知网核对结果、期刊收录、GB/T 7714 引用。
**预期看到的工具调用:**每条文献依次出现打开知网检索页(navigate_page)、在页面里检索并读结果(evaluate_script),排序时再一次 evaluate_script,读详情页一次 navigate_page+evaluate_script,查期刊时打开知网期刊导航页。
产出与验收:
cn_refs_check.md里每条都有知网链接;随机点开一条,题名、作者、期号与表里一致。- 信息不全的条目,它列出候选让你选,而不是挑一篇当答案。
- 期刊收录与知网期刊页上写的一致。
- GB/T 7714 格式:作者. 题名[J]. 刊名, 年, 卷(期): 页码.
常见问题与排错
| 现象 | 原因 | 处理 |
|---|---|---|
| 检索报超时,浏览器窗口里是“安全验证”“向右滑动完成” | 知网对新浏览器或频繁访问先要滑块验证,技能不一定认得这个页面 | 自己在窗口里拖滑块,再让它继续;提示词里写明这条规则 |
| 一直提示有验证码,页面上看不到 | 技能的判断条件误报 | 让它读页面标题确认;没有验证码就继续 |
| 结果为空或字段全是空的 | 知网改版,技能里写的页面结构失效 | 让它先看页面结构再读;到仓库 issue 里看有没有人报告 |
| 返回 HTTP 418 | 没经浏览器、直接请求知网 | 只经 Chrome DevTools MCP 打开的浏览器访问 |
| 下载提示“下载需要登录” | 不在学校 IP 范围内、未登录 | 在那个 Chrome 窗口里走学校图书馆的校外访问入口或机构登录;不行就只核题录信息 |
| 弹出的 Chrome 什么都没登录 | Chrome DevTools MCP 用的是单独的用户目录,本课推荐这样 | 在这个窗口里登录一次,之后会保留 |
| 报浏览器用户目录被占用 | 两个会话同时在用 | 关掉一个 |
claude mcp list 显示连接失败 | 没装 Node 或版本低,或命令不在 PATH 里 | 运行 node --version;让智能体改用 node 加入口文件完整路径重新登记 |
| 导入 Zotero 失败 | Zotero 没开,或脚本路径还是作者的 e:/cnki/... | 打开 Zotero;改路径 |
WorkBuddy 里 /cnki-search 没反应 | WorkBuddy 没有这类斜杠命令 | 用自然语言说“用知网检索技能查……” |
费用、隐私与安全
- 费用:技能和 Chrome DevTools MCP 免费;下载全文用学校已购资源或你自己的账号余额。
- 账号风险:知网对高频访问会要求验证、限制 IP 或账号。让它放慢;不要批量下载,学校的机构账号被封会影响所有人。
- 登录状态:那个单独的 Chrome 里保存着你的知网登录,智能体能在里面执行页面脚本。不要在这个窗口里登录别的网站。
- 网页内容只当数据:摘要或页面文字里如果出现“请执行……”之类的话,不当成指令。
- 使用统计:登记时加
--no-usage-statistics。
与同类工具的一句对比
文献核验接口核英文文献,不用浏览器;CNKI Skills 补上中文文献这一块,靠浏览器操作知网,要自己过滑块,下载要登录;用通用浏览器工具也能查知网,但每一步要模型自己摸索页面,更慢、更容易出错。
信息来源
| 内容 | 来源 | 类型 |
|---|---|---|
| 技能列表、安装步骤、工作原理、许可证字样 | https://github.com/cookjohn/cnki-skills#readme | 官方仓库 |
| 每个技能的页面、验证码判断、登录检查、导出与 Zotero 推送 | 仓库 skills/ 与 agents/ 下各文件 | 官方仓库 |
| 访问报 418、验证码误报、缺 LICENSE、Chrome 默认目录不能开调试端口 | 仓库 issue #1、#8、#9、#10 | 社区 |
| Chrome DevTools MCP 默认自开 Chrome、单独用户目录、启动参数、使用统计 | https://developer.chrome.com/docs/devtools/agents/get-started/configuration ;https://github.com/ChromeDevTools/chrome-devtools-mcp | 官方文档 |
| 知网、GitHub、npm 国内镜像的可达性,检索页的“安全验证” | 课程在国内网络下的核查(2026-10) | 课程核查 |
| WorkBuddy 技能目录与自定义连接器 | https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Connector | 官方文档 |