paper-search-cli 0.1.0

package/dist/platforms/SemanticScholarSearcher.js

@@ -0,0 +1,419 @@
+/**
+ * Semantic Scholar API集成模块
+ * 支持免费API和付费API密钥
+ */
+import axios from 'axios';
+import * as fs from 'fs';
+import * as path from 'path';
+import { PaperFactory } from '../models/Paper.js';
+import { PaperSource } from './PaperSource.js';
+import { RateLimiter } from '../utils/RateLimiter.js';
+import { ErrorHandler } from '../utils/ErrorHandler.js';
+import { RequestCache } from '../utils/RequestCache.js';
+import { sanitizeDoi } from '../utils/SecurityUtils.js';
+import { TIMEOUTS, USER_AGENT } from '../config/constants.js';
+import { logDebug } from '../utils/Logger.js';
+import { downloadPdfFromUrl, safeFilename } from '../utils/PdfDownload.js';
+export class SemanticScholarSearcher extends PaperSource {
+    rateLimiter;
+    cache;
+    baseApiUrl;
+    constructor(apiKey) {
+        super('semantic', 'https://api.semanticscholar.org/graph/v1', apiKey);
+        this.baseApiUrl = this.baseUrl;
+        // Semantic Scholar免费API限制：100 requests per 5 minutes
+        // 付费API: 1000 requests per 5 minutes
+        // 更保守的速率限制以避免被封
+        const requestsPerMinute = apiKey ? 180 : 18; // 有API密钥时更宽松
+        this.rateLimiter = new RateLimiter({
+            requestsPerSecond: requestsPerMinute / 60,
+            burstCapacity: Math.max(3, Math.floor(requestsPerMinute / 20)), // 降低突发容量
+            debug: process.env.NODE_ENV === 'development'
+        });
+        this.cache = new RequestCache({
+            maxSize: 100,
+            ttlMs: 3600000 // 1 hour
+        });
+    }
+    getCapabilities() {
+        return {
+            search: true,
+            download: true, // 部分论文有开放获取PDF
+            fullText: false, // 只有部分PDF
+            citations: true, // 提供引用统计
+            requiresApiKey: false, // 免费API可用，但有限制
+            supportedOptions: ['maxResults', 'year', 'fieldsOfStudy', 'sortBy']
+        };
+    }
+    /**
+     * 搜索Semantic Scholar论文
+     */
+    async search(query, options = {}) {
+        const customOptions = options;
+        const forceRefresh = customOptions.forceRefresh === true;
+        // Check cache first
+        if (!forceRefresh) {
+            const cacheKey = this.cache.generateKey('semantic', query, options);
+            const cached = this.cache.get(cacheKey);
+            if (cached) {
+                return cached;
+            }
+        }
+        await this.rateLimiter.waitForPermission();
+        try {
+            const params = {
+                query: query,
+                limit: Math.min(options.maxResults || 10, 100), // API限制最大100
+                fields: [
+                    'paperId', 'title', 'abstract', 'venue', 'year',
+                    'referenceCount', 'citationCount', 'influentialCitationCount',
+                    'isOpenAccess', 'openAccessPdf', 'fieldsOfStudy', 's2FieldsOfStudy',
+                    'publicationTypes', 'publicationDate', 'journal', 'authors',
+                    'externalIds', 'url'
+                ].join(',')
+            };
+            // 添加年份过滤
+            if (options.year) {
+                params.year = options.year;
+            }
+            // 添加研究领域过滤
+            if (options.fieldsOfStudy && options.fieldsOfStudy.length > 0) {
+                params.fieldsOfStudy = options.fieldsOfStudy.join(',');
+            }
+            const url = `${this.baseApiUrl}/paper/search`;
+            const headers = {
+                'User-Agent': USER_AGENT,
+                'Accept': 'application/json',
+                'Accept-Language': 'en-US,en;q=0.9'
+            };
+            // 添加API密钥（如果有）- 根据官方文档推荐的方式
+            if (this.apiKey) {
+                headers['x-api-key'] = this.apiKey;
+            }
+            logDebug(`Semantic Scholar API Request: GET ${url}`);
+            logDebug('Semantic Scholar Request params:', params);
+            const response = await ErrorHandler.retryWithBackoff(() => axios.get(url, {
+                params,
+                headers,
+                timeout: TIMEOUTS.DEFAULT,
+                maxRedirects: 5,
+                validateStatus: (status) => status < 500
+            }), { context: 'Semantic Scholar search' });
+            logDebug(`Semantic Scholar API Response: ${response.status} ${response.statusText}`);
+            // 处理可能的错误响应
+            if (response.status >= 400) {
+                // Convert non-throwing 4xx response to unified error handling
+                this.handleHttpError({ response, config: response.config }, 'search');
+            }
+            const papers = this.parseSearchResponse(response.data);
+            logDebug(`Semantic Scholar Parsed ${papers.length} papers`);
+            // Cache results
+            const cacheKey = this.cache.generateKey('semantic', query, options);
+            this.cache.set(cacheKey, papers);
+            return papers;
+        }
+        catch (error) {
+            logDebug('Semantic Scholar Search Error:', error.message);
+            // 处理速率限制错误
+            if (error.response?.status === 429) {
+                const retryAfter = error.response.headers['retry-after'];
+                logDebug(`Rate limited by Semantic Scholar API. ${retryAfter ? `Retry after ${retryAfter} seconds.` : 'Please wait before making more requests.'}`);
+            }
+            // 处理API限制错误
+            if (error.response?.status === 403) {
+                logDebug('Access denied. Please check your API key or ensure you are within the free tier limits.');
+            }
+            this.handleHttpError(error, 'search');
+        }
+    }
+    /**
+     * 获取论文详细信息
+     */
+    async getPaperDetails(paperId) {
+        await this.rateLimiter.waitForPermission();
+        try {
+            const params = {
+                fields: [
+                    'paperId', 'title', 'abstract', 'venue', 'year',
+                    'referenceCount', 'citationCount', 'influentialCitationCount',
+                    'isOpenAccess', 'openAccessPdf', 'fieldsOfStudy', 's2FieldsOfStudy',
+                    'publicationTypes', 'publicationDate', 'journal', 'authors',
+                    'externalIds', 'url'
+                ].join(',')
+            };
+            const url = `${this.baseApiUrl}/paper/${paperId}`;
+            const headers = {
+                'User-Agent': USER_AGENT,
+                'Accept': 'application/json'
+            };
+            if (this.apiKey) {
+                headers['x-api-key'] = this.apiKey;
+            }
+            const response = await ErrorHandler.retryWithBackoff(() => axios.get(url, {
+                params,
+                headers,
+                timeout: TIMEOUTS.DEFAULT,
+                maxRedirects: 5,
+                validateStatus: (status) => status < 500
+            }), { context: 'Semantic Scholar paper details' });
+            return this.parseSemanticPaper(response.data);
+        }
+        catch (error) {
+            logDebug('Error getting paper details from Semantic Scholar:', error.message);
+            return null;
+        }
+    }
+    async searchSnippets(options) {
+        if (!this.apiKey) {
+            throw new Error('search_semantic_snippets requires SEMANTIC_SCHOLAR_API_KEY.');
+        }
+        await this.rateLimiter.waitForPermission();
+        try {
+            const params = {
+                query: options.query,
+                limit: Math.min(options.limit || 5, 1000)
+            };
+            const paperIds = this.listParam(options.paperIds);
+            const authors = this.listParam(options.authors);
+            const venue = this.listParam(options.venue);
+            const fieldsOfStudy = this.listParam(options.fieldsOfStudy);
+            const fields = this.listParam(options.fields);
+            if (paperIds.length > 0)
+                params.paperIds = paperIds.join(',');
+            if (authors.length > 0)
+                params.authors = authors.join(',');
+            if (venue.length > 0)
+                params.venue = venue.join(',');
+            if (fieldsOfStudy.length > 0)
+                params.fieldsOfStudy = fieldsOfStudy.join(',');
+            if (fields.length > 0)
+                params.fields = fields.join(',');
+            if (options.year)
+                params.year = options.year;
+            if (options.minCitationCount)
+                params.minCitationCount = options.minCitationCount;
+            if (options.publicationDateOrYear)
+                params.publicationDateOrYear = options.publicationDateOrYear;
+            const url = `${this.baseApiUrl}/snippet/search`;
+            const response = await ErrorHandler.retryWithBackoff(() => axios.get(url, {
+                params,
+                headers: {
+                    'User-Agent': USER_AGENT,
+                    Accept: 'application/json',
+                    'x-api-key': this.apiKey
+                },
+                timeout: TIMEOUTS.DEFAULT,
+                maxRedirects: 5,
+                validateStatus: status => status < 500
+            }), { context: 'Semantic Scholar snippet search' });
+            if (response.status >= 400) {
+                this.handleHttpError({ response, config: response.config }, 'snippet search');
+            }
+            const data = Array.isArray(response.data?.data) ? response.data.data : [];
+            return data.map(item => this.parseSnippet(item));
+        }
+        catch (error) {
+            this.handleHttpError(error, 'snippet search');
+        }
+    }
+    /**
+     * 下载PDF文件
+     */
+    async downloadPdf(paperId, options = {}) {
+        try {
+            // 首先获取论文详细信息以获取PDF URL
+            const paper = await this.getPaperDetails(paperId);
+            if (!paper?.pdfUrl) {
+                throw new Error(`No PDF URL available for paper ${paperId}`);
+            }
+            const savePath = options.savePath || './downloads';
+            return await downloadPdfFromUrl(paper.pdfUrl, savePath, `semantic_${safeFilename(paperId)}`, {
+                headers: {
+                    Referer: paper.url || 'https://www.semanticscholar.org/',
+                    'User-Agent': USER_AGENT
+                }
+            });
+        }
+        catch (error) {
+            this.handleHttpError(error, 'download PDF');
+        }
+    }
+    /**
+     * 读取论文全文内容
+     */
+    async readPaper(paperId, options = {}) {
+        try {
+            const savePath = options.savePath || './downloads';
+            const filename = `semantic_${paperId.replace(/[/\\:*?"<>|]/g, '_')}.pdf`;
+            const filePath = path.join(savePath, filename);
+            // 如果PDF不存在，先下载
+            if (!fs.existsSync(filePath)) {
+                await this.downloadPdf(paperId, options);
+            }
+            return `PDF file downloaded at: ${filePath}. Full text extraction requires additional PDF parsing implementation.`;
+        }
+        catch (error) {
+            this.handleHttpError(error, 'read paper');
+        }
+    }
+    /**
+     * 根据DOI获取论文信息
+     */
+    async getPaperByDoi(doi) {
+        // Clean and validate DOI
+        const doiResult = sanitizeDoi(doi);
+        if (!doiResult.valid) {
+            logDebug('Invalid DOI format:', doiResult.error);
+            return null;
+        }
+        try {
+            return await this.getPaperDetails(`DOI:${doiResult.sanitized}`);
+        }
+        catch (error) {
+            logDebug('Error getting paper by DOI from Semantic Scholar:', error);
+            return null;
+        }
+    }
+    /**
+     * 解析搜索响应
+     */
+    parseSearchResponse(data) {
+        if (!data.data || !Array.isArray(data.data)) {
+            return [];
+        }
+        return data.data.map(item => this.parseSemanticPaper(item))
+            .filter(paper => paper !== null);
+    }
+    /**
+     * 解析单个Semantic Scholar论文
+     */
+    parseSemanticPaper(item) {
+        try {
+            // 提取作者
+            const authors = item.authors?.map(author => author.name) || [];
+            // 提取发表日期
+            const publishedDate = item.publicationDate ?
+                this.parseDate(item.publicationDate) :
+                (item.year ? new Date(item.year, 0, 1) : null);
+            // 提取PDF URL
+            let pdfUrl = '';
+            if (item.openAccessPdf?.url) {
+                pdfUrl = this.normalizePdfUrl(item.openAccessPdf.url);
+            }
+            else if (item.openAccessPdf?.disclaimer) {
+                // 尝试从disclaimer中提取URL
+                const urlMatch = item.openAccessPdf.disclaimer.match(/https?:\/\/[^\s,)]+/);
+                if (urlMatch) {
+                    pdfUrl = this.normalizePdfUrl(urlMatch[0]);
+                }
+            }
+            // 提取DOI
+            const doi = item.externalIds?.DOI || '';
+            // 提取分类
+            const fieldsOfStudy = item.fieldsOfStudy || [];
+            const s2Fields = item.s2FieldsOfStudy?.map(field => field.category) || [];
+            const categories = [...fieldsOfStudy, ...s2Fields];
+            // 构建URL
+            const url = item.url || `https://www.semanticscholar.org/paper/${item.paperId}`;
+            return PaperFactory.create({
+                paperId: item.paperId,
+                title: this.cleanText(item.title),
+                authors: authors,
+                abstract: this.cleanText(item.abstract || ''),
+                doi: doi,
+                publishedDate: publishedDate,
+                pdfUrl: pdfUrl,
+                url: url,
+                source: 'semantic',
+                categories: [...new Set(categories)], // 去重
+                keywords: [],
+                citationCount: item.citationCount || 0,
+                journal: item.venue || item.journal?.name || '',
+                volume: item.journal?.volume || undefined,
+                pages: item.journal?.pages || undefined,
+                year: item.year,
+                extra: {
+                    semanticScholarId: item.paperId,
+                    referenceCount: item.referenceCount || 0,
+                    influentialCitationCount: item.influentialCitationCount || 0,
+                    isOpenAccess: item.isOpenAccess || false,
+                    publicationTypes: item.publicationTypes || [],
+                    externalIds: item.externalIds || {}
+                }
+            });
+        }
+        catch (error) {
+            logDebug('Error parsing Semantic Scholar paper:', error);
+            return null;
+        }
+    }
+    normalizePdfUrl(url) {
+        const clean = url.trim();
+        const arxivAbs = clean.match(/^https?:\/\/arxiv\.org\/abs\/([^?#]+)(?:[?#].*)?$/i);
+        if (arxivAbs) {
+            return `https://arxiv.org/pdf/${arxivAbs[1]}`;
+        }
+        if (/^https?:\/\/api\.unpaywall\.org\//i.test(clean) || /^https?:\/\/(?:dx\.)?doi\.org\//i.test(clean)) {
+            return '';
+        }
+        return clean;
+    }
+    parseSnippet(item) {
+        const paper = item?.paper || {};
+        const snippet = item?.snippet || {};
+        const corpusId = paper.corpusId ?? paper.corpus_id ?? '';
+        return {
+            score: typeof item?.score === 'number' ? item.score : null,
+            paper: {
+                corpusId: corpusId ? String(corpusId) : '',
+                title: this.cleanText(paper.title || ''),
+                authors: this.listParam(paper.authors),
+                openAccessInfo: paper.openAccessInfo || {},
+                url: corpusId ? `https://www.semanticscholar.org/paper/CorpusId:${corpusId}` : ''
+            },
+            snippet: {
+                text: this.cleanText(snippet.text || item?.text || ''),
+                snippetKind: snippet.snippetKind || snippet.kind || '',
+                section: snippet.section || '',
+                snippetOffset: snippet.snippetOffset || {},
+                annotations: snippet.annotations || {}
+            },
+            text: this.cleanText(snippet.text || item?.text || '')
+        };
+    }
+    listParam(value) {
+        if (!value)
+            return [];
+        if (Array.isArray(value))
+            return value.map(item => String(item).trim()).filter(Boolean);
+        return String(value)
+            .split(',')
+            .map(item => item.trim())
+            .filter(Boolean);
+    }
+    /**
+     * 获取速率限制器状态
+     */
+    getRateLimiterStatus() {
+        return this.rateLimiter.getStatus();
+    }
+    /**
+     * 验证API密钥（如果提供）
+     */
+    async validateApiKey() {
+        if (!this.apiKey) {
+            return true; // 无API密钥时使用免费限制
+        }
+        try {
+            await this.search('test', { maxResults: 1 });
+            return true;
+        }
+        catch (error) {
+            if (error.response?.status === 401 || error.response?.status === 403) {
+                return false;
+            }
+            return true; // 其他错误可能是网络问题
+        }
+    }
+}
+//# sourceMappingURL=SemanticScholarSearcher.js.map

package/dist/platforms/SemanticScholarSearcher.js.map

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

package/dist/platforms/SpringerSearcher.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Springer Nature Searcher
+ *
+ * Documentation: https://dev.springernature.com/
+ * API Endpoints:
+ * - Metadata API v2: https://api.springernature.com/meta/v2/json
+ * - OpenAccess API: https://api.springernature.com/openaccess/json (if available with your key)
+ *
+ * Required API Key: Yes (api_key parameter)
+ * Get API key from: https://dev.springernature.com/signup
+ *
+ * Note: Meta API v2 is the primary API. OpenAccess API may require special access.
+ */
+import { PaperSource, SearchOptions, DownloadOptions, PlatformCapabilities } from './PaperSource.js';
+import { Paper } from '../models/Paper.js';
+export declare class SpringerSearcher extends PaperSource {
+    private metadataClient;
+    private openAccessClient;
+    private rateLimiter;
+    private quotaManager;
+    private hasOpenAccessAPI;
+    private openAccessApiKey?;
+    private testingPromise;
+    constructor(apiKey?: string, openAccessApiKey?: string);
+    search(query: string, options?: SearchOptions): Promise<Paper[]>;
+    private parseResult;
+    downloadPdf(doi: string, options?: {
+        savePath?: string;
+    }): Promise<string>;
+    getCapabilities(): PlatformCapabilities;
+    /**
+     * 获取引用此论文的文献列表(通过Crossref/OpenCitations)
+     */
+    getCitations(doi: string): Promise<Paper[]>;
+    /**
+     * 获取论文的参考文献列表(通过Crossref)
+     */
+    getReferences(doi: string): Promise<Paper[]>;
+    /**
+     * 清理和转义查询参数中的特殊字符
+     */
+    private sanitizeQueryValue;
+    /**
+     * Test if OpenAccess API is available for this API key
+     * Uses promise caching to prevent race conditions with concurrent requests
+     */
+    private testOpenAccessAPI;
+    /**
+     * Perform the actual OpenAccess API test
+     */
+    private performOpenAccessTest;
+    readPaper(paperId: string, options?: DownloadOptions): Promise<string>;
+}
+//# sourceMappingURL=SpringerSearcher.d.ts.map

package/dist/platforms/SpringerSearcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpringerSearcher.d.ts","sourceRoot":"","sources":["../../src/platforms/SpringerSearcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACrG,OAAO,EAAE,KAAK,EAAgB,MAAM,oBAAoB,CAAC;AA6CzD,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAsB;IAC9C,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,cAAc,CAA8B;gBAExC,MAAM,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM;IA0ChD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IA0I1E,OAAO,CAAC,WAAW;IA8Db,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAoDpF,eAAe,IAAI,oBAAoB;IAWvC;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IA6BjD;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IA6BlD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;;OAGG;YACW,iBAAiB;IAqB/B;;OAEG;YACW,qBAAqB;IAwB7B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;CAOjF"}