/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.
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install arxiv-scholar-search - 安装完成后,直接呼叫该 Skill 的名称或使用
/arxiv-scholar-search触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 947 次。
如何安装 ArXiv Scholar Search?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install arxiv-scholar-search」即可一键安装,无需额外配置。
ArXiv Scholar Search 是免费的吗?
是的,ArXiv Scholar Search 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
ArXiv Scholar Search 支持哪些平台?
ArXiv Scholar Search 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 ArXiv Scholar Search?
由 lyq(@xxxxxxxxxxxxxxxxxxx20gex)开发并维护,当前版本 v1.0.0。