学术科研
需要按自然语言检索 arXiv…
当你想用自然语言查询 arXiv 预印本并获取全文、图片链接和相关结果时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
需要按自然语言检索 arXiv 物理/数特定
解决思路
- 直接向 scripts/search 传入自然语言查询,无需构造复杂搜索参数。
- 确认运行环境为 Node.js 18+,脚本使用内置 fetch,零外部依赖。
- 从 https://platform.valyu.ai 获取 Valyu API key($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。
- 若搜索返回 "setup_required": true,向用户索要 Valyu API key,并提示可在 https://platform.valyu.ai 免费获取($10 credits)。
- 用户提供 key 后运行:scripts/search setup <api-key>(或定位脚本后用 $ARXIV_SCRIPT setup <api-key>)。
- 设置成功后重试原始搜索。
- 执行搜索:scripts/search "query" <结果数>,例如 scripts/search "transformer architecture papers" 10。
- 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。
- 读取输出 JSON:包含 success、type、query、result_count、results、cost;results 每项含 title、url、content、source、relevance_score、images。
- 从结果中获取完整文章内容,而不仅是摘要。
- 从结果中获取图片链接(figures/images)。
- 用 jq 获取文章标题:scripts/search "query" 10 | jq -r '.results[].title'。
- 用 jq 获取 URL:scripts/search "query" 10 | jq -r '.results[].url'。
- 用 jq 提取全文内容:scripts/search "query" 10 | jq -r '.results[].content'。
- 错误处理:所有命令返回含 success 字段的 JSON;检查 success 和退出码,0 为成功,1 为错误;错误详情看 JSON。
- 直接调用 API 时使用 Base URL https://api.valyu.ai/v1、Endpoint /search、认证 header X-API-Key。
- 需要直接集成时使用架构中的 scripts/search(Bash wrapper)和 scripts/search.mjs(Node.js CLI),通过 Node.js 内置 fetch 调用。
- 在 Python 项目中集成 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);遍历 response["results"] 打印 title、url、content[:500]。
- 在 TypeScript 项目中集成 Valyu SDK: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 打印 title、url、content.substring(0, 500)。
- 需要完整集成示例和 SDK 参考时查阅 https://docs.valyu.ai。
- 利用语义搜索理解查询含义,而不仅是关键词匹配。
- 结果覆盖 arXiv 全部预印本文库,跨物理、数学、计算机科学和定量生物等学科。
适用边界 · 注意事项
- 没有 Valyu API key、无法访问 https://platform.valyu.ai 或不愿注册/付费时。
- 需要正式发表版本、同行评审版本或 DOI 元数据检索时。
- 需要 arXiv 官方 API 的精确字段查询、批量下载或完全离线检索时。