Scholar Search — Busca Unificada de Artigos Acadêmicos
zhdzh12138/scholar-search
Busca unificada IEEE + ScienceDirect + CNKI com autenticação institucional
Ver no GitHubMCP server que integra busca e download de artigos científicos de IEEE Xplore, ScienceDirect e CNKI (知网) através de uma conexão Chrome via CDP. Suporta autenticação institucional (CARSI) com persistência automática de cookies, eliminando a necessidade de login repetido.
Instalação
npx convez-ai zhdzh12138/scholar-search1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Pesquisadores buscando artigos em português, inglês e chinês de forma centralizada
- Estudantes acadêmicos baixando PDFs de bases restritas via acesso institucional
- Automação de coleta de literatura científica em fluxos de pesquisa
Veredito

Solução robusta e bem arquitetada para pesquisa acadêmica em ambiente corporativo/institucional. Requer setup local (Chrome + Python) e credenciais de instituição. Ideal para pesquisadores que precisam de automação cross-database com autenticação real.
README
A tradução para o português deste README ainda está na fila.
Scholar Search — 学术论文搜索下载 MCP
通过 CDP 连接用户真实 Chrome,一站式搜索和下载 IEEE / ScienceDirect / CNKI 论文。
无需自动化登录 — 用户手动登录一次,cookie 自动保存恢复。
chrome --remote-debugging-port=9222 ← 自动启动(如未运行)
↓
CDP 连接 (carsi_search/engine.py) ← cookie 保存/恢复
↓
┌──────────┬───────────┬──────────┐
│ IEEE │Elsevier │ CNKI │
│ CARSI │ CARSI │ CDP │
└──────────┴───────────┴──────────┘
安装
git clone https://github.com/zhdzh12138/scholar-search.git ~/scholar-search
cd ~/scholar-search
pip install playwright mcp
python -m playwright install chromium
注册 MCP(全局配置,使用绝对路径):
claude mcp add cnki-ieee-download -- python ~/scholar-search/cnki-ieee-download/server.py
或编辑 .mcp.json(参考 .mcp.json.example):
{
"mcpServers": {
"cnki-ieee-download": {
"command": "python",
"args": ["C:/Users/你的用户名/scholar-search/cnki-ieee-download/server.py"],
"allowInteractive": true
}
}
}
allowInteractive: true允许 MCP server 在需要用户操作时(如登录、过验证码)向 Claude 发送交互提示。
MCP 工具
| 工具 | 说明 |
|---|---|
ieee_login | 连接 Chrome,检测 IEEE 登录状态 |
ieee_search | 搜索 IEEE 论文 |
ieee_detail | 获取 IEEE 论文详情 |
ieee_download | 下载 IEEE PDF |
sciencedirect_login | 连接 Chrome,检测 ScienceDirect 登录状态 |
sciencedirect_search | 搜索 ScienceDirect 论文 |
sciencedirect_detail | 获取 ScienceDirect 论文详情 |
sciencedirect_download | 下载 ScienceDirect PDF(可能需手动过 Cloudflare) |
cnki_search | 搜索 CNKI(自动连接 Chrome) |
cnki_login | 检测 CNKI 登录状态 |
cnki_detail | 获取 CNKI 论文详情 |
cnki_download | 下载 CNKI PDF/CAJ |
status | 显示 CDP 连接状态和各数据库登录状态 |
logout | 断开 CDP(不关闭 Chrome) |
首次使用
- 打开 Claude Code
- 首次调用 MCP 工具时自动启动 Chrome(带
--remote-debugging-port=9222) - 在 Chrome 窗口中手动登录:
- CNKI:点击"机构登录" → 校外访问 → 选择学校
- IEEE:点击"Institutional Sign In" → CARSI → 学校认证
- ScienceDirect:点击"Institutional Sign In" → CARSI → 学校认证
- Cookie 自动保存 — 后续启动无需重新登录
- 未登录时 Claude 会提示你在 Chrome 中登录
- PDF 下载到调用项目的
downloads/目录
功能覆盖
| 功能 | 数据源 | 实现 |
|---|---|---|
| 英文学术论文搜索 | IEEE Xplore | CDP + CARSI cookie |
| IEEE PDF 下载 | IEEE Xplore | CDP + CARSI cookie + JS fetch |
| 英文学术论文搜索/详情 | ScienceDirect | CDP + CARSI cookie |
| ScienceDirect PDF 下载 | ScienceDirect | CDP + CARSI cookie(Cloudflare 可能需手动验证) |
| 中文学术论文搜索/详情 | CNKI 知网 | CDP 连接真实 Chrome |
| CNKI PDF/CAJ 下载 | CNKI 知网 | CDP + expect_download |
项目结构
scholar-search/
├── cnki-ieee-download/ # MCP 服务器
│ ├── server.py # 入口 + 工具定义 + handler 函数
│ └── carsi_search/ # CDP 引擎 + 数据库适配器
├── downloads/ # PDF 下载目录
├── .mcp.json.example # MCP 配置模板
└── README.md
依赖
| 组件 | 必需 | 用途 |
|---|---|---|
| Claude Code | 是 | MCP 宿主 |
| Chrome | 是(自动启动) | CDP 连接真实浏览器 |
| Playwright + mcp | 是 | MCP 服务器运行时 |
| 机构账号 | 下载需要 | IEEE/ScienceDirect CARSI 认证;CNKI 机构登录 |
免责声明
- 本项目仅在西安电子科技大学账号下测试通过,其他学校的 CARSI 认证流程、域名、IdP 配置可能不同,需要对
carsi_search/registry.py中的sp_url、home_url、target_url_pattern等字段进行修改。 - 本项目仅供学术研究使用,请遵守各数据库的使用条款。
- Cookie 文件(
.carsi_state.json)包含登录凭证,请勿提交到公开仓库。
致谢
- cnki-skills — CNKI 知网 Skills
- cnki-codex-skills — CDP 连接模式参考
License
MIT