scopus-search

Execute Scopus boolean queries via elsapy and export normalized literature records as JSON.

1|1|Updated May 19, 2026
One-click install
npx skills add https://github.com/zhuyingqin/ARIS-WEB --skill scopus-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scopus-search
Source: https://github.com/zhuyingqin/ARIS-WEB/tree/main/crates/runtime/assets/skills/scopus-search
Command: npx skills add https://github.com/zhuyingqin/ARIS-WEB --skill scopus-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires elsapy, pandas, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Helps you reliably find peer-reviewed literature on Scopus and turn a precise boolean query into a structured, exportable dataset (including abstracts, authors, affiliations, keywords, and DOI metadata).

Core Features & Use Cases

  • Scopus boolean query execution: Run stable TITLE-ABS-KEY queries with optional filters (year, document type, author, affiliation) and capture total-hit and returned-entry counts.
  • Abstract-first export: Uses Scopus view COMPLETE by default to pull abstracts and author keywords in one pass, with a fallback AbsDoc path when needed.
  • Structured JSON or readable output: Export normalized fields suitable for literature surveys, related-work analysis, and reproducible review pipelines.
  • Use Case: You need a related-work dataset for a survey topic and want an exact, repeatable Scopus query plus citation counts for later synthesis.

Quick Start

Run the skill by setting SCOPUS_API_KEY and executing the helper with a reproducible Scopus query string to export all results as JSON.

Frequently Asked Questions about scopus-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I export Scopus search results with abstracts to JSON?

You can export Scopus search results with abstracts by executing a boolean query through the elsapy client, which retrieves normalized metadata and outputs it as a structured JSON file. The skill defaults to the COMPLETE view to pull abstracts in one pass.

Do I need a SCOPUS_API_KEY to run elsapy literature searches?

Yes, you must set the SCOPUS_API_KEY environment variable to authenticate with the Scopus API before executing any literature search. This key authorizes the elsapy client to retrieve citation metadata and abstracts for your queries.

Can I use Scopus boolean queries with filters like year and document type for reproducible literature surveys?

Yes, you can run stable TITLE-ABS-KEY boolean queries with optional filters for year, document type, author, and affiliation. The execution captures total-hit and returned-entry counts to ensure your literature survey exports are fully reproducible.

What is the best way to collect citation metadata and author affiliations for a related-work dataset?

The best way to build a related-work dataset is running a precise Scopus boolean query that exports normalized fields including authors, affiliations, keywords, and DOI metadata. It preserves citation counts for later review synthesis.

Why does my Scopus search export fail when retrieving abstracts for certain DOIs?

Abstract retrieval can fail if the default COMPLETE view is unsupported for specific entries, but the tool applies an AbsDoc fallback path to retrieve them. If failures persist, verify your SCOPUS_API_KEY covers the required metadata access permissions.