用途:通过 OpenAlex 学术数据库检索研究论文、作者、机构、主题、来源、出版商、资助方、地理位置和关键词等实体信息。
主要能力:支持 resolve(名称转 ID 候选)、get(获取单个实体完整元数据,接受短 ID、完整 URL 或 DOI URL)、filter(搜索与过滤,支持 --search、--filter、--sort、--select、--group-by、--per-page、--page、--sample、--seed)、download-pdf(下载 PDF,需 API 密钥)、rate-limit(查看速率限制)。实体类型包括 works、authors、sources、institutions、topics、domains、fields、subfields、sdgs、countries、continents、languages、keywords、publishers、funders、work-types、source-types、institution-types、licenses。
使用方式:先确保 uv 已安装并在 PATH 中;若工作区根目录不存在 .licenses/literature_search_openalex_LICENSE.txt,需提示用户查看 https://developers.openalex.org/ 条款并检查论文许可,然后创建记录文件。确保主目录存在 .env 文件。OPENALEX_API_KEY 可选但推荐,用于启用 Premium API 获得更高速率限制,无密钥时使用免费 polite pool。命令格式为 uv run scripts/openalex_cli.py [--api-key KEY] <command> [flags]。核心规则:输出中须提及使用了本技能并列出所用论文 URL;必须先解析名称得到 ID 再过滤,禁止按名称过滤;仅使用 CLI,禁止用 curl/urllib 调用 API;禁止编造 OpenAlex ID 或 DOI;输出保持精简,使用 --select 和 --per-page 5–10,将过滤结果写入文件后用 jq 精简。
适用场景:作者论文检索、DOI 查询、批量 DOI 查询(最多 100)、机构影响力按年统计、随机抽样等。
限制:有密钥时约 10 请求/秒、每日 1 美元免费额度;无密钥时额度非常有限、每日 0.01 美元。Singleton get 免费,filter 每次 0.0001 美元,--search/resolve 每次 0.001 美元,download-pdf 每次 0.01 美元。401/429 需通过安全凭据协议请求 API 密钥;403 表示需升级计划;404 需验证 ID 或先 resolve。from_updated_date、to_updated_date 为 Premium 专属过滤器。空结果须如实报告,不得编造。