Sciverse Skills
以 opendatalab/Sciverse-Agent-Tools 仓库为准,提供 6 个标准化 Agent 工具与 Python / TypeScript SDK,支持 5 种装载路径。
list_catalog
字段查询
search_metadata
多实体元数据检索
semantic_search
语义检索
list_paper_relations
论文引用与相关工作
read_content
原文切片
get_resource
图表资源
装载路径
npx skills add
npx skills add https://sciverse.space
clawhub install sciverse
Claude Plugin
/plugin install sciverse
手动 Skill
clone 后 cp 至 .claude/skills
Python · TS SDK
pip / npm install sciverse
兼容 Claude Code / Cursor / Codex CLI / Windsurf 等主流 Agent 客户端,统一通过 sciverse-mcp-server 连接。
连接方式
- 传输协议:sciverse-mcp-server / SDK / ClawHub Skill
- 端点:https://github.com/opendatalab/Sciverse-Agent-Tools
- 鉴权:统一使用 Sciverse API Token(SCIVERSE_API_TOKEN 环境变量)。ClawHub 一键装载时在面板填写;Claude Code / Cursor / Codex CLI / Windsurf 等均通过 sciverse-mcp-server 接入。
客户端配置
任意 MCP 客户端·.mcp.json
{
"mcpServers": {
"sciverse": {
"command": "npx",
"args": ["-y", "sciverse-mcp-server"],
"env": {
"SCIVERSE_API_TOKEN": "sv-..."
}
}
}
}装载方式
装载
npx skills add
# 一键安装 Agent Skill(推荐给支持 npx skills 的环境)
# 1) 从官方安装
npx skills add https://sciverse.space
# 2) 设置 Token
export SCIVERSE_API_TOKEN=sv-xxx装载
OpenClaw · ClawHub
# 适用任意 OpenClaw 兼容客户端
clawhub install sciverse
# 可选:从 ClawHub Skill 页面选择客户端与填写 Token
# https://clawhub.ai/sciverse/academic-retrieval装载
Claude Plugin
claude /plugin marketplace add https://github.com/opendatalab/Sciverse-Agent-Tools
claude /plugin install sciverse
# 配套安装 MCP 服务
npm install -g sciverse-mcp-server
export SCIVERSE_API_TOKEN=sv-...装载
手动 Skill
git clone https://github.com/opendatalab/Sciverse-Agent-Tools.git
cd Sciverse-Agent-Tools
# 用户级
cp -r skill-claude-code ~/.claude/skills/sciverse
# 或项目级
cp -r skill-claude-code .claude/skills/sciverse
# 同样需要 sciverse-mcp-server
npm install -g sciverse-mcp-server
export SCIVERSE_API_TOKEN=sv-...装载
SDK 安装
# Python
pip install sciverse
# TypeScript / Node.js
npm install sciverseSDK 调用
Python
import asyncio
from sciverse import AgentToolsClient
async def main():
async with AgentToolsClient(
base_url="https://api.sciverse.space",
token="<TOKEN>",
) as c:
r = await c.semantic_search(query="Transformer attention mechanism")
for hit in r["hits"][:3]:
print(hit["title"], hit["score"])
asyncio.run(main())SDK 调用
TypeScript
import { AgentToolsClient } from "sciverse";
const c = new AgentToolsClient({
baseUrl: "https://api.sciverse.space",
token: process.env.SCIVERSE_API_TOKEN!,
});
const r: any = await c.semanticSearch({ query: "Transformer attention mechanism" });
r.hits.slice(0, 3).forEach((h: any) => console.log(h.title, h.score));框架接入
Anthropic Claude
from anthropic import Anthropic
from sciverse import ANTHROPIC_TOOLS
client = Anthropic()
msg = client.messages.create(
model="claude-opus-4-7",
max_tokens=2048,
tools=ANTHROPIC_TOOLS,
messages=[{"role": "user", "content": "Find a few papers on Transformers"}]
)框架接入
OpenAI Tools
import OpenAI from "openai";
import { OPENAI_TOOLS } from "sciverse";
const openai = new OpenAI();
const resp = await openai.chat.completions.create({
model: "gpt-4o",
tools: OPENAI_TOOLS as any,
messages: [{ role: "user", content: "Find a few Transformer papers" }],
});工具总览
| 类别 | 工具名 | 说明 | 典型延迟 |
|---|---|---|---|
| SDK | list_catalog | 枚举可用字段、过滤算子与示例值;首次集成或拼装精确 filters 之前调用一次。 | ~120ms |
| SDK | search_metadata | 检索论文、专利、作者、来源的元数据;先用 list_catalog 查看字段权限和能力。 | ~150–500ms |
| SDK | semantic_search | 以自然语言在文献片段层面进行语义检索,是 RAG 场景的核心入口。 | ~500–1500ms |
| SDK | list_paper_relations | 按论文 unique_id 分页查询参考文献、被引论文或相关工作。 | — |
| SDK | read_content | 按 Unicode 码点区间读取原文,结合 doc_id 和 offset 扩展 RAG 上下文。 | ~200ms |
| SDK | get_resource | 拉取 read_content Markdown 中引用的图 / 表二进制(图像字节 + MIME),用于多模态 RAG。 | ~200ms |
SDK工具
list_catalog
~120ms
枚举可用字段、过滤算子与示例值;首次集成或拼装精确 filters 之前调用一次。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| collection | string | 可选 | papers / authors / sources / patents 默认 papers |
| include_sample_values | boolean | 可选 | 是否随枚举字段返回示例值,便于 LLM 自校验。 默认 false |
返回字段:fields[](name · type · operators[] · sample_values?)
search_metadata
~150–500ms
检索论文、专利、作者、来源的元数据;先用 list_catalog 查看字段权限和能力。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| collection | string | 可选 | papers / authors / sources / patents 默认 papers |
| query | string | 可选 | 关键词检索 |
| filters | array | 可选 | [{field, operator, value}] |
| sort | array | 可选 | [{field, order}] |
| fields | array<string> | 可选 | 返回字段 |
| cursor | string | 可选 | 上页 next_cursor |
| page_size | integer | 可选 | 1–200 默认 25 |
| facets | array | 可选 | 最多5项,[{field, size}],size上限50 |
返回字段:hits[](title · doc_id · authors · year · venue · abstract)
semantic_search
~500–1500ms
以自然语言在文献片段层面进行语义检索,是 RAG 场景的核心入口。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | 必填 | 自然语言查询,1–2048 字符。 |
| top_k | integer | 可选 | 返回片段上限。fast/balanced 实际至多约 50,quality 可超过。 默认 10范围 1–100 |
| mode | string | 可选 | 语义检索质量 / 耗时权衡。 默认 balanced范围 fast / balanced / quality |
返回字段:hits[](doc_id · chunk_id · text · score · source.title · source.year · offset)
list_paper_relations
按论文 unique_id 分页查询参考文献、被引论文或相关工作。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| unique_id | string | 必填 | 论文元数据的 unique_id。 |
| relation | string | 必填 | REFERENCES(参考文献)、CITATIONS(被引论文)或 RELATED_WORKS(相关工作)。 |
| page | integer | 可选 | 页码。 |
| page_size | integer | 可选 | 每页条数。 |
read_content
~200ms
按 Unicode 码点区间读取原文,结合 doc_id 和 offset 扩展 RAG 上下文。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| collection | string | 可选 | papers / patents 默认 papers |
| doc_id | string | 必填 | 文献 ID(由 search_metadata / semantic_search 返回)。 |
| offset | integer | 可选 | 起始偏移,按 Unicode 码点计数。 默认 0 |
| limit | integer | 可选 | 本次读取的 Unicode 码点上限。 默认 4096 |
返回字段:Markdown 片段(含  引用)· next_offset · more
get_resource
~200ms
拉取 read_content Markdown 中引用的图 / 表二进制(图像字节 + MIME),用于多模态 RAG。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| file_name | string | 必填 | 形如 dt=xxx/p_yyy/f3.png,由 read_content 返回的 Markdown 中给出。 |
返回字段:bytes(image/png 等)· mime_type
错误响应
{
"content": [{ "type": "text", "text": "错误信息" }],
"isError": true
}| 场景 | HTTP 状态码 | 说明 |
|---|---|---|
| Token 缺失或无效 | 401 | 检查 SCIVERSE_API_TOKEN 是否填入客户端或环境变量。 |
| 请求参数错误 | 400 | 由 Python httpx.HTTPStatusError / TypeScript Error("Sciverse API 400: …") 抛出。 |
| 超出额度 | 429 | 仅服务返回;请等待限流窗口恢复或联系支持团队调整账号配额。 |
| 服务暂不可用 | 502 / 503 | 按指数退避重试(1s / 2s / 4s)。 |
还没有 API Key?
登录控制台「密钥」即可创建。同一套 API Key 可用于已开通的 Sciverse、点石与 Skills 能力,提供基础试用额度,具体以账号权限为准。