Scholar Sidekick (REST API) — Scholar Sidekick(REST API)
v1.0.0解析学术标识符(DOI、PMID、PMCID、ISBN、arXiv、ISSN、ADS bibcode、WHO IRIS URL)为格式化引用(10,000+ CSL 样式)和参考文献导出(BibTeX、RIS、EndNote、CSV等),并检查撤回、开放访问和引用伪造状态。通过普通HTTP调用文档化的REST API —— 无需安装,无需API密钥即可使用免费层。
运行时依赖
安装命令
点击复制技能文档
Scholar Sidekick(REST API)— 引用、撤回与开放获取 通过一个记录的REST API,将一个学术标识符转换为一个格式化的引用、一个参考书目文件或一个完整性检查(撤回/开放获取/伪造),无需API密钥和安装,只需通过curl进行简单的HTTPS调用。可选的RapidAPI密钥可以提高速率限制。如果您的主机已经连接了Scholar Sidekick MCP服务器,请使用scholar-sidekick-mcp技能——它具有与本地工具调用相同的功能。本技能是零设置的路径,可以在任何可以运行curl的代理中工作。
何时使用 用户拥有一个标识符(DOI、PMID、PMCID、ISBN、arXiv、ISSN、ADS bibcode、WHO IRIS URL)并希望获取元数据、格式化的引用或参考书目文件。“以APA/Vancouver/Chicago风格引用”,“给我一个BibTeX/RIS文件”,“导出这些引用”。“这个引用是否被撤回?”,“这个引用是否是开放获取?”,“这个引用是否真实/你是否编造了它?” 不要使用它来按主题搜索论文——那是发现(请参阅arxiv技能)。这假设您已经拥有一个标识符。
表面——调用API,永远不要抓取UI 该网站是为代理设计的。合同位于: https://scholar-sidekick.com/llms.txt(代理表面索引) https://scholar-sidekick.com/AGENTS.md(REST + MCP指南) https://scholar-sidekick.com/openapi/openapi.yml(OpenAPI 3.1) 始终调用下面的JSON REST API。不要驱动网站表单。
身份验证和限制 对scholar-sidekick.com/api/*的调用以匿名方式工作——没有第一方API密钥——在一个速率限制的免费层(~40个格式/10个导出请求每个窗口),这对于正常的人类驱动的代理使用来说已经足够了。对于更高的限制,Scholar Sidekick在RapidAPI上提供:在https://rapidapi.com/scholar-sidekick-scholar-sidekick-api/api/scholar-sidekick上订阅并通过RapidAPI网关使用您的X-RapidAPI-Key调用。默认使用匿名scholar-sidekick.com端点;仅在需要大量使用时转移到RapidAPI。
快速参考 基本URL:https://scholar-sidekick.com 需要端点正文 格式化引用 POST /api/format {text, style, output} 导出参考书目文件 POST /api/export {text, format} 撤回/更正/结束检查 POST /api/retraction-check {id} 开放获取状态+最佳合法URL POST /api/oa-check {id} 验证所谓的引用(伪造) POST /api/verify {claimed: {title, doi}} 服务健康 GET /api/health
过程 格式化引用 curl -sS -X POST "https://scholar-sidekick.com/api/format" \ -H "Content-Type: application/json" \ -d '{"text": "10.1038/nphys1170", "style": "vancouver", "output": "text"}' 文本:一个标识符,或几个换行符分隔的批处理。传递verbatim——PMID:、arXiv:、ISBN连字符和https://doi.org/…都是可以容忍的。 样式:vancouver(默认)、ama、apa、ieee、cse或任何CSL样式ID(chicago-author-date、harvard-cite-them-right、modern-language-association、nature、bmj、the-lancet、…)。 输出:文本或json。 响应:{ "ok": true, "items": [{ "formatted": "…" }], "text": "…" }。
导出参考书目文件 curl -sS -X POST "https://scholar-sidekick.com/api/export" \ -H "Content-Type: application/json" \ -d '{"text": "10.1038/nphys1170\nPMID:30049270", "format": "bibtex"}' \ -o refs.bib 格式:bibtex、ris、csl-json、endnote-xml、refworks、nbib、rdf、csv、txt。
检查撤回 curl -sS -X POST "https://scholar-sidekick.com/api/retraction-check" \ -H "Content-Type: application/json" \ -d '{"id": "10.1016/S0140-6736(97)11096-0"}' 返回{ ok, doi, result: { isRetracted, hasCorrections, hasConcern, notices[], title } }(Crossref + Retraction Watch)。 一个标识符每次调用——字段是id。 当工作没有DOI(例如一本书)时,结果为null,原因解释了为什么(no_doi / timeout / upstream)。
检查开放获取 curl -sS -X POST "https://scholar-sidekick.com/api/oa-check" \ -H "Content-Type: application/json" \ -d '{"id": "10.1371/journal.pone.0173664"}' 返回{ ok, doi, result: { isOa, oaStatus, bestLocation: {url, hostType, license, version}, locations[] } }(Unpaywall)。 一个标识符每次调用——字段是id。
验证所谓的引用(捕获伪造) curl -sS -X POST "https://scholar-sidekick.com/api/verify" \ -H "Content-Type: application/json" \ -d '{"claimed": {"title": "The title exactly as cited", "doi": "10.xxxx/xxxxx"}}' 引用字段进入claimed对象:title(必需)加一个标识符(doi、pmid、…)和可选的作者/年/容器。 返回{ ok, verdict, confidence, matched },verdict ∈ matched / mismatch / ambiguous / not_found / parsing_error: matched — 声称同意标识符的记录。 mismatch — 标识符解析但标题不匹配:主要的AI伪造模式(真实DOI + 虚构标题;Topaz et al.,Lancet 2026)。 ambiguous — 标识符解析为一篇论文,但所谓的标题与不同的真实论文匹配(错误标识符错误,而不是伪造)。 not_found — 标识符和标题都没有找到。