SuperAPI AI 工具集

citation-survey

通用与其它

查看项目

更新于 10-16 07:16

技能介绍

用途:这是一个引用调研技能(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。其余平台、收费或效果信息暂未提供。