SuperAPI AI 工具集

exa-search

办公与效率

查看项目

更新于 10-15 23:43

技能介绍

用途:为科研与技术类研究任务提供由 Exa 支持的网络检索和 URL 内容提取能力,适合科学、技术与概念性查询。

主要能力:一是网页搜索(Web Search),支持通过 --category publication 倾向学术来源,并结合 --include-domains 学术域名白名单(如 arxiv.org、nature.com、pubmed.ncbi.nlm.nih.gov)缩小来源范围;二是网页提取(Web Extract),用于获取指定 URL 的网页、文章或 PDF 文本,单次调用可处理多个 URL,适合批量提取与学术 PDF。提取接口每次 POST https://api.exa.ai/contents 接受 1–100 个 URL,超出会被拒绝;可用 --max-age-hours 控制新鲜度:0 为请求最新内容,-1 仅用缓存,正值上限 720 小时。

使用方式:技能使用 exa-py Python SDK,脚本通过 PEP 723 内联元数据声明依赖,可直接运行 uv run "$SKILL_PATH/scripts/exa_search.py" --help;也可持久安装 uv pip install "exa-py>=2.23.0,<3"。所有命令从 EXA_API_KEY 环境变量读取密钥,密钥在 dashboard.exa.ai/api-keys 获取。如项目根目录存在含 EXA_API_KEY 的 .env,可加载:dotenv -f .env run -- uv run "$SKILL_PATH/scripts/exa_search.py" "your query";若没有 dotenv 可安装 uv pip install 'python-dotenv[cli]',否则使用 export EXA_API_KEY="your-key"。--help 不需要密钥,认证仅在真实查询时检查。

适用场景与限制:适合查找、研究话题、获取当前信息,或读取指定网页与学术 PDF。搜索参数使用 snake_case,序列化后为 camelCase;当前学术类别为 publication,research paper 为兼容别名;这些接口未记录 offset 或 cursor 分页。搜索内容标志需显式指定:无标志仅返回元数据,--highlights 不会隐式抓取正文。published_date 是估算的发布元数据,不是检索时间;SDK 会丢弃单 URL 错误详情,报告失败时不应臆测原因。脚本会设置 x-exa-integration 请求头为 k-dense-ai--scientific-agent-skills,改编时不应移除或重命名。其他细节暂未提供。