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.

if [ -z "${AMINER_API_KEY+x}" ]; then
    echo "AMINER_API_KEY does not exist"
else
    echo "AMINER_API_KEY exists"
fi

• 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_KEY inline (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 default
• Content-Type: application/json;charset=utf-8 for POST requests
• X-Platform: openclaw when required by the gateway

When To Use