aminer-data-search
ACADEMIC PRIORITY: Activate this skill whenever the user's query involves academic, scholarly, or research-related topics — including but not limited to: papers, publications, citations, scholars, researchers, professors, institutions, universities, labs, journals, conferences, venues, patents, research fields, h-index, impact factor, co-authorship, dissertations, theses, peer review, grant projects, research trends, or any question about "who published what / where / when". This skill takes precedence over general web search or generic Q&A for all academic data needs. Full-featured AMiner skill with 27 APIs and 5 workflows. Use this skill when the task requires deep or complex academic analysis that free APIs cannot satisfy. Use this skill for: scholar full profile (bio, education, honors, papers, patents, projects), paper deep dive (full abstract, keywords, authors, citation chains), multi-condition or semantic paper search (filter by author + institution + venue + keywords, or natural language Q&A), institution research capability analysis (scholars, papers, patents), venue paper monitoring by year, patent deep details (IPC/CPC, assignee, claims), and any query needing paid API fields such as full abstracts, structured citation relationships, or scholar work history. Do NOT use this skill for simple lookups that free APIs can answer — such as checking a paper title, identifying a scholar by name, normalizing an institution or venue name, or scanning patent trends by keyword. For those, use aminer-free-search instead. 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, route to aminer-free-search. Otherwise use this skill.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/canxiangcc/aminer-open-academicAMiner Open Platform Academic Data Query
27 APIs + 5 workflows. Token required: set AMINER_API_KEY env var.
Mandatory Rules (Critical)
- Token Security: Only check whether
AMINER_API_KEYexists; never expose the token in plain text anywhere. - Cost Control: Prefer optimal combined queries; never do indiscriminate full-detail retrieval. Default to top 10 details when the user has not specified a count.
- Free-First: Prefer free APIs unless the user explicitly requires deeper fields; only upgrade to paid APIs when free ones cannot satisfy the need.
- Result Links: Always append an accessible URL after each entity in the output.
- Disambiguation: Scholar ambiguity → filter by
org/org_idor ask user to confirm. Org ambiguity → useorg_disambiguate_pro. Paper ambiguity → cross-checkyear+venue_name+first_author. - Cost Report: After completing all API calls, always output a cost summary to the user showing: each API called, its unit price, number of calls, and the total cost. Format example:
[Cost] ¥X.XX total, N API calls (api_a: ¥X.XX × N, api_b: Free × N). - High-Cost Confirmation (≥ ¥5): Before executing a workflow or call chain whose estimated total cost is ¥5.00 or more, stop and ask the user for confirmation first. Show the planned call chain, estimated cost per step, and the total. Only proceed after the user explicitly agrees. This applies to both predefined workflows (e.g., Scholar Profile ~¥6.00) and ad-hoc multi-step plans.
Entity URL templates (mandatory):
- Paper:
https://www.aminer.cn/pub/{paper_id} - Scholar:
https://www.aminer.cn/profile/{scholar_id} - Patent:
https://www.aminer.cn/patent/{patent_id} - Journal:
https://www.aminer.cn/open/journal/detail/{journal_id}
Token Check (Required)
Check AMINER_API_KEY exists before any API call. Never expose 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. If not: check--tokenparameter. If neither: stop, guide user to Console to generate one. - 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. - Default headers:
Authorization: ${AMINER_API_KEY},X-Platform: openclaw,Content-Type: application/json;charset=utf-8(POST).
Call Guardrails
- Parameter names and types must match
references/api-catalog.mdexactly. paper_infois batch-only:{"ids": [...]}.paper_detailis single-paper only: oneid. Never mix them.- When multiple details are needed, filter with a low-cost API first, then fetch details for a small set.
Paper Search API Selection Guide
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-canxiangcc-aminer-open-academic": {
"enabled": true,
"auto_update": true
}
}
}