exa-search
由 Exa 驱动的网页工具包，针对科学与技术内容进行了优化。需要用户进行网页搜索或抓取/提取 URL 内容时使用此技能。包含：网页搜索（语义检索、研究、获取最新信息——支持可选的研究论文类别与学术领域过滤）以及 URL 提取（批量获取网页、文章、学术 PDF）。当用户希望通过 category=research paper 进行高质量搜索或学术筛选时，可在与网页相关的任务中使用此技能。触发条件：当用户请求搜索、查找、抓取页面或提取文章时。
Exa 搜索工具 - 面向科研与技术的智能检索方案
技能概述
exa-search 是基于 Exa 引擎的网络检索工具包，专为科学技术内容优化，提供语义搜索和 URL 内容提取能力，帮助研究者快速发现高质量的学术资源。
适用场景
1. 学术研究与论文检索
当您需要查找同行评审期刊文章、会议论文或预印本（如 arXiv、bioRxiv）时，exa-search 可以通过研究论文类别过滤和学术域名限制，优先返回可信赖的学术来源，而非博客或新闻报道。
2. 技术文档与资料调研
在探索新技术框架、查找技术文档或收集案例资料时，该工具的语义检索能力能够理解概念性查询，而非依赖精确的关键词匹配，让您更快定位到相关技术内容。
3. 批量网页与 PDF 内容提取
当您已经拥有一组 URL 列表（如参考文献链接、资源清单）并需要获取其完整内容时，exa-search 支持批量提取网页文章和学术 PDF，无需逐一手动下载和复制。
核心功能
1. 语义化网络搜索
超越传统关键词匹配，Exa 结合高质量关键词和语义检索，能够理解科研和技术查询的意图。通过 --category "research paper" 选项可偏向学术来源，配合 --include-domains 指定权威域名（如 nature.com、arxiv.org）进一步过滤结果范围。
2. 批量 URL 内容提取
基于 exa-py Python SDK，支持一次性提取多个 URL 的内容，包括普通网页和学术 PDF。适合处理参考文献列表、资源合集等场景，比逐个访问更高效。
3. 学术来源优先策略
内置学术来源优先级：同行评审文章 > 预印本 > 机构与政府来源（NIH、WHO、NIST） > 商业网站。该策略确保科研类查询返回权威性更高的资源，并在引用时建议包含作者和年份（如 [Smith et al., 2025]）。
常见问题
什么是 Exa 搜索工具，它与 Google 搜索有什么区别？
Exa 是一个专注于语义检索的搜索引擎索引服务，相比传统搜索引擎，它在理解科学和技术概念性查询方面表现更优，并提供专门的学术论文过滤能力。exa-search 技能封装了 Exa 的 Python 接口，让用户可以通过命令行快速进行网络检索和内容提取。
如何获取和使用 EXA_API_KEY？
您需要在 dashboard.exa.ai/api-keys 注册并获取 API 密钥。推荐方式是在项目根目录创建 .env 文件并添加 EXA_API_KEY=your-key，然后使用 dotenv -f .env run -- 加载环境变量后运行脚本。也可以直接 export EXA_API_KEY="your-key" 设置为会话环境变量。
exa-py SDK 如何安装？
由于脚本使用 PEP 723 内联依赖声明，可以直接通过 uv run --with exa-py python 运行，无需预先安装。如果希望持久化安装，可执行 uv pip install "exa-py>=1.14.0"。所有脚本均会设置 x-exa-integration 请求头用于使用统计。