Search arXiv physics, math, and computer science preprints using natural language queries. Powered by Valyu semantic search.
Use the skills CLI to install this skill with one command. Auto-detects all installed AI assistants.
Method 1 - skills CLI
npx skills i yorkeccak/scientific-skills/skills/arxiv-searchMethod 2 - openskills (supports sync & update)
npx openskills install yorkeccak/scientific-skillsAuto-detects Claude Code, Cursor, Codex CLI, Gemini CLI, and more. One install, works everywhere.
Installation Path
Download and extract to one of the following locations:
No setup needed. Let our cloud agents run this skill for you.
Select Provider
Select Model
Best for coding tasks
Environment setup included
Search the complete arXiv database of preprints across physics, mathematics, computer science, and quantitative biology using natural language queries powered by Valyu's semantic search API.
The scripts/search commands in this documentation are relative to this skill's installation directory.
Before running any command, locate the script using:
ARXIV_SCRIPT=$(find ~/.claude/plugins/cache -name "search" -path "*/arxiv-search/*/scripts/*" -type f 2>/dev/null | head -1)Then use the full path for all commands:
$ARXIV_SCRIPT "quantum entanglement" 15When you run a search and receive "setup_required": true, follow this flow:
Ask the user for their API key: "To search arXiv, I need your Valyu API key. Get one free ($10 credits) at https://platform.valyu.ai"
Once the user provides the key, run:
scripts/search setup <api-key>Retry the original search.
User: Search arXiv for transformer architecture papers
→ Response: {"success": false, "setup_required": true, ...}
→ Claude asks: "Please provide your Valyu API key from https://platform.valyu.ai"
→ User: "val_abc123..."
→ Claude runs: scripts/search setup val_abc123...
→ Response: {"success": true, "type": "setup", ...}
→ Claude retries: scripts/search "transformer architecture papers" 10
→ Success!
{
"success": true,
"type": "arxiv_search",
"query": "quantum entanglement",
"result_count": 10,
"results": [
{
"title": "Article Title",
"url": "https://arxiv.org/abs/...",
"content": "Full article text with figures..."
# Get article titles
scripts/search "query" 10 | jq -r '.results[].title'
# Get URLs
scripts/search "query" 10 | jq -r '.results[].url'
# Extract full content
scripts/search "query" 10 | jq -r '.results[].content'# Find recent machine learning papers
scripts/search "large language model architectures" 50# Search for quantum physics papers
scripts/search "topological quantum computation" 20# Find math papers
scripts/search "representation theory and Lie algebras" 15# Search for CS theory papers
scripts/search "distributed systems consensus algorithms" 25All commands return JSON with success field:
{
"success": false,
"error": "Error message"
}Exit codes:
0 - Success1 - Error (check JSON for details)https://api.valyu.ai/v1/searchscripts/
├── search # Bash wrapper
└── search.mjs # Node.js CLI
Direct API calls using Node.js built-in fetch(), zero external dependencies.
If you're building an AI project and want to integrate arXiv Search directly into your application, use the Valyu SDK:
from valyu import Valyu
client = Valyu(api_key="your-api-key")
response = client.search(
query="your search query here",
included_sources=["valyu/valyu-arxiv"],
max_results=20
)
for result in response["results"
import { Valyu } from "valyu-js";
const client = new Valyu("your-api-key");
const response = await client.search({
query: "your search query here",
includedSources: ["valyu/valyu-arxiv"],
maxResults: 20
});
response.results.
See the Valyu docs for full integration examples and SDK reference.