---

name: aminer-data-search version: 1.0.0 description: > Academic data search and analysis using AMiner Open Platform APIs. Query scholars, papers, institutions, journals, and patents. Includes 6 composite workflows (Scholar Profile, Paper Deep Dive, Org Analysis, Venue Papers, Paper QA, Patent Analysis) and 28 individual APIs. Triggers: "AMiner", "学术数据", "查论文", "查学者", "学术搜索", "academic search", "paper search", "scholar lookup", "citation analysis". tags: [academic, research, aminer, scholar, paper, journal, patent, citation, chinese, english] env: AMINER_TOKEN: "AMiner API Token (from https://open.aminer.cn/open/board?tab=control)"

AMiner Academic Data Search (学术数据查询)

AMiner is a leading global academic data platform. This skill covers all 28 open APIs organized into 6 practical workflows for comprehensive academic research.

• API Docs: https://open.aminer.cn/open/doc
• Console (Token): https://open.aminer.cn/open/board?tab=control

---

Getting Started

1. Get API Token

1. Visit AMiner Console
2. Login and generate an API Token
3. Token goes in Authorization header for all requests

2. Quick Usage

# Scholar profile analysis
python scripts/aminer_client.py --token <TOKEN> --action scholar_profile --name "Andrew Ng"

# Paper deep dive (with citation chain)
python scripts/aminer_client.py --token <TOKEN> --action paper_deep_dive --title "Attention is all you need"

# Organization analysis
python scripts/aminer_client.py --token <TOKEN> --action org_analysis --org "清华大学"

# Venue/journal paper monitoring
python scripts/aminer_client.py --token <TOKEN> --action venue_papers --venue "Nature" --year 2024

# Academic Q&A (natural language)
python scripts/aminer_client.py --token <TOKEN> --action paper_qa --query "transformer架构最新进展"

# Patent search
python scripts/aminer_client.py --token <TOKEN> --action patent_search --query "量子计算"

---

Reliability & Error Handling

Built-in resilience:

• Timeout: 30s default
• Retries: Max 3 with exponential backoff (1s → 2s → 4s) + jitter
• Retryable: 408 / 429 / 500 / 502 / 503 / 504
• Degradation: paper_deep_dive auto-falls back to paper_search_pro; paper_qa degrades to paper_search_pro
• Traceability: Composite workflow output includes source_api_chain

---

Paper Search API Selection Guide

API	Focus	Use Case	Cost
paper_search	Title lookup → paper_id	Known paper title	Free
paper_search_pro	Multi-condition search	Filter by author/org/venue	¥0.01
paper_qa_search	Natural language Q&A	Semantic search	¥0.05
paper_list_by_search_venue	Rich paper info	Analysis/reports	¥0.30
paper_list_by_keywords	Multi-keyword batch	Topic batch retrieval	¥0.10
paper_detail_by_condition	Year + venue filter	Annual venue monitoring	¥0.20

Recommended routing:

1. Known title → paper_search → paper_detail → paper_relation
2. Condition filter → paper_search_pro → paper_detail
3. Natural language → paper_qa_search (fallback: paper_search_pro)
4. Venue analysis → venue_search → venue_paper_relation → paper_detail_by_condition

---

6 Composite Workflows

1. Scholar Profile (学者全景分析)

Use: Complete academic profile of a scholar.

Scholar Search (name → person_id)
    ↓
Parallel:
  ├── Scholar Detail (bio/education/honors)
  ├── Scholar Figure (research areas/interests)
  ├── Scholar Papers (publication list)
  ├── Scholar Patents (patent list)
  └── Scholar Projects (grants/funding)

python scripts/aminer_client.py --token <TOKEN> --action scholar_profile --name "Yann LeCun"

2. Paper Deep Dive (论文深度挖掘)

Use: Full paper info + citation chain.

Paper Search (title → paper_id)
    ↓
Paper Detail (abstract/authors/DOI/venue/year)
    ↓
