literature-search-arxiv

1# arXiv Search and Retrieval
2 
3## Prerequisites
4 
51.  **`uv`**: Read the `uv` skill and follow its Setup instructions to ensure
6    `uv` is installed and on PATH.
72.  **User Notification**: If .licenses/literature_search_arxiv_LICENSE.txt does
8    not already exist in the workspace root directory then (1) prominently
9    notify the user to check the terms at
10    https://info.arxiv.org/help/api/index.html and to always check the license
11    of the papers retrieved by the skill for any restrictions, then (2) create
12    the file recording the notification text and timestamp.
13 
14## Core Rules
15 
16-   **Terms of Use**: You MUST respect arXiv's Terms of Use.
17    -   Maximum 1 request every 3 seconds.
18    -   The provided utility scripts handle rate limiting automatically. Always
19        use these scripts rather than writing your own curl/python requests.
20-   If this skill is used, ensure this is mentioned in the output AND list the
21    URLs of all papers that were used in producing the output.
22 
23## Utility Scripts
24 
25**1. Search and Extract Metadata**
26 
27Search arXiv and return a clean JSON array of matching papers.
28 
29```bash
30uv run scripts/search_arxiv.py --query "au:einstein AND ti:relativity" \
31  --max_results 5 2>/dev/null > /tmp/arxiv_search_results.json
32```
33 
34> **Important**: The tool outputs a large JSON result to stdout. Requesting 100+
35> results will produce a massive JSON that might exceed your context length.
36> Limit `--max_results` (e.g., 5-10) or paginate carefully using `--start`.
37…