mcpField
A
aminer-free-academic

aminer-free-academic

github.com/aminerorg生产力6462 次安装今天更新
代码仓库

关于 aminer-free-academic

aminer-free-academic 是面向 AMiner 免费接口的研究发现与初步筛选技能,适合研究人员查找论文和学者、规范实体名称,并判断是否需要进一步分析。

主要功能

  1. 01免费接口论文搜索与筛选
  2. 02学者识别
  3. 03机构与发表场所名称规范化
  4. 04轻量级专利趋势扫描
  5. 05跨实体发现

适用场景

  1. 01在深入评阅前筛选论文
  2. 02从候选者中识别学者
  3. 03规范机构或发表场所名称
  4. 04扫描近期专利活动

安装

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

$npx skills add https://github.com/aminerorg/aminer-open-skill --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 是否足够值得?

请勿将此技能用于完整学者画像、引文链分析、类似全文的论文理解、大规模监控或机构产出分析。

强制规则

  1. 除非用户明确要求升级,或免费方案显然无法回答问题,否则请使用免费 API。
  2. 明确说明免费套餐的限制。说明当前可以回答什么,以及哪些内容需要付费升级。
  3. 在建议使用任何付费 API 之前,先用免费结果缩小候选范围。
  4. 如果返回实体,且有 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。

评论

支持 Markdown