{"skill":{"slug":"aminer-free-academic","displayName":"aminer-free-search","summary":"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 AMine...","description":"---\nname: aminer-free-search\nversion: 1.1.0\nauthor: AMiner\ncontact: report@aminer.cn\ndescription: >\n  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.\n  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.\n  Use this skill for: searching a paper by title to get its ID, 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.\n  Do NOT use this skill for: full paper abstracts or keyword lists, multi-condition or semantic paper search, 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.\n  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-data-search.\nmetadata:\n  {\n    \"openclaw\":\n      {\n        \"requires\": {\"env\": [\"AMINER_API_KEY\"] },\n        \"primaryEnv\": \"AMINER_API_KEY\"\n      }\n  }\n---\n\n# AMiner Free Search\n\nUse 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.\n\n## Scope\n\nThis skill uses only the upgraded free interfaces:\n\n- `paper_search`\n- `paper_info`\n- `person_search`\n- `organization_search`\n- `venue_search`\n- `patent_search`\n- `patent_info`\n\nCurrent free-tier fields emphasized by this skill:\n\n- `paper_search`: `venue_name`, `first_author`, `n_citation_bucket`, `year`\n- `paper_info`: `abstract_slice`, `year`, `venue_id`, `author_count`\n- `organization_search`: `aliases` (top 3)\n- `venue_search`: `aliases` (top 3), `venue_type`\n- `patent_search`: `inventor_name` (first), `app_year`, `pub_year`\n- `patent_info`: `app_year`, `pub_year`\n- `person_search`: `interests`, `n_citation`, institution fields\n\n## Primary Goal\n\nUse free APIs to help the user answer:\n\n- What is this entity?\n- Is it relevant enough to continue?\n- Which candidate should I inspect next?\n- Can I normalize this institution or venue name?\n- Is there enough value to justify upgrading to paid APIs?\n\nDo not use this skill for full scholar portraits, citation-chain analysis, full-text-like paper understanding, large-scale monitoring, or institution output analysis.\n\n## Mandatory Rules\n\n1. Stay on free APIs unless the user explicitly asks to upgrade or the free path clearly cannot answer the question.\n2. Be explicit about free-tier limits. Say what can be answered now and what would require a paid upgrade.\n3. Use free results to narrow candidates before suggesting any paid API.\n4. If returning entities, append AMiner URLs when IDs are available:\n   - Paper: `https://www.aminer.cn/pub/{paper_id}`\n   - Scholar: `https://www.aminer.cn/profile/{scholar_id}`\n   - Patent: `https://www.aminer.cn/patent/{patent_id}`\n   - Venue: `https://www.aminer.cn/open/journal/detail/{venue_id}`\n\n## Token Check (Required)\n\nBefore making any API call, verify that the environment variable `AMINER_API_KEY` exists. Never output the token in plain text.\n\n```bash\nif [ -z \"${AMINER_API_KEY+x}\" ]; then\n    echo \"AMINER_API_KEY does not exist\"\nelse\n    echo \"AMINER_API_KEY exists\"\nfi\n```\n\n- If `${AMINER_API_KEY}` exists: proceed with the query.\n- If `${AMINER_API_KEY}` is not set: stop immediately and guide the user to the [AMiner Console](https://open.aminer.cn/open/board?tab=control) to generate one. For help, see the [Open Platform Documentation](https://open.aminer.cn/open/docs).\n- 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.\n\n## Invocation Style\n\nUse direct `curl` calls by default. A Python wrapper is not required for this skill.\n\nDefault headers:\n\n- `Authorization: ${AMINER_API_KEY}` by default\n- `Content-Type: application/json;charset=utf-8` for POST requests\n- `X-Platform: openclaw` when required by the gateway\n\n## When To Use\n\nUse this skill when the user asks for:\n\n- free AMiner search\n- low-cost academic discovery\n- paper screening\n- scholar identification\n- institution normalization\n- venue normalization\n- patent trend scanning\n- representative results before deeper analysis\n\nTrigger phrases include:\n\n- “先用免费接口”\n- “不要走收费接口”\n- “先帮我筛一下”\n- “先看看值不值得深挖”\n- “找几个候选”\n- “做一个轻量版 skill”\n\n## Free Workflows\n\n### 1. Paper triage\n\nUse when the user wants to quickly judge whether a paper is relevant.\n\nDefault chain:\n\n`paper_search -> paper_info`\n\nReturn:\n\n- title\n- first author\n- venue name\n- year\n- citation bucket\n- abstract slice\n- paper URL\n\nThis can answer:\n\n- Is this probably the right paper?\n- Is it recent?\n- Is it from a recognizable venue?\n- Is it worth opening in detail?\n\n### 2. Scholar identification\n\nUse when the user wants to know which scholar is the right person.\n\nDefault chain:\n\n`person_search`\n\nReturn:\n\n- name\n- org\n- interests\n- citation count\n- scholar URL\n\nThis can answer:\n\n- Is this the right scholar?\n- What interests best describe this person?\n- Which institution candidate is the best match?\n\n### 3. Institution normalization\n\nUse when the user provides an institution string or abbreviation.\n\nDefault chain:\n\n`organization_search`\n\nReturn:\n\n- org id\n- standard name\n- aliases (top 3)\n\nThis can answer:\n\n- Is this institution name recognized?\n- Which canonical organization should downstream workflows use?\n\n### 4. Venue normalization and type check\n\nUse when the user provides a conference or journal name.\n\nDefault chain:\n\n`venue_search`\n\nReturn:\n\n- venue id\n- standard bilingual name\n- aliases (top 3)\n- venue type\n- venue URL\n\nThis can answer:\n\n- Is this a conference or a journal?\n- What is the standard venue entity?\n\n### 5. Patent trend scan\n\nUse when the user wants a lightweight view of patents in a topic.\n\nDefault chain:\n\n`patent_search -> patent_info` when IDs need basic enrichment\n\nReturn:\n\n- patent title\n- first inventor\n- app year\n- pub year\n- patent number and country when `patent_info` is added\n- patent URL\n\nThis can answer:\n\n- Is the topic active recently?\n- Who appears first in the inventor field?\n- Is there recent patent activity worth deeper review?\n\n### 6. Free entity map\n\nUse when the user wants a quick map of a topic across papers, scholars, venues, institutions, and patents without paying for analysis-grade APIs.\n\nSuggested chain:\n\n- papers: `paper_search -> paper_info`\n- scholars: `person_search`\n- institutions: `organization_search`\n- venues: `venue_search`\n- patents: `patent_search -> patent_info`\n\nReturn a short cross-entity summary, not a deep report.\n\n## Free Skill Examples\n\n### 1. Paper triage\n\n```bash\ncurl -X GET \\\n  'https://datacenter.aminer.cn/gateway/open_platform/api/paper/search?page=1&size=5&title=Attention%20Is%20All%20You%20Need' \\\n  -H \"Authorization: ${AMINER_API_KEY}\" \\\n  -H 'X-Platform: openclaw'\n```\n\nThen enrich with `paper_info`:\n\n```bash\ncurl -X POST \\\n  'https://datacenter.aminer.cn/gateway/open_platform/api/paper/info' \\\n  -H 'Content-Type: application/json;charset=utf-8' \\\n  -H \"Authorization: ${AMINER_API_KEY}\" \\\n  -H 'X-Platform: openclaw' \\\n  -d '{\"ids\":[\"<PAPER_ID>\"]}'\n```\n\n### 2. Scholar identification\n\n```bash\ncurl -X POST \\\n  'https://datacenter.aminer.cn/gateway/open_platform/api/person/search' \\\n  -H 'Content-Type: application/json;charset=utf-8' \\\n  -H \"Authorization: ${AMINER_API_KEY}\" \\\n  -H 'X-Platform: openclaw' \\\n  -d '{\"name\":\"Yann LeCun\",\"size\":5}'\n```\n\n### 3. Institution normalization\n\n```bash\ncurl -X POST \\\n  'https://datacenter.aminer.cn/gateway/open_platform/api/organization/search' \\\n  -H 'Content-Type: application/json;charset=utf-8' \\\n  -H \"Authorization: ${AMINER_API_KEY}\" \\\n  -H 'X-Platform: openclaw' \\\n  -d '{\"orgs\":[\"MIT CSAIL\"]}'\n```\n\n### 4. Venue normalization and type check\n\n```bash\ncurl -X POST \\\n  'https://datacenter.aminer.cn/gateway/open_platform/api/venue/search' \\\n  -H 'Content-Type: application/json;charset=utf-8' \\\n  -H \"Authorization: ${AMINER_API_KEY}\" \\\n  -H 'X-Platform: openclaw' \\\n  -d '{\"name\":\"tkde\"}'\n```\n\n### 5. Patent trend scan\n\n```bash\ncurl -X POST \\\n  'https://datacenter.aminer.cn/gateway/open_platform/api/patent/search' \\\n  -H 'Content-Type: application/json;charset=utf-8' \\\n  -H \"Authorization: ${AMINER_API_KEY}\" \\\n  -H 'X-Platform: openclaw' \\\n  -d '{\"query\":\"quantum computing chip\",\"page\":0,\"size\":10}'\n```\n\n## Output Pattern\n\nPrefer this structure:\n\n```markdown\n## Free-tier result\n\n### What we can answer now\n- ...\n\n### Top candidates\n- ...\n\n### Suggested next step\n- Stay free: ...\n- Upgrade to paid API only if you need: ...\n```\n\n## Paid Upgrade Boundary\n\nRecommend upgrading only when the user needs one of these:\n\n- full abstract or full paper metadata\n- multi-condition or semantic paper search\n- citation relationships\n- full scholar profile, works, patents, or projects\n- institution scholars, papers, patents, or rich profiles\n- venue paper lists by year\n- full patent details such as IPC/CPC, assignee, description\n\nSuggested paid handoff:\n\n- deeper paper analysis: `paper_search_pro`, `paper_detail`, `paper_relation`\n- deeper scholar analysis: `person/detail`, `person/figure`, `person/paper/relation`\n- deeper org analysis: `organization/detail`, `organization/person/relation`, `organization/paper/relation`\n- deeper venue analysis: `venue/detail`, `venue/paper/relation`\n- deeper patent analysis: `patent/detail`\n\n## Product Positioning\n\nThis skill is intentionally positioned for:\n\n- first success\n- free discovery\n- candidate narrowing\n- entity normalization\n- upgrade qualification\n\nIt should not replace the paid skill. It should create demand for it.\n\n## Additional Reference\n\nFor endpoint parameters and fields, read [references/api-catalog.md](references/api-catalog.md).\n","topics":["Education"],"tags":{"latest":"1.1.1"},"stats":{"comments":0,"downloads":467,"installsAllTime":17,"installsCurrent":0,"stars":0,"versions":4},"createdAt":1774420878864,"updatedAt":1778492179546},"latestVersion":{"version":"1.1.1","createdAt":1774422362809,"changelog":"No file changes detected in this version.\n\n- No visible updates or changes from the prior version.\n- Version number update only; functionality and documentation remain unchanged.","license":"MIT-0"},"metadata":{"setup":[{"key":"AMINER_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"canxiangcc","userId":"s17831cxpje5h4nt59rdpynnf183jmh2","displayName":"CanXiangCC","image":"https://avatars.githubusercontent.com/u/57745889?v=4"},"moderation":null}