aminer-search

name	aminer-search
description	Search for academic papers, scholars, and patents using the AMiner API.

AMiner Search Skill

This skill allows you to search for academic papers, scholars, and patents using the AMiner Open Platform API directly from the command line, leveraging the existing codebase.

Requirements

1. Python Environment: Ensure Python 3.x is installed.
2. Dependencies:
   • requests (Install via pip install requests or pip install -r requirements.txt)
3. Environment Variables:
   • AMINER_TOKEN: Your AMiner API token must be set in your environment.

Usage

This skill provides a Python script scripts/search_tool.py that can be executed to perform searches.

1. Search for Papers

To search for papers by title.

Command:

python .agent/skills/aminer-search/scripts/search_tool.py paper --title "Your Paper Title" --size 5

Parameters:

• --title: The title of the paper (Required).
• --page: Page number (Default: 0).
• --size: Number of results (Default: 10).

2. Search for Scholars

To search for a scholar by name and optional organization.

Command:

python .agent/skills/aminer-search/scripts/search_tool.py scholar --name "Scholar Name" --org "Univ Name"

Parameters:

• --name: Name of the scholar (Required).
• --org: Organization name (Optional).
• --offset: Pagination offset (Default: 0).
• --size: Number of results (Default: 10).

3. Search for Patents

To search for patents using keywords.

Command:

python .agent/skills/aminer-search/scripts/search_tool.py patent --query "Patent Keywords"

Parameters:

• --query: Search query (Required).
• --page: Page number (Default: 0).
• --size: Number of results (Default: 20).

Example Workflow

1. Setup: Check if the token is set.

   echo $env:AMINER_TOKEN
   

2. Search: Run the search command.

   python .agent/skills/aminer-search/scripts/search_tool.py paper --title "Attention is all you need"
   

3. Process: The output is valid JSON, which can be parsed or saved to a file.

   python .agent/skills/aminer-search/scripts/search_tool.py paper --title "Mamba" > mamba_papers.json