用途:把 Claude Code 直接接到 OpenAlex 开放学术索引,用于在深入工作前快速了解某主题已有研究、在设计研究或提案前做查重、进入陌生领域时定位被广泛引用的锚点论文、为具体论断找来源,以及判断领域成熟度。默认模式下查询文本只发给 OpenAlex,不经过第三方中转;Consensus 升级为可选、按次启用。
主要能力:提供 search(快速搜索,可用 --type review 只看综述)、dup-test(查重)、debate-map(辩论图谱/锚点论文)、forensic(单条论断溯源)、era-split(年代切分,默认 2015 年)、terminology_shift 等动作。结果每行格式为 年份 | 引用量 | 信号 | 标题 | 链接;信号含 rising、anchor、steady、quiet;以 !! 开头表示已撤稿,不可引用。链接优先开放获取地址,其次落地页,最后 DOI。
使用方式:命令从任意位置运行,驱动会自行引导工作目录路径。示例:python scripts/literature_cli.py search "adolescent contraception uptake Eastern Europe" --from-year 2020 --per-page 10;python scripts/literature_cli.py dup-test "..." --from-year 2015;python scripts/literature_cli.py debate-map "..." --top-works 5 --ancestors 5;python scripts/literature_cli.py forensic "...";python scripts/literature_cli.py era-split "..." --split-year 2015 --per-page 25。可用 --type report 或 --type dissertation 检索灰色文献。
限制:匿名访问约 $0.10/天(约 100 次搜索),在 https://openalex.org/settings/api 申请免费密钥并设为 OPENALEX_API_KEY 可提升至 $1/天,429 表示当日额度用尽。OpenAlex 只匹配标题与摘要,不检索全文;不是质量过滤器,掠夺性期刊作品也会被索引;灰色文献覆盖较薄,且无同行评审,需另行评估。查重结果干净可能是术语不匹配,应换用领域自身词汇重试。该技能只读不写文件。Consensus 升级仅在需要按研究设计筛选(study_types、human、sample_size_min、sjr_max 等)时使用,须逐条串行、说明升级理由、记录结果上限,且查询文本会发给第三方。每次产出交付物需报告查询数、收到结果数、引用结果数及失败与薄弱项。