关于 aminer-free-academic
aminer-free-academic 是面向 AMiner 免费接口的研究发现与初步筛选技能,适合研究人员查找论文和学者、规范实体名称,并判断是否需要进一步分析。
主要功能
- 01免费接口论文搜索与筛选
- 02学者识别
- 03机构与发表场所名称规范化
- 04轻量级专利趋势扫描
- 05跨实体发现
适用场景
- 01在深入评阅前筛选论文
- 02从候选者中识别学者
- 03规范机构或发表场所名称
- 04扫描近期专利活动
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ aminerorg/ aminer-open-skill --skill aminer-free-academic安装后在 Claude Code 中输入/aminer-free-academic确认已加载。
详细介绍
AMiner 免费搜索
当 AMiner 请求应优先使用免费套餐时,请使用此技能。它适用于发现、初步筛选和实体规范化,不适用于深入分析。
范围
此技能仅使用升级后的免费接口:
paper_searchpaper_infoperson_searchorganization_searchvenue_searchpatent_searchpatent_info
此技能重点介绍的当前免费套餐字段:
paper_search:一个搜索框query,用于搜索标题 + 关键词;可选year/year_from/year_to;返回doi、venue_name、first_author、n_citation_bucket、yearpaper_info:abstract_slice、year、venue_id、author_countorganization_search:aliases(前 3 个)venue_search:aliases(前 3 个)、venue_typepatent_search:inventor_name(第一位)、app_year、pub_yearpatent_info:app_year、pub_yearperson_search:interests、n_citation、机构字段
主要目标
使用免费 API 帮助用户解答:
- 这个实体是什么?
- 它是否足够相关,值得继续研究?
- 接下来应该查看哪个候选项?
- 能否规范化这个机构或会议名称?
- 升级到付费 API 是否足够值得?
请勿将此技能用于完整学者画像、引文链分析、类似全文的论文理解、大规模监控或机构产出分析。
强制规则
- 除非用户明确要求升级,或免费方案显然无法回答问题,否则请使用免费 API。
- 明确说明免费套餐的限制。说明当前可以回答什么,以及哪些内容需要付费升级。
- 在建议使用任何付费 API 之前,先用免费结果缩小候选范围。
- 如果返回实体,且有 ID,请附上 AMiner URL:
- 论文:
https://www.aminer.cn/pub/{paper_id} - 学者:
https://www.aminer.cn/profile/{scholar_id} - 专利:
https://www.aminer.cn/patent/{patent_id} - 会议:
https://www.aminer.cn/open/journal/detail/{venue_id}
- 论文:
Token 检查(必需)
进行任何 API 调用之前,请确认环境变量 AMINER_API_KEY 存在。切勿以纯文本形式输出该令牌。
if [ -z "${AMINER_API_KEY+x}" ]; then
echo "AMINER_API_KEY does not exist"
else
echo "AMINER_API_KEY exists"
fi
- 如果
${AMINER_API_KEY}存在:继续查询。 - 如果未设置
${AMINER_API_KEY}:立即停止,并引导用户前往 AMiner 控制台 生成令牌。如需帮助,请参阅 开放平台文档。 - 如果用户直接提供
AMINER_API_KEY(例如“我的令牌是 xxx”),则在当前会话中接受该令牌,但建议将其设置为环境变量,以提高安全性。
调用方式
默认直接使用 curl 调用。此技能不要求使用 Python 封装程序。
默认请求头:
- 默认使用
Authorization: ${AMINER_API_KEY} - POST 请求使用
Content-Type: application/json;charset=utf-8 X-Platform(当前主机:claude-code/cursor/codex/openclaw;如果无法确定,则为unknown)- 每次调用均使用
X-Skill-Name: aminer-free-academic和X-Skill-Version(此文件 frontmatter 中的version)
适用场景
用户提出以下需求时使用此技能:
- 免费搜索 AMiner
- 低成本学术发现
- 论文筛选
- 学者身份识别
- 机构名称规范化
- 会议名称规范化
- 专利趋势扫描
- 在深入分析前获取代表性结果
触发语包括:
- “先用免费接口”
- “不要走收费接口”
- “先帮我筛一下”
- “先看看值不值得深挖”
- “找几个候选”
- “做一个轻量版 skill”
免费工作流
1. 论文初筛
当用户想快速判断一篇论文是否相关时使用。
默认链路:
paper_search -> paper_info
**
paper_search不只是按标题查找。**它唯一的query框会同时匹配标题和关键词,因此主题短语(retrieval augmented generation)、已知标题或简短问题都能免费返回相关结果,year_from/year_to可缩小时间范围。它的实际限制是:size≤ 20,最多 10 页,不支持按字段筛选(作者 / 机构 / 会议或期刊 / 摘要),也不支持排序。需要其中任何一项时,就该使用aminer-academic-search(paper_search_pro,¥0.01)。
返回:
- 标题
- 第一作者
- 会议或期刊名称
- 年份
- 引用量区间
- 摘要片段
- 论文 URL
可用于回答:
- 这很可能是目标论文吗?
- 这篇论文最近吗?
- 它来自知名的会议或期刊吗?
- 值得深入查看吗?
2. 学者识别
当用户想知道哪位学者才是目标人物时使用。
默认链路:
person_search
返回:
- 姓名
- 机构
- 研究兴趣
- 引用次数
- 学者 URL
可用于回答:
- 这是目标学者吗?
- 哪些研究兴趣最能描述此人?
- 哪个机构候选项最匹配?
3. 机构名称规范化
当用户提供机构名称或缩写时使用。
默认链路:
organization_search
返回:
- 机构 ID
- 标准名称
- 别名(前 3 个)
可用于回答:
- 系统能识别这个机构名称吗?
- 后续工作流应使用哪个规范组织实体?
4. 会议或期刊名称规范化与类型检查
当用户提供会议或期刊名称时使用。
默认链路:
venue_search
返回:
- 会议或期刊 ID
- 标准双语名称
- 别名(前 3 个)
- 会议或期刊类型
- 会议或期刊 URL
可用于回答:
- 这是会议还是期刊?
- 标准的会议或期刊实体是什么?
5. 专利趋势扫描
当用户想大致了解某个主题的专利情况时使用。
默认链路:
patent_search -> patent_info(需要补充 ID 的基本信息时)
返回:
- 专利标题
- 第一发明人
- 申请年份
- 公开年份
- 添加
patent_info时提供专利号和国家 - 专利 URL
可用于回答:
- 近期该主题活跃吗?
- 发明人字段中谁排在第一位?
- 近期是否有值得深入审查的专利活动?
6. 免费实体图谱
当用户希望快速了解某个主题在论文、学者、会议或期刊、机构和专利中的分布,且无需使用付费的分析级 API 时使用。
建议链路:
- 论文:
paper_search -> paper_info - 学者:
person_search - 机构:
organization_search - 会议或期刊:
venue_search - 专利:
patent_search -> patent_info
返回简短的跨实体摘要,而不是深度报告。
免费技能示例
1. 论文初筛
curl -X GET \
'https://datacenter.aminer.cn/gateway/open_platform/api/paper/search?page=1&size=5&query=Attention%20Is%20All%20You%20Need' \
-H "Authorization: ${AMINER_API_KEY}" \
-H 'X-Platform: claude-code' \
-H 'X-Skill-Name: aminer-free-academic' \
-H 'X-Skill-Version: 1.3.0'
然后使用 paper_info 补充信息:
curl -X POST \
'https://datacenter.aminer.cn/gateway/open_platform/api/paper/info' \
-H 'Content-Type: application/json;charset=utf-8' \
-H "Authorization: ${AMINER_API_KEY}" \
-H 'X-Platform: claude-code' \
-H 'X-Skill-Name: aminer-free-academic' \
-H 'X-Skill-Version: 1.3.0' \
-d '{"ids":["<PAPER_ID>"]}'
2. 学者识别
curl -X POST \
'https://datacenter.aminer.cn/gateway/open_platform/api/person/search' \
-H 'Content-Type: application/json;charset=utf-8' \
-H "Authorization: ${AMINER_API_KEY}" \
-H 'X-Platform: claude-code' \
-H 'X-Skill-Name: aminer-free-academic' \
-H 'X-Skill-Version: 1.3.0' \
-d '{"name":"Yann LeCun","size":5}'
3. 机构名称规范化
curl -X POST \
'https://datacenter.aminer.cn/gateway/open_platform/api/organization/search' \
-H 'Content-Type: application/json;charset=utf-8' \
-H "Authorization: ${AMINER_API_KEY}" \
-H 'X-Platform: claude-code' \
-H 'X-Skill-Name: aminer-free-academic' \
-H 'X-Skill-Version: 1.3.0' \
-d '{"orgs":["MIT CSAIL"]}'
4. 会议或期刊名称规范化与类型检查
curl -X POST \
'https://datacenter.aminer.cn/gateway/open_platform/api/venue/search' \
-H 'Content-Type: application/json;charset=utf-8' \
-H "Authorization: ${AMINER_API_KEY}" \
-H 'X-Platform: claude-code' \
-H 'X-Skill-Name: aminer-free-academic' \
-H 'X-Skill-Version: 1.3.0' \
-d '{"name":"tkde"}'
5. 专利趋势扫描
curl -X POST \
'https://datacenter.aminer.cn/gateway/open_platform/api/patent/search' \
-H 'Content-Type: application/json;charset=utf-8' \
-H "Authorization: ${AMINER_API_KEY}" \
-H 'X-Platform: claude-code' \
-H 'X-Skill-Name: aminer-free-academic' \
-H 'X-Skill-Version: 1.3.0' \
-d '{"query":"quantum computing chip","page":0,"size":10}'
输出格式
优先采用以下结构:
## Free-tier result
### What we can answer now
- ...
### Top candidates
- ...
### Suggested next step
- Stay free: ...
- Upgrade to paid API only if you need: ...
付费升级边界
仅当用户需要以下内容之一时,才建议升级:
- 完整摘要或完整论文元数据
- 按字段搜索论文(作者 / 机构 / 会议或期刊 / 摘要)、排序,或每页超过 20 条结果
- 对复杂研究问题进行语义理解
- 引用关系
- 完整的学者档案、作品、专利或项目
- 机构的学者、论文、专利或详细档案
- 按年份列出的会议或期刊论文清单
- IPC/CPC、受让人、描述等完整专利详情
建议的付费升级选项:
- 深入分析论文:
paper_search_pro、paper_detail、paper_relation - 深入分析学者:
person/detail、person/figure、person/paper/relation - 深入分析机构:
organization/detail、organization/person/relation、organization/paper/relation - 深入分析会议或期刊:
venue/detail、venue/paper/relation - 深入分析专利:
patent/detail
产品定位
此技能有意定位于:
- 初次成功
- 免费发现
- 候选项筛选
- 实体规范化
- 升级资格判定
它不应取代付费技能,而应为其创造需求。
补充参考
有关端点参数和字段,请阅读 references/api-catalog.md。