功能描述

Search and download research papers from arXiv.org - Research version for OpenClaw agents

使用说明 (SKILL.md)

ArXiv Skill

Name: Arxiv Osiris
Author: nantes

Search and download scientific papers from arXiv.org - the largest free distribution of scientific preprints.

What it does

Search papers by keywords, titles, abstracts
Download PDFs directly
Filter by category (physics, cs, math, etc.)
Get metadata including authors, dates, categories

Installation

# Install Python dependency
pip install arxiv

Usage

Search for papers

# Basic search
.\arxiv.ps1 -Action search -Query "quantum computing"

# With max results
.\arxiv.ps1 -Action search -Query "machine learning" -MaxResults 10

# With category filter (physics, cs, math, q-bio, etc.)
.\arxiv.ps1 -Action search -Query "neural networks" -Categories "cs,stat"

Download a paper

# By arXiv ID
.\arxiv.ps1 -Action download -ArxivId "2310.12345"

Python API

from arxiv import search, download

# Search
results = search("simulation hypothesis", max_results=5)
for paper in results:
    print(f"{paper.title} - {paper.pdf_url}")

# Download
paper.download("/path/to/save")

Examples

Search for consciousness papers: arxiv.ps1 -search "consciousness" -max 5
Find physics papers: arxiv.ps1 -search "quantum" -cats "physics" -max 10
Download paper: arxiv.ps1 -download "1706.03762" (Attention is All You Need)

Notes

arXiv is free and open
Papers are preprints - may not be peer-reviewed
Great for staying current with research

安全使用建议

This skill appears to do what it says: search arXiv and download PDFs using the Python arxiv package. Before installing or running it: 1) Be aware the SKILL.md examples reference a PowerShell script (arxiv.ps1) while the distributed file is a Python script (arxiv_search.py) — use the Python script or update wrappers accordingly. 2) The arXiv ID validation logic in the code is slightly odd and may reject some valid IDs; if you rely on automated downloads, review/patch is_valid_arxiv_id. 3) Run pip install arxiv from a controlled environment (virtualenv) and audit the pip package source if you have strict supply-chain requirements. 4) Because the skill will download PDFs into ~/Downloads/arxiv, consider running it in a sandbox or adjusting the download directory if you prefer a different location. If you need higher assurance, request provenance (homepage/source repo) from the publisher or inspect the code locally before use.

功能分析

Type: OpenClaw Skill Name: arxiv-osiris Version: 1.0.4 The skill bundle is designed to search and download research papers from arXiv.org using the `arxiv` Python library. The `SKILL.md` provides clear instructions and dependency declarations without any prompt injection attempts. The `arxiv_search.py` script includes input validation for arXiv IDs to prevent path traversal, and downloads files to a standard user download directory. While there's a minor bug in the `is_valid_arxiv_id` function that might reject some valid arXiv IDs, this makes the validation more restrictive and does not introduce a security vulnerability. There is no evidence of malicious intent such as data exfiltration, unauthorized execution, or persistence mechanisms.

能力评估

✓ Purpose & Capability

Name/description claim: search and download from arXiv. The code uses the arxiv Python client to search and download PDFs and exposes the expected functionality. Required binary (python) and the SKILL.md's pip dependency (arxiv) align with the stated purpose.

ℹ Instruction Scope

SKILL.md describes searching, filtering, and downloading via a script and Python API only; it does not instruct reading unrelated files or exfiltrating data. However, documentation examples reference a PowerShell script named arxiv.ps1 and different CLI flags than the provided Python script (arxiv_search.py). That mismatch is a documentation/integration inconsistency and could confuse users or lead to running the wrong wrapper.

✓ Install Mechanism

No install spec in registry (instruction-only); SKILL.md recommends pip install arxiv which is appropriate. There are no downloads from arbitrary URLs or extract steps. This is low-risk for installation.

✓ Credentials

The skill requires no environment variables, no credentials, and no config paths. That is proportional to its function (public arXiv access). The code writes downloads into the user's Downloads/arxiv directory (uses HOME), which is expected for a download tool.

✓ Persistence & Privilege

The skill is not forced always-on (always:false) and does not request elevated or persistent privileges. It does not modify other skills or global agent settings.

版本历史

v1.0.4

Security fix: Added arXiv ID validation to prevent path traversal attacks

v1.0.3

Removed reference to Protocol SIM-PI-01

v1.0.2

Minor fix: Improved error handling and added version check

v1.0.1

- Updated internal logic in arxiv_search.py. - No user-facing changes or documentation updates in this version.

v1.0.0

Initial release of arxiv-osiris - Search and download research papers from arXiv.org by keyword, title, or abstract. - Filter search results by category (e.g., physics, cs, math). - Download PDFs of papers directly by arXiv ID. - Retrieve detailed metadata including authors, dates, and categories. - Supports command-line (PowerShell) and Python API usage. - Requires Python and the `arxiv` package.

元数据

Slug arxiv-osiris

版本 1.0.4

许可证 —

累计安装 5

当前安装数 5

历史版本数 5

常见问题

Arxiv Osiris 是什么？

Search and download research papers from arXiv.org - Research version for OpenClaw agents. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 1280 次。

如何安装 Arxiv Osiris？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install arxiv-osiris」即可一键安装，无需额外配置。

Arxiv Osiris 是免费的吗？

是的，Arxiv Osiris 完全免费（开源免费），可自由下载、安装和使用。

Arxiv Osiris 支持哪些平台？

Arxiv Osiris 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Arxiv Osiris？

由 Ivan Cetta（@nantes）开发并维护，当前版本 v1.0.4。

Arxiv Osiris