arxiv-search

用途

arXiv Search 用于通过自然语言查询检索 arXiv 上完整的预印本数据库，覆盖物理学、数学、计算机科学和定量生物学等学科。其语义搜索能力由 Valyu 的语义搜索 API 提供，适合在同行评审发表前查找研究、开展跨学科研究、跟踪 AI 与理论物理等领域的快速进展、进行新想法的先前工作检索以及追踪新兴研究趋势。

主要能力

无需解析 API 参数：直接传入自然语言查询，不需要构造复杂的搜索参数。
语义搜索：理解查询的含义，而不仅仅是关键词匹配。
全文访问：返回完整文章内容，而不仅是摘要。
图片链接：包含论文中的图和图片。
全面覆盖：可访问 arXiv 跨多个学科的全部预印本档案。
返回结果带相关性评分，并报告本次查询的 cost 字段。

使用方式

环境要求：Node.js 18+（使用内置 fetch）、来自 https://platform.valyu.ai 的 Valyu API 密钥（提供 $10 免费额度）。

脚本路径解析（文档强调的关键点）：文档中的 scripts/search 命令是相对于该技能安装目录的。运行任何命令前，先定位脚本：

ARXIV_SCRIPT=$(find ~/.claude/plugins/cache -name "search" -path "*/arxiv-search/*/scripts/*" -type f 2>/dev/null | head -1)

然后用完整路径执行命令：

$ARXIV_SCRIPT "quantum entanglement" 15

API 密钥配置流程：当运行搜索收到 "setup_required": true 时，向用户索要 API 密钥（提示可从 https://platform.valyu.ai 获取免费的 $10 额度），拿到后运行 scripts/search setup <api-key>，再重试原来的搜索。

示例流程：

用户：Search arXiv for transformer architecture papers
响应：{"success": false, "setup_required": true, ...}
询问："Please provide your Valyu API key from https://platform.valyu.ai"
用户："val_abc123..."
运行：scripts/search setup val_abc123...
响应：{"success": true, "type": "setup", ...}
重试：scripts/search "transformer architecture papers" 10
成功

输出格式

{
  "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...",
      "source": "arxiv",
      "relevance_score": 0.95,
      "images": ["https://example.com/figure1.jpg"]
    }
  ],
  "cost": 0.025
}

使用 jq 处理结果：

# 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'

常见使用场景与命令

AI/ML 研究：scripts/search "large language model architectures" 50
物理研究：scripts/search "topological quantum computation" 20
数学：scripts/search "representation theory and Lie algebras" 15
计算机科学：scripts/search "distributed systems consensus algorithms" 25

错误处理

所有命令返回带 success 字段的 JSON：

{
  "success": false,
  "error": "Error message"
}

退出码：0 表示成功；1 表示错误（查看 JSON 获取详情）。

API 端点与架构

基础 URL：https://api.valyu.ai/v1
端点：/search
认证：X-API-Key 请求头
架构：scripts/search（Bash wrapper）、scripts/search.mjs（Node.js CLI）；直接使用 Node.js 内置 fetch() 发起 API 调用，零外部依赖。

集成到自有项目

如正在构建 AI 项目并希望将 arXiv Search 直接集成到应用中，可使用 Valyu SDK。

Python：

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"]:
    print(f"Title: {result['title']}")
    print(f"URL: {result['url']}")
    print(f"Content: {result['content'][:500]}...")

TypeScript：

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.forEach((result) => {
  console.log(`Title: ${result.title}`);
  console.log(`URL: ${result.url}`);
  console.log(`Content: ${result.content.substring(0, 500)}...`);
});

完整集成示例与 SDK 参考请见 Valyu 文档。

限制

需要 Node.js 18+（依赖内置 fetch）。
必须持有 Valyu API 密钥；未配置时会返回 setup_required。
查询能力由 Valyu 语义搜索 API 提供，结果与费用（$10 免费额度及 cost 字段）受该平台约束。
文档未提供离线使用、免费无限制使用或其他平台的官方支持说明。