用途：通过 OpenAlex API 检索和分析学术文献，覆盖 3 亿多篇作品（默认 core 语料，corpus=all 约多 60%），以及作者、机构、主题、来源、出版商和资助方。适合跨学科文献检索、按作者/机构/资助方查作品、引用与文献计量分析、开放获取状态查询、批量 DOI 解析。
主要能力：关键词与语义搜索；按年份、OA 状态、类型等过滤；按作者、机构、来源 ID 查作品；引用计数与被引作品；group_by 聚合做趋势与主题分析；批量查询 DOI/ORCID/ROR/ISSN；随机抽样；游标分页导出大数据集。
使用方式：安装依赖 uv pip install requests；从 scripts.openalex_client 导入 OpenAlexClient，或使用 scripts.query_helpers 中的 find_author_works、find_institution_works、get_open_access_papers、get_publication_trends、analyze_research_output 等高层函数。建议设置免费 API 密钥：export OPENALEX_API_KEY=...，客户端以 Authorization: Bearer 发送。实体查询用两步法：先按名称解析出 ID，再按 ID 过滤。列表调用用 per_page=100，多 ID 用 batch_lookup，随机抽样用 sample_works(seed=...)，只取所需字段用 select。
限制：无密钥时共享每 IP 每天 0.10 美元预算，免费密钥为每天 1 美元；超出返回 429，Retry-After 指向 UTC 午夜。硬上限 100 请求/秒。per_page 最大 100；基于页码的分页止于 10000 条，需用 cursor=*；每个过滤器最多 100 个 OR 值；sample 上限 10000。mailto 礼貌池已于 2026 年 2 月停用。费用按凭证计：单实体按 ID/DOI 查询免费，list+filter 每千次 0.10 美元，search= 与 search.semantic= 每千次 1 美元，PDF 内容下载每千次 10 美元。生物医学 MeSH/PubMed 检索、引文图谱、参考文献核验、Zotero 管理、结构化综述写作应使用其他对应技能。