paper-search-cli 0.1.3 → 0.2.0

package/dist/services/JournalMetricsService.js

@@ -0,0 +1,142 @@
+import axios from 'axios';
+const EASYSCHOLAR_URL = 'https://www.easyscholar.cc/open/getPublicationRank';
+const REQUEST_DELAY_MS = 500;
+function easyScholarKey() {
+    const key = process.env.EASYSCHOLAR_KEY || process.env.PAPER_SEARCH_EASYSCHOLAR_KEY || '';
+    if (!key.trim()) {
+        throw new Error('EasyScholar API key not configured. Set EASYSCHOLAR_KEY with `paper-search setup EASYSCHOLAR_KEY`.');
+    }
+    return key.trim();
+}
+function uniqueJournals(journals) {
+    const seen = new Set();
+    const unique = [];
+    for (const journal of journals.map(item => item.trim()).filter(Boolean)) {
+        if (seen.has(journal))
+            continue;
+        seen.add(journal);
+        unique.push(journal);
+    }
+    return unique;
+}
+function stringValue(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed || undefined;
+}
+function extractZone(value) {
+    const text = stringValue(value);
+    const match = text?.match(/(\d+)区/);
+    return match?.[1];
+}
+function extractSmallZones(value) {
+    const text = stringValue(value);
+    if (!text)
+        return undefined;
+    const matches = [...text.matchAll(/([^/。；;]+?)([1-4])区/g)].map(match => `${match[1].trim()}${match[2]}区`);
+    return matches.length ? matches : undefined;
+}
+function normalizeOfficialRank(all) {
+    const casUpgraded = stringValue(all.sciUp);
+    const casBase = stringValue(all.sciBase);
+    const casSmall = stringValue(all.sciUpSmall);
+    const core = {
+        impact_factor: stringValue(all.sciif),
+        impact_factor_5y: stringValue(all.sciif5),
+        jcr_quartile: stringValue(all.sci),
+        ssci_quartile: stringValue(all.ssci),
+        jci: stringValue(all.jci),
+        cas_base: casBase,
+        cas_upgraded: casUpgraded,
+        cas_small: casSmall,
+        cas_top: stringValue(all.sciUpTop),
+        cas_zone: extractZone(casUpgraded) || extractZone(casBase),
+        cas_small_zones: extractSmallZones(casSmall),
+        esi: stringValue(all.esi),
+        warning: stringValue(all.sciwarn),
+        pku: stringValue(all.pku),
+        cssci: stringValue(all.cssci),
+        cscd: stringValue(all.cscd),
+        ahci: stringValue(all.ahci),
+        ccf: stringValue(all.ccf),
+        ei: stringValue(all.eii),
+        china_st_core: stringValue(all.zhongguokejihexin)
+    };
+    return Object.fromEntries(Object.entries(core).filter(([, value]) => value !== undefined));
+}
+function formatResult(journal, data, includeRaw) {
+    if (data.code !== 200 || data.msg !== 'SUCCESS' || !data.data) {
+        return {
+            journal,
+            status: 'not_found',
+            source: 'easyScholar',
+            message: data.msg || `EasyScholar returned code ${data.code ?? 'unknown'}`,
+            core: {}
+        };
+    }
+    const officialAll = data.data.officialRank?.all || {};
+    const officialSelect = data.data.officialRank?.select || {};
+    if (Object.keys(officialAll).length === 0) {
+        return {
+            journal,
+            status: 'not_found',
+            source: 'easyScholar',
+            message: 'No officialRank.all fields returned for this journal.',
+            core: {}
+        };
+    }
+    const row = {
+        journal,
+        status: 'found',
+        source: 'easyScholar',
+        core: normalizeOfficialRank(officialAll)
+    };
+    if (includeRaw) {
+        row.official_all = officialAll;
+        row.official_select = officialSelect;
+        row.custom_rank = data.data.customRank || {};
+    }
+    return row;
+}
+async function delay(ms) {
+    await new Promise(resolve => setTimeout(resolve, ms));
+}
+export async function queryJournalMetrics(options) {
+    const secretKey = easyScholarKey();
+    const journals = uniqueJournals(options.journals);
+    if (journals.length === 0) {
+        throw new Error('Provide at least one journal name.');
+    }
+    const rows = [];
+    for (let index = 0; index < journals.length; index += 1) {
+        const journal = journals[index];
+        try {
+            const response = await axios.get(EASYSCHOLAR_URL, {
+                params: {
+                    secretKey,
+                    publicationName: journal
+                },
+                timeout: 15000,
+                headers: {
+                    'User-Agent': 'Paper-Search-CLI/JournalMetrics'
+                }
+            });
+            rows.push(formatResult(journal, response.data, Boolean(options.includeRaw)));
+        }
+        catch (error) {
+            rows.push({
+                journal,
+                status: 'error',
+                source: 'easyScholar',
+                message: error?.message || String(error),
+                core: {}
+            });
+        }
+        if (index < journals.length - 1) {
+            await delay(REQUEST_DELAY_MS);
+        }
+    }
+    return rows;
+}
+//# sourceMappingURL=JournalMetricsService.js.map

package/dist/services/JournalMetricsService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JournalMetricsService.js","sourceRoot":"","sources":["../../src/services/JournalMetricsService.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paper-search-cli",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "Agent-friendly CLI for searching and downloading academic papers from multiple sources.",
   "main": "dist/cli.js",
   "type": "module",

package/skills/paper-search/SKILL.md

@@ -4,11 +4,13 @@ description: |
   学术文献检索与论文获取调度器，基于 paper-search CLI，而不是 MCP server。
   用于：搜索论文、查找相似研究、做文献综述初筛、验证 PMID/DOI、下载论文 PDF、
   调用 Crossref/OpenAlex/PubMed/PMC/Europe PMC/arXiv/bioRxiv/medRxiv/Semantic Scholar/CORE/OpenAIRE/DBLP/ACM/USENIX/OpenReview/IACR 等来源，
-  以及使用 Semantic Scholar Open Access snippet 索引检索论文正文片段中的方法学细节。
+  使用 Semantic Scholar Open Access snippet 索引检索论文正文片段中的方法学细节，
+  以及通过 EasyScholar 查询期刊影响因子、JCR/SSCI 分区、中科院分区、JCI、ESI、预警和等级指标。
   当用户提到“搜文献”“找论文”“文献检索”“search papers”“find papers”“literature search”
   “查一下有没有相关研究”“帮我找几篇参考文献”“看看别人怎么做的”“下载论文 PDF”
   “验证 PMID”“验证 DOI”“正文片段检索”“snippet search”“Methods 里怎么做的”
-  “方法学细节检索”等任务时使用。
+  “方法学细节检索”“影响因子”“IF”“JCR 分区”“中科院分区”“期刊分区”
+  “期刊等级”“目标期刊指标”“journal metrics”等任务时使用。
   此 skill 只负责指导 agent 调用 paper-search CLI；API key 必须通过 paper-search setup、
   paper-search config、.env 或环境变量配置，绝不要写入 Skill 文件。
 ---
@@ -26,7 +28,7 @@ command -v paper-search
 paper-search status --pretty
 ```
 
-如果涉及 Semantic Scholar 正文片段、CORE、Unpaywall、Web of Science、IEEE Xplore、Scopus、ScienceDirect、Springer/SpringerLink 或 Wiley 等需要 key/邮箱的能力，再运行：
+如果涉及 Semantic Scholar 正文片段、EasyScholar 期刊指标、CORE、Unpaywall、Web of Science、IEEE Xplore、Scopus、ScienceDirect、Springer/SpringerLink 或 Wiley 等需要 key/邮箱的能力，再运行：
 
 ```bash
 paper-search config doctor --pretty
@@ -37,6 +39,7 @@ paper-search config doctor --pretty
 ```bash
 paper-search setup
 paper-search config set SEMANTIC_SCHOLAR_API_KEY your_key
+paper-search setup EASYSCHOLAR_KEY
 paper-search config doctor --pretty
 ```
 
@@ -87,6 +90,20 @@ paper-search run get_paper_by_doi --arg doi="10.xxxx/xxxxx" --pretty
 paper-search run search_semantic_scholar --json-args '{"query":"graph neural network medicine","maxResults":5,"year":"2020-2025"}' --pretty
 ```
 
+### 期刊指标查询
+
+当用户询问影响因子、JCR/SSCI 分区、中科院分区、JCI、ESI、预警、北大核心、南大核心、CSCD、A&HCI、CCF、EI 或目标期刊等级时，使用 EasyScholar 原生 CLI 工具，而不是通用论文检索。
+
+```bash
+paper-search journal-metrics "Nature" "BMJ" --pretty
+paper-search journal-metrics --file journals.txt --include-raw --pretty
+paper-search run query_journal_metrics --json-args '{"journals":["Nature"],"includeRaw":true}' --pretty
+```
+
+返回时优先解释标准化的 `core` 字段：`impact_factor`、`impact_factor_5y`、`jcr_quartile`、`ssci_quartile`、`jci`、`cas_base`、`cas_upgraded`、`cas_small`、`cas_top`、`cas_zone`、`esi`、`warning`、`pku`、`cssci`、`cscd`、`ahci`、`ccf`、`ei`、`china_st_core`。如果需要完整字段，使用 `--include-raw` 并检查 `official_all`、`official_select`、`custom_rank`。
+
+EasyScholar 文档要求每秒最多 2 次请求；批量查询时不要并发调用。
+
 ### 下载 PDF
 
 ```bash
@@ -107,6 +124,7 @@ paper-search run download_with_fallback --json-args '{"source":"crossref","paper
 | 计算机文献目录/会议元数据 | `dblp` | `acm`, `usenix`, `openreview`, `ieee` 需要 key |
 | 跨学科广覆盖 | `crossref` | `openalex`, `semantic` |
 | 开放获取全文发现 | `pmc`, `europepmc`, `core`, `openaire`, `unpaywall` | `download_with_fallback` |
+| 期刊影响因子/分区/等级 | `journal-metrics` | `query_journal_metrics` |
 | 密码学 | `iacr` | `arxiv` |
 | 引用统计排序 | `semantic`, `crossref`, `openalex` | `webofscience`, `scopus` 需要 key |
 | 出版商/付费数据库 | `webofscience`, `ieee`, `scopus`, `sciencedirect`, `springer`/`springerlink`, `wiley` | 仅在 key 已配置时使用 |
@@ -190,7 +208,9 @@ paper-search run search_crossref --arg query="full paper title" --arg maxResults
 |---|---|
 | CLI 不存在 | 提示安装 `npm install -g paper-search-cli` |
 | API key 缺失 | 提示运行 `paper-search setup`；不要索要或保存 key |
+| EasyScholar key 缺失 | 提示运行 `paper-search setup EASYSCHOLAR_KEY`；不要让用户在聊天中发送 SecretKey |
 | 429 限流 | 降低 `--max-results`，换平台，或提示配置可选 key |
+| EasyScholar 批量查询 | 控制在每秒最多 2 次请求；优先使用单次 `journal-metrics` 多期刊输入，不要并发 |
 | 0 结果 | 放宽关键词，换英文同义词，换平台，或用 `--sources` 扩展 |
 | 下载失败 | 优先开放获取来源和 `download_with_fallback`，报告失败原因 |
 | 用户要求完整正文 | 先下载 PDF；再交给当前环境可用的 PDF/MinerU 解析流程 |
@@ -200,4 +220,3 @@ paper-search run search_crossref --arg query="full paper title" --arg maxResults
 - 不管理 Zotero、Obsidian 或其他文献库。
 - 不写论文正文，不做语言润色。
 - 不把 API key、token、cookie 写入 Skill、README 或回复。
-- 当前公开 CLI 不提供期刊 IF、JCR 分区或中科院分区查询；遇到这类请求时说明能力边界，除非用户另行指定本地私有工具。