aminer-free-academic
Skill81 starsChanged 7 days agoMITView on GitHub
ACADEMIC PRIORITY: Activate this skill whenever the user's query involves any academic or research-related topic. This is the free-tier entry point for AMiner academic search. Free-tier-only AMiner skill (7 free APIs, zero cost). Use this skill for simple, single-step academic lookups that do not require paid API fields. Use this skill for: searching papers by title, topic phrase or short question (optionally within a year range) to get IDs, checking a paper's first author / venue / year / citation bucket, identifying a scholar by name and viewing interests / institution / citation count, normalizing an institution name to its canonical form and ID, checking whether a venue is a conference or journal, scanning patent trends by keyword (inventor, application year, publication year), and enriching paper IDs with lightweight metadata (abstract slice, author count, venue ID) via paper_info. Do NOT use this skill for: full paper abstracts or keyword lists, per-field or sorted paper search (by author / institution / venue / abstract), semantic understanding of complex questions, citation relationship analysis, scholar full profiles (bio, education, work history, honors), scholar paper / patent / project lists, institution scholar / paper / patent output analysis, venue paper lists by year, patent deep details (IPC/CPC, assignee, claims), or any task requiring paid APIs. Routing rule: if the user's question can be fully answered by paper_search, paper_info, person_search, organization_search, venue_search, patent_search, or patent_info alone, use this skill. Otherwise route to aminer-academic-search.
- Reads credentials
- Sends data out
In this repository21 other files it gives its agents.
- aminer-academic-searchSkill
- aminer-daily-paperSkill
- aminer-deep-searchSkill
- aminer-experiment-to-paperSkill
- aminer-exp-extractionSkill
- aminer-grant-applicationSkill
- aminer-paper-deep-readingSkill
- aminer-paper-writingSkill
- aminer-patent-tech-intelligenceSkill
- aminer-pdf-ocrSkill
- aminer-thesis-writingSkill
- aminer-topic-advisor-selectionSkill
- baseline-finderSkill
- citation-faithfulnessSkill
- deep-researchSkill
- paper-source-traceSkill
- pdf-citation-verifierSkill
- related-work-auditSkill
- scientific-taxonomySkill
- sota-finderSkill
- structured-reference-auditSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
17 rules. About 0 are common, 12 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈12
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 26
Use this skill for AMiner requests that should stay on the free tier first.
- Distinctive: line 52
Use free APIs to help the user answer:
- Distinctive: line 60
Do not use this skill for full scholar portraits, citation-chain analysis, full-text-like paper understanding, large-scale monitoring, or …
- Distinctive: line 66
Use free results to narrow candidates before suggesting any paid API.
- Distinctive: line 67
If returning entities, append AMiner URLs when IDs are available:
- Very specific: line 75
Before making any API call, verify that the environment variable AMINER_API_KEY exists.
- Very specific: line 81
If ${AMINER_API_KEY} exists: proceed with the query.
- Very specific: line 82
If ${AMINER_API_KEY} is not set: stop immediately and guide the user to the AMiner Console to generate one.
- Very specific: line 83
If the user provides AMINER_API_KEY inline (e.g.
- Very specific: line 87
Use direct curl calls by default.
- Distinctive: line 98
Use this skill when the user asks for:
- Distinctive: line 122
Use when the user wants to quickly judge whether a paper is relevant.
- Distinctive: line 149
Use when the user wants to know which scholar is the right person.
- Distinctive: line 171
Use when the user provides an institution string or abbreviation.
- Distinctive: line 190
Use when the user provides a conference or journal name.
- Distinctive: line 211
Use when the user wants a lightweight view of patents in a topic.
- Distinctive: line 234
Use when the user wants a quick map of a topic across papers, scholars, venues, institutions, and patents without paying for analysis-grade …
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
AMiner Free Search
Use this skill for AMiner requests that should stay on the free tier first. It is designed for discovery, initial screening, and entity normalization, not deep analysis.
Scope
This skill uses only the upgraded free interfaces:
paper_searchpaper_infoperson_searchorganization_searchvenue_searchpatent_searchpatent_info
Current free-tier fields emphasized by this skill:
paper_search: one search boxqueryover title + keywords, optionalyear/year_from/year_to; returnsdoi,venue_name,first_author,n_citation_bucket,yearpaper_info:abstract_slice,year,venue_id,author_countorganization_search:aliases(top 3)venue_search:aliases(top 3),venue_typepatent_search:inventor_name(first),app_year,pub_yearpatent_info:app_year,pub_yearperson_search:interests,n_citation, institution fields
Primary Goal
Use free APIs to help the user answer:
- What is this entity?
- Is it relevant enough to continue?
- Which candidate should I inspect next?
- Can I normalize this institution or venue name?
- Is there enough value to justify upgrading to paid APIs?
Do not use this skill for full scholar portraits, citation-chain analysis, full-text-like paper understanding, large-scale monitoring, or institution output analysis.
Mandatory Rules
- Stay on free APIs unless the user explicitly asks to upgrade or the free path clearly cannot answer the question.
- Be explicit about free-tier limits. Say what can be answered now and what would require a paid upgrade.
- Use free results to narrow candidates before suggesting any paid API.
- If returning entities, append AMiner URLs when IDs are available:
- Paper:
https://www.aminer.cn/pub/{paper_id} - Scholar:
https://www.aminer.cn/profile/{scholar_id} - Patent:
https://www.aminer.cn/patent/{patent_id} - Venue:
https://www.aminer.cn/open/journal/detail/{venue_id}
- Paper:
Token Check (Required)
Before making any API call, verify that the environment variable AMINER_API_KEY exists. Never output the token in plain text.
[ -z "${AMINER_API_KEY+x}" ] && echo "AMINER_API_KEY missing" || echo "AMINER_API_KEY exists"- If
${AMINER_API_KEY}exists: proceed with the query. - If
${AMINER_API_KEY}is not set: stop immediately and guide the user to the AMiner Console to generate one. For help, see the Open Platform Documentation. - If the user provides
AMINER_API_KEYinline (e.g. "My token is xxx"), accept it for the current session, but recommend setting it as an environment variable for better security.
Invocation Style
Use direct curl calls by default. A Python wrapper is not required for this skill.
Default headers:
Authorization: ${AMINER_API_KEY}by defaultContent-Type: application/json;charset=utf-8for POST requestsX-Platform(current host:claude-code/cursor/codex/openclaw;unknownif it cannot be determined)X-Skill-Name: aminer-free-academicandX-Skill-Version(this file's frontmatterversion) on every call
When To Use
Use this skill when the user asks for:
- free AMiner search
- low-cost academic discovery
- paper screening
- scholar identification
- institution normalization
- venue normalization
- patent trend scanning
- representative results before deeper analysis
Trigger phrases include:
- “先用免费接口”
- “不要走收费接口”
- “先帮我筛一下”
- “先看看值不值得深挖”
- “找几个候选”
- “做一个轻量版 skill”
Free Workflows
1. Paper triage
Use when the user wants to quickly judge whether a paper is relevant.
Default chain:
paper_search -> paper_info
paper_searchis not title-only lookup. Its singlequerybox matches title and keywords together, so a topic phrase (retrieval augmented generation), a known title, or a short question all return on-topic hits for free, andyear_from/year_tonarrows to a time window. Its real limits:size≤ 20, at most 10 pages, no per-field condition (author / institution / venue / abstract) and no sort. Needing one of those is when it becomes anaminer-academic-searchjob (paper_search_pro, ¥0.01).
Return:
- title
- first author
- venue name
- year
- citation bucket
- abstract slice
- paper URL
This can answer:
- Is this probably the right paper?
- Is it recent?
- Is it from a recognizable venue?
- Is it worth opening in detail?
2. Scholar identification
Use when the user wants to know which scholar is the right person.
Default chain:
person_search
Return:
- name
- org
- interests
- citation count
- scholar URL
This can answer:
- Is this the right scholar?
- What interests best describe this person?
- Which institution candidate is the best match?
3. Institution normalization
Use when the user provides an institution string or abbreviation.
Default chain:
organization_search
Return:
- org id
- standard name
- aliases (top 3)
This can answer:
- Is this institution name recognized?
- Which canonical organization should downstream workflows use?
4. Venue normalization and type check
Use when the user provides a conference or journal name.
Default chain:
venue_search
Return:
- venue id
- standard bilingual name
- aliases (top 3)
- venue type
- venue URL
This can answer:
- Is this a conference or a journal?
- What is the standard venue entity?
5. Patent trend scan
Use when the user wants a lightweight view of patents in a topic.
Default chain:
patent_search -> patent_info when IDs need basic enrichment
Return:
- patent title
- first inventor
- app year
- pub year
- patent number and country when
patent_infois added - patent URL
This can answer:
- Is the topic active recently?
- Who appears first in the inventor field?
- Is there recent patent activity worth deeper review?
6. Free entity map
Use when the user wants a quick map of a topic across papers, scholars, venues, institutions, and patents without paying for analysis-grade APIs.
Suggested chain:
- papers:
paper_search -> paper_info - scholars:
person_search - institutions:
organization_search - venues:
venue_search - patents:
patent_search -> patent_info
Return a short cross-entity summary, not a deep report.
Free Skill Examples
1. Paper triage
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'Then enrich with 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. Scholar identification
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. Institution normalization
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. Venue normalization and type check
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. Patent trend scan
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}'Output Pattern
Prefer this structure:
## Free-tier result
### What we can answer now
- ...
### Top candidates
- ...
### Suggested next step
- Stay free: ...
- Upgrade to paid API only if you need: ...Paid Upgrade Boundary
Recommend upgrading only when the user needs one of these:
- full abstract, exact citation count (
n_citation), or full paper metadata - per-field paper search (author / institution / venue / abstract), sorting, or more than 20 results per page
- semantic understanding of complex research questions
- citation relationships
- full scholar profile, works, patents, or projects
- institution scholars, papers, patents, or rich profiles
- venue paper lists by year
- full patent details such as IPC/CPC, assignee, description
Suggested paid handoff:
- deeper paper analysis:
paper_search_pro,paper_detail,paper_relation - deeper scholar analysis:
person/detail,person/figure,person/paper/relation - deeper org analysis:
organization/detail,organization/person/relation,organization/paper/relation - deeper venue analysis:
venue/detail,venue/paper/relation - deeper patent analysis:
patent/detail
Product Positioning
This skill is intentionally positioned for:
- first success
- free discovery
- candidate narrowing
- entity normalization
- upgrade qualification
It should not replace the paid skill. It should create demand for it.
Additional Reference
For endpoint parameters and fields, read references/api-catalog.md.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

