用途:这是一个引用调研技能(citation-survey),通过 OpenAlex API 查询某篇种子论文的引用关系,用于查找后续研究、被引论文或参考文献。
主要能力:
- 查找引用该论文的文献(citing)
- 查找该论文的参考文献(refs)
- 按标题/摘要中的关键词过滤结果
- 结果可保存为 JSON
- 可显示摘要(verbose)
- 支持用 DOI 或 arXiv ID 指定种子论文
使用方式:所有脚本路径相对技能基础目录。示例命令(保持原样): uv run <base-dir>/scripts/citation_survey.py citing --doi <DOI> uv run <base-dir>/scripts/citation_survey.py citing --arxiv <ARXIV_ID> uv run <base-dir>/scripts/citation_survey.py refs --doi <DOI> uv run <base-dir>/scripts/citation_survey.py citing --doi <DOI> --filter "keyword1,keyword2" uv run <base-dir>/scripts/citation_survey.py citing --doi <DOI> --output results.json uv run <base-dir>/scripts/citation_survey.py citing --doi <DOI> --verbose
主要选项:direction(citing 或 refs)、--doi、--arxiv、--filter、--max-results(默认 2000)、--output、--verbose、--api-key、--api-key-file。
API Key:OpenAlex API 需要 API key(在 https://openalex.org/settings/api 免费注册)。优先使用 OPENALEX_API_KEY 或 --api-key-file。--api-key 仍受支持,但命令行中的密钥可能出现在 shell 历史或进程列表中。无 key 时脚本仍可运行,但速率限制更严格。
限制与说明:使用 OpenAlex API(有免费额度);分页请求间隔 0.15s 延迟;网络、超时和 HTTP 错误以简短用户提示返回,而非 Python 回溯;摘要由倒排索引(OpenAlex 格式)重建;仅 arXiv 的论文 DOI 解析可能失败,此时应改用 --arxiv。其余平台、收费或效果信息暂未提供。