学者搜索
通过 https://scholar.x49.ai 的 Scholar API 搜索学术论文和作者。
何时使用此技能
当用户需要：
按主题、关键词或自然语言查询搜索学术论文
按年份、场馆、作者或机构查找论文
获取搜索自动完成建议
按 paper_ref 查找一或多个论文的详细元数据
按名称查找研究人员并获取他们的个人资料
列出作者的代表性或最近的论文
检查期刊排名（JCR、CCF、FQBJCR 分级）
按开放访问、论文类型或引用次数筛选
API 配置
API 基础 URL 为 https://scholar.x49.ai/api/v1。
身份验证使用 Bearer 令牌。
按以下顺序解析密钥：
环境变量 SCHOLAR_API_KEY
内置免费密钥：psk_tLzPCmJdUw5oAHGeXL2H_fMrDdSyiF_SBJfn2p5uCO4
用户可以在 https://scholar.x49.ai/docs?section=api-keys 获取更高配额的密钥。
始终以以下方式构造 API 调用：
SCHOLAR_KEY="${SCHOLAR_API_KEY:-psk_tLzPCmJdUw5oAHGeXL2H_fMrDdSyiF_SBJfn2p5uCO4}"
BASE="https://scholar.x49.ai/api/v1"
端点
主要搜索端点。支持两种模式：
标准（mode=standard）：精确关键词匹配，结果池更大
语义（mode=semantic）：自然语言理解，结果更相关
两种模式消耗单独的月度配额。
SCHOLAR_KEY="${SCHOLAR_API_KEY:-psk_tLzPCmJdUw5oAHGeXL2H_fMrDdSyiF_SBJfn2p5uCO4}"
curl -s "https://scholar.x49.ai/api/v1/papers/search" \
-H "Authorization: Bearer ${SCHOLAR_KEY}" \
-H "Content-Type: application/json" \
-d '{ "query": "transformer attention mechanism", "mode": "standard", "limit": 10, "sort": "relevance", "filters": {} }'
请求体字段：
字段 类型 必需 含义
query 字符串 条件性 自然语言查询文本。如果省略，请在 filters 中提供至少一个 author_ref
mode 字符串 否 standard（默认）或 semantic
limit 整数 否 每次调用结果，1-100。默认值可能有所不同
sort 字符串 否 相关性、最多引用、最新或最旧
过滤器对象（嵌套在过滤器下）：
过滤器 类型 含义
year_from / year_to 整数 发表年份范围
paper_types 字符串数组 例如 ["article", "review"]
venues 字符串数组 期刊或会议名称
concepts 字符串数组 主题或概念标签
institutions 字符串数组 机构名称
author_refs 字符串数组 公共作者引用
open_access 布尔值 仅限开放访问论文
关键响应字段：
data.items[] — 本批论文卡
data.items[].paper_ref — 稳定的公共引用（用于批量/详细查找）
data.items[].authors[].author_ref — 用于作者详细信息和论文
data.facets — 聚合过滤值（年份、概念、场馆、机构、论文类型、场馆质量）
meta.total_results — 当前过滤器下的总匹配数
meta.limit — 您请求的结果上限
- 搜索建议：GET /search/suggestions
获取自动完成建议和过滤候选值。
curl -s "${BASE}/search/suggestions?query=transformer&type=all&limit=5" \
-H "Authorization: Bearer ${KEY}"
参数（查询字符串）：
参数 类型 必需 含义
query 字符串 是 输入的前缀
type 字符串 否 all（默认）、author、venue、concept、institution、paper_type、year
limit 整数 否 最大建议返回数
响应：混合或类型化的建议项，带有计数。
- 论文批量查找：POST /papers/batch
将一个或多个 paper_ref 值扩展为完整元数据。
curl -s "${BASE}/papers/batch" \
-H "Authorization: Bearer ${KEY}" \
-H "Content-Type: application/json" \
-d '{"paper_refs":["pap_ebcabae1be4244f3adba","pap_4748c234f5384d0eaee2"]}'
请求体：
字段 类型 必需 含义
paper_refs 字符串数组 是 搜索结果中的公共论文引用
响应：全论文卡数组，结构与搜索项相同。
按名称查找作者。
curl -s "${BASE}/authors/search?query=Hyeongwon+Kang&limit=5" \
-H "Authorization: Bearer ${KEY}"
参数（查询字符串）：
参数 类型 必需 含义
query 字符串 是 作者名称或关键词
limit 整数 否 最大结果返回数
响应：作者候选项，带有 author_ref、名称、最后已知机构、指标（引用计数、论文计数）和标识符（orcid）。
- 作者详细信息：GET /authors/{author_ref}
显示完整作者个人资料。
curl -s "${BASE}/authors/aut_d2610a19ad8c4b1ca298" \
-H "Authorization: Bearer ${KEY}"
响应包括：
名称、隶属机构（带有国家、类型、年份）、别名、标识符（orcid）、指标（引用计数、h指数、i10指数、论文计数、两年平均被引次数）、顶级场馆、主题（带有论文计数和评分）。
- 作者论文：GET /authors/{author_ref}/papers
列出一个作者的代表性或最近的论文。
curl -s "${BASE}/authors/aut_d2610a19ad8c4b1ca298/papers?limit=10" \
-H "Authorization: Bearer ${KEY}"
参数（查询字符串）：
参数 类型 必需 含义
limit 整数 否 最大结果返回数
by