openalex-explore

name	openalex-explore
description	用于英文 P0 期刊调研第一层跨学科探索时使用。触发关键词：OpenAlex / cross-disciplinary / 英文跨学科选刊 / 物理化学材料工程社科期刊探索 / journal source search。不用于已知 ISSN 校验（→crossref-validator）、CS 专项 venue（→dblp-cs-explore）、OA-only 推荐（→bison-oa-explore）、Google Scholar cross-check（→google-scholar-explore）。

openalex-explore

Method-call

/openalex-explore(query, per_page=10, oa_only=false)

定位：跨学科主源 adapter。输入研究方向、题目或摘要，调用 OpenAlex Works + Sources，把论文检索结果聚合成 CandidateJournal-compatible JSON。

执行流程

1. 读取 OPENALEX_API_KEY，没有则读 macOS Keychain service openalex，仍没有则匿名调用并写 warning。
2. 调 OpenAlex /works，使用 search=<query>、group_by=primary_location.source.id、filter=primary_location.source.type:journal。
3. 对 top source.id 调 /sources/{id} 补 ISSN、publisher、OA、DOAJ、summary_stats。
4. 输出 list[CandidateJournal] 兼容 JSON；trust_level=openalex-explore，只供第一层探索，不能直接当最终投稿决策。
5. 遇到 429/5xx 用 1s/2s/4s 退避重试；候选为空时返回非零，让 orchestrator 切副 adapter。

脚本

python3 scripts/openalex_search.py "quantum computing" --per-page 10
python3 scripts/test_explore.py "quantum computing"

输出 Schema

每个候选至少包含：

• identity.title
• identity.issn / identity.eissn
• identity.publisher
• fit_score
• authority_metrics.openalex_id
• authority_metrics.source_type
• evidence[].source = openalex-grouped-works

Anti-pattern

• 不返回 repository / preprint server 作为期刊候选。
• 不把 OpenAlex fit_score 当作最终推荐，只用于候选池排序。
• 不在仓库写入 API key。

本 skill 的 deletion-spec

• 触发删除条件：OpenAlex API 不再稳定提供 Works/Sources 聚合，或官方/本地 MCP 已提供等价 CandidateJournal 输出且覆盖跨学科探索。
• 禁用方式：删除 plugins/journal-research-en/skills/openalex-explore/，bump journal-research-en minor，重生成 marketplace 并刷新 Claude/Codex cache。
• 卸载清单：同步更新 journal-research-orchestrator 的学科路由、README.md 的 skill 表、plugins/journal-research-en/.claude-plugin/plugin.json 版本，以及依赖 OpenAlex fallback 的 sibling adapter 文档。