SuperAPI AI 工具集

semanticscholar-skill

编程与开发

查看项目

更新于 10-15 16:42

技能介绍

用途:该技能面向学术检索场景,用于搜索论文、查看引文、查找作者、获取论文推荐。触发场景包括按主题或精确术语检索论文、查询某论文的被引情况、查找研究者及其发表记录、基于一篇或多篇论文寻找相似论文。

主要能力:通过 s2.py 提供的函数覆盖论文检索与元数据查询:search_relevance 做宽泛相关度搜索,search_bulk 做支持布尔语法的精确检索,search_snippets 搜索全文段落,match_title 精确匹配标题,get_paper 按 ID 取详情,get_citations 与 get_references 遍历引用关系,find_similar 做单种子推荐,recommend 做多种子推荐(可含负例),batch_papers 批量查询。作者相关有 search_authors、get_author、get_author_papers、get_paper_authors、batch_authors。输出可用 format_results、format_table、format_details、format_citations、format_authors,以及 export_bibtex、export_markdown、export_json。还提供数据集接口:list_releases、list_datasets、get_dataset_links、get_dataset_diffs,用于批量下载各类 S2 数据集。

使用方式:先规划检索策略,写入一个 Python 脚本(开头使用标准 prelude 定位技能目录并 from s2 import *),构建查询(如 build_bool_query 组合 phrases、required、excluded),调用检索函数并去重,最后格式化输出;整个过程在一次 Bash 调用中执行,rate limiting、重试与退避由 s2.py 处理。过滤器参数用 snake_case,如 year、publication_date、venue、fields_of_study、min_citations、pub_types、open_access。

适用场景:论文选题与文献调研、追踪某工作后续引用、作者画像与产出梳理、相似论文推荐、结果导出为 BibTeX/Markdown/JSON、以及批量数据集获取。

限制:无 API Key 时自动转为匿名模式且请求间隔放宽至 5 秒,匿名调用共享全局配额并可能被进一步限流;建议每次都附 API Key。每次搜索建议 max_results ≤ 30,推荐类函数单次上限 500 篇。应尽量少请求字段以加快响应。遇到持续 429 可调大 _MIN_GAP 或申请密钥。使用前需确保技能目录可被定位、已安装 requests。缺失信息:具体价格与收费方式资料未提供。