aminer-free-academic

Name: aminer-free-academic
Author: aminerorg

github.com/aminerorg生产力7863 次安装2 天前更新

代码仓库

关于 aminer-free-academic

aminer-free-academic 是面向学术检索初筛的 AMiner 技能，优先使用免费接口查找论文、学者、机构、会议和专利。它侧重候选筛选与实体名称规范化，并说明免费查询的边界。

主要功能

01免费论文检索与信息补充
02学者识别与机构匹配
03机构及会议名称规范化
04专利主题初步扫描
05免费接口限制与升级边界说明

适用场景

01快速判断论文是否值得深入阅读
02根据姓名和机构辨认学者
03统一机构或会议的标准名称
04初步查看某主题的专利活动

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aminerorg/aminer-research-skills --skill aminer-free-academic

安装后在 Claude Code 中输入/aminer-free-academic确认已加载。

详细介绍

AMiner 免费搜索

当 AMiner 请求应优先使用免费套餐时，请使用此技能。它适用于发现、初步筛选和实体规范化，不适用于深入分析。

范围

此技能仅使用升级后的免费接口：

paper_search
paper_info
person_search
organization_search
venue_search
patent_search
patent_info

此技能重点介绍的当前免费套餐字段：

paper_search：一个搜索框 query，用于搜索标题 + 关键词；可选 year / year_from / year_to；返回 doi、venue_name、first_author、n_citation_bucket、year
paper_info：abstract_slice、year、venue_id、author_count
organization_search：aliases（前 3 个）
venue_search：aliases（前 3 个）、venue_type
patent_search：inventor_name（第一位）、app_year、pub_year
patent_info：app_year、pub_year
person_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 存在。切勿以纯文本形式输出该令牌。

[ -z "${AMINER_API_KEY+x}" ] && echo "AMINER_API_KEY missing" || echo "AMINER_API_KEY exists"

如果 ${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（需要补充基本信息时）

专利标题
第一发明人
申请年份
公布年份
添加 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: ...

付费升级边界

仅当用户需要以下某项功能时，才建议升级：

完整摘要、精确引用次数（n_citation）或完整论文元数据
按字段搜索论文（作者／机构／发表 venue／摘要）、排序，或每页超过 20 条结果
理解复杂研究问题的语义
引用关系
完整学者档案、作品、专利或项目
机构学者、论文、专利或详细档案
按年份查看 venue 论文列表
专利的完整详情，例如 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：venue/detail、venue/paper/relation
深入分析专利：patent/detail

产品定位

此技能的定位旨在帮助用户实现：

首次成功
免费探索
缩小候选范围
实体规范化
判断升级需求

它不应取代付费技能，而应为其创造需求。

其他参考资料

如需了解端点参数和字段，请阅读 references/api-catalog.md。

支持 Markdown

登录后评论

基本信息

作者: aminerorg
仓库: aminerorg/aminer-research-skills
分类: 生产力
安装次数: 63
GitHub Stars: 78

报告问题