/install arxiv-scholar-search
Scholar Search Workflow
This skill only uses arXiv as the data source. The workflow is fixed:
- Read user input and parse the search intent.
- Call the arXiv API (via
arxiv_search). - Evaluate result quality and decide whether another search round is needed.
- Output results using the required template.
0) File Layout (Overview)
| File Path | Purpose | When to Check |
|---|---|---|
SKILL.md |
Main entry: task parsing, query syntax, calling conventions, quality control | Check first at the beginning of every task |
1) Parse User Search Requirements
Extract the following constraints first:
- Topic keywords (Chinese or English).
- Time preference (for example: "latest", "this year", "last three years").
- Number of results (for example: 5, 10, 20).
- Output goal (paper discovery, comparison, or brief survey).
- Output language (Chinese or English).
Keyword strategy:
- Use a broad query in round one (topic terms only).
- Add constraint terms in round two (method terms, task terms, category terms).
- If results are too few, switch to synonyms or broader terms.
2) arXiv API Guide (Built-in)
2.1 API Endpoint
- Base endpoint:
https://export.arxiv.org/api/query - Request methods: GET (common), POST (optional when parameters are very long)
2.2 Core Parameters
search_query: query expressionid_list: comma-separated list of arXiv IDsstart: pagination offset (0-based)max_results: number of returned entriessortBy:relevance/lastUpdatedDate/submittedDatesortOrder:ascending/descending
2.3 search_query Syntax
Common field prefixes:
ti(title)au(author)abs(abstract)cat(category)all(all fields)
Boolean operators:
ANDORANDNOT
Time syntax (submittedDate):
- Range:
submittedDate:[200701*+TO+200712*] - Specific day:
submittedDate:20101225
2.4 Direct URL Examples
- Topic query:
https://export.arxiv.org/api/query?search_query=all:electron - Combined query:
https://export.arxiv.org/api/query?search_query=au:del_maestro+AND+ti:checkerboard - Paginated query:
https://export.arxiv.org/api/query?search_query=all:electron&start=0&max_results=10 - Sorted query:
https://export.arxiv.org/api/query?search_query=ti:%22electron+thermal+conductivity%22&sortBy=lastUpdatedDate&sortOrder=descending
2.5 Rate Limits and Stability (Must Follow)
- Keep request frequency at no more than one request every 3 seconds.
- Use only one active connection at a time.
- Avoid high-frequency repeated queries; reuse existing results whenever possible.
3) Calling Conventions (Must Match Actual Use)
Standard call example:
curl -s "https://export.arxiv.org/api/query?search_query=all:multimodal+AND+cat:cs.CL&start=0&max_results=10&sortBy=submittedDate&sortOrder=descending"
Parameter notes:
search_query: arXiv query expression (supports field prefixes and boolean operators).start: pagination offset (0-based).max_results: number of returned entries; recommend5-20.sortBy: recommendsubmittedDateorlastUpdatedDate.sortOrder: recommenddescending.
4) Decide Whether to Continue Searching
Run one more search round if any condition below is met:
- Too few papers are returned (for example,
\x3C 3). - Results are clearly off-topic.
- Key fields are frequently missing (title, link, abstract).
Stop searching when:
- Result count reaches the target or an acceptable range.
- Topic relevance is high.
- Additional search rounds provide low value.
5) Output Requirements
Each paper must use the following structure:
-----------
# {Index}. **{Paper Title}**
**Paper Info**: **Venue/Source**: {journal, conference, or source} | **Publication Date**: {yyyy-mm-dd or unknown} | **Source**: [{source name}]({entry link or paper link}) | **PDF**: [PDF link]({pdf link})
### Research Content
{1-2 objective sentences based on the paper content}
### Main Contributions
- {Contribution 1}
- {Contribution 2}
- {Contribution 3}
Must follow:
- Add a standalone line
-----------before every paper title. - Keep the title as a standalone level-1 header line.
- Keep "Paper Info" in a single line, separated by
|. - Keep the
PDFfield:- If a PDF exists: provide a direct link.
- If no PDF exists: remove the
PDFfield.
- Content must be based only on source metadata, abstract, or TLDR. No speculation.
- Do not add conclusions not explicitly supported by the source.
- All links must come from tool output. Do not fabricate or guess links.
- Do not fabricate venue, date, or citation count.
- Write "Research Content" and "Main Contributions" only from returned fields.
6) Failure Handling
- API failure: state the reason and the strategies already attempted.
- No results: provide actionable keyword rewrite suggestions.
- Missing fields: explicitly mark as "unknown/missing"; do not fill with inferred data.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install arxiv-scholar-search - After installation, invoke the skill by name or use
/arxiv-scholar-search - Provide required inputs per the skill's parameter spec and get structured output
What is ArXiv Scholar Search?
Use the arXiv API for academic paper discovery, relevance screening, and structured output. Suitable for topic-based search, latest-paper discovery, fixed-te... It is an AI Agent Skill for Claude Code / OpenClaw, with 947 downloads so far.
How do I install ArXiv Scholar Search?
Run "/install arxiv-scholar-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is ArXiv Scholar Search free?
Yes, ArXiv Scholar Search is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does ArXiv Scholar Search support?
ArXiv Scholar Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created ArXiv Scholar Search?
It is built and maintained by lyq (@xxxxxxxxxxxxxxxxxxx20gex); the current version is v1.0.0.