aminer-free-academic

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_search
• paper_info
• person_search
• organization_search
• venue_search
• patent_search
• patent_info

Current free-tier fields emphasized by this skill:

• paper_search: venue_name, first_author, n_citation_bucket, year
• paper_info: abstract_slice, year, venue_id, author_count
• organization_search: aliases (top 3)
• venue_search: aliases (top 3), venue_type
• patent_search: inventor_name (first), app_year, pub_year
• patent_info: app_year, pub_year
• person_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

1. Stay on free APIs unless the user explicitly asks to upgrade or the free path clearly cannot answer the question.
2. Be explicit about free-tier limits. Say what can be answered now and what would require a paid upgrade.
3. Use free results to narrow candidates before suggesting any paid API.
4. 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}

Token Check (Required)

Before making any API call, verify that the environment variable AMINER_API_KEY exists. Never output the token in plain text.