Paper Citations (cited papers → cited_ids)
    ↓
(Optional) Batch paper info for cited papers

python scripts/aminer_client.py --token <TOKEN> --action paper_deep_dive --title "BERT"

3. Organization Analysis (机构研究力分析)

Use: Analyze an institution's research capabilities.

Org Disambiguation Pro (raw string → org_id)
    ↓
Parallel:
  ├── Org Detail (intro/type/founded)
  ├── Org Scholars (scholar list)
  ├── Org Papers (paper list)
  └── Org Patents (patent list, up to 10k)

python scripts/aminer_client.py --token <TOKEN> --action org_analysis --org "MIT"

4. Venue Papers (期刊论文监控)

Use: Track papers from a specific journal/venue by year.

Venue Search (name → venue_id)
    ↓
Venue Detail (ISSN/type/abbreviation)
    ↓
Venue Papers (venue_id + year → paper_ids)
    ↓
(Optional) Batch paper details

python scripts/aminer_client.py --token <TOKEN> --action venue_papers --venue "NeurIPS" --year 2023

5. Paper Q&A (学术智能问答)

Use: Natural language academic search.

Supports: query (natural language), topic_high/middle/low (keyword weights), sci_flag, force_citation_sort, author_terms, org_terms.

python scripts/aminer_client.py --token <TOKEN> --action paper_qa \
  --query "用于蛋白质结构预测的深度学习方法"

6. Patent Analysis (专利链分析)

Use: Search patents by technology domain.

Patent Search (query → patent_id)
    ↓
Patent Detail (abstract/filing date/assignee/inventor)

python scripts/aminer_client.py --token <TOKEN> --action patent_search --query "量子计算芯片"

---

Full API Reference

#	API	Method	Cost	Path
1	Paper QA Search	POST	¥0.05	/api/paper/qa/search
2	Scholar Search	POST	Free	/api/person/search
3	Paper Search	GET	Free	/api/paper/search
4	Paper Search Pro	GET	¥0.01	/api/paper/search/pro
5	Patent Search	POST	Free	/api/patent/search
6	Org Search	POST	Free	/api/organization/search
7	Venue Search	POST	Free	/api/venue/search
8	Scholar Detail	GET	¥1.00	/api/person/detail
9	Scholar Projects	GET	¥3.00	/api/project/person/v3/open
10	Scholar Papers	GET	¥1.50	/api/person/paper/relation
11	Scholar Patents	GET	¥1.50	/api/person/patent/relation
12	Scholar Figure	GET	¥0.50	/api/person/figure
13	Paper Info	POST	Free	/api/paper/info
14	Paper Detail	GET	¥0.01	/api/paper/detail
15	Paper Citation	GET	¥0.10	/api/paper/relation
16	Patent Info	GET	Free	/api/patent/info
17	Patent Detail	GET	¥0.01	/api/patent/detail
18	Org Detail	POST	¥0.01	/api/organization/detail
19	Org Patents	GET	¥0.10	/api/organization/patent/relation
20	Org Scholars	GET	¥0.50	/api/organization/person/relation
21	Org Papers	GET	¥0.10	/api/organization/paper/relation
22	Venue Detail	POST	¥0.20	/api/venue/detail
23	Venue Papers	POST	¥0.10	/api/venue/paper/relation
24	Org Disambiguation	POST	¥0.01	/api/organization/na
25	Org Disambiguation Pro	POST	¥0.05	/api/organization/na/pro
26	Paper Search (venue)	GET	¥0.30	/api/paper/list/by/search/venue
27	Paper Batch (keywords)	GET	¥0.10	/api/paper/list/citation/by/keywords
28	Paper Detail (condition)	GET	¥0.20	/api/paper/platform/allpubs/more/detail/by/ts/org/venue

Base URL: https://datacenter.aminer.cn/gateway/open_platform

---

References

• Official Docs: https://open.aminer.cn/open/doc
• Console: https://open.aminer.cn/open/board?tab=control