# Semantic Scholar API

> Incubating Butler wrapper spec for upstream 'Semantic Scholar API'.

- Skill: `ocean326/semantic-scholar-api` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add ocean326/semantic-scholar-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ocean326/semantic-scholar-api/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: ocean326 (https://skillmd.com/u/ocean326)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ocean326/semantic-scholar-api

---

# Semantic Scholar API

## Status

- `incubating`
- 这不是生产可执行 skill，而是 Butler 对外部上游的包装草案。
- 默认不得加入 `chat_default` / `codex_default` / `automation_safe`。

## Proposed Butler Shape

- paper lookup, citation graph hops, author impact summary, related-paper expansion

## Upstream

- repo_or_entry: https://www.semanticscholar.org/product/api
- docs: https://www.semanticscholar.org/product/api
- upstream_type: official_api
- maturity: high

## Why This Matters

- Good balance between scholarly metadata richness and agent-friendly API shape.
- Useful when Butler needs citation expansion instead of simple keyword search.

## Risks

- Quota and API-key policy must be checked before automation.
- Coverage varies by field and source.

## Suggested Future Exposure

- chat_default
- skill_ops

## Implementation Checklist

- 明确 Butler 输入输出 contract，不直接复刻上游 API。
- 确认认证、限流、缓存和错误恢复策略。
- 补执行脚本或 tool bridge，而不是只停留在说明文档。
- 补测试与 `skill-pool-verify` / `skill-pool-maintain` 校验。
- 审阅后再决定是否加入 collection registry。