junnjiee/pi-exa
GitHub: junnjiee/pi-exa
为 Pi Agent 提供基于 Exa 的免费网络搜索、内容抓取和深度研究能力的扩展插件。
Stars: 25 | Forks: 5
# Pi Exa
为您的 Pi Agent 提供网络搜索、抓取和深度研究功能。由 [Exa](https://exa.ai) 提供支持。
网络搜索和抓取**无需 API key**。开箱即用,安装扩展后,您的 Agent 就可以开始使用 Exa 搜索和抓取功能。
https://github.com/user-attachments/assets/8bc51126-f212-4ad7-813b-705197a972e8
## 为什么为您的 Agent 选择 Exa
- 免费 - 通过 [Exa MCP server](https://github.com/exa-labs/exa-mcp-server),每月提供 1000 次网络搜索和抓取请求
- 语义搜索 - 理解意图,而不仅仅是关键词搜索
- 对 LLM 友好的结果 - Exa 返回干净的摘要,而不是倾倒整个网站的内容,从而耗尽您的上下文窗口(通过 [Exa Highlights](https://exa.ai/blog/highlights-for-agents))
- 获取您想要的内容 - 您的 Agent 能够理解 Exa 的搜索选项和过滤器,从而为您提供精确缩小的结果
## 安装
```
pi install npm:pi-exa
```
**可选**:用于深度搜索工具的 Exa API key。要注册您的 key:
```
pi /exa-login
```
## 功能
### MCP
- 使用网络搜索和内容抓取**无需 API key**
- 懒加载的 Exa MCP server,仅在首次调用工具时连接
- 缓存 MCP 工具 schema,Pi 在启动时注册 MCP 工具,而无需连接到 MCP server
- 使用 `/exa-mcp-use-api-key on|off` 切换付费 Exa MCP 的使用
### 高级网络搜索
- 让您的 Agent 使用所有的 Exa 搜索过滤器
- 默认禁用以节省上下文(约 1200 tokens)
- 使用 `/exa-advanced-search on|off` 启用或禁用
### 深度搜索
- 通过 Exa API 让您的 Agent 使用深度搜索,支持 `deep-lite`、`deep` 和 `deep-reasoning` 模式
- 需要通过 `/exa-login` 或 `EXA_API_KEY` 环境变量提供 Exa API key
- 使用 `/exa-deep-search on|off` 启用或禁用
## 文档
### 命令
| command | description |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| `/exa-enable` | 启用 pi-exa 扩展并恢复其可用工具 |
| `/exa-disable` | 禁用 pi-exa 扩展并向 Agent 隐藏所有 Exa 工具 |
| `/exa-login` | 将您的 Exa API key 写入 `.pi/agents/auth.json` |
| `/exa-logout` | 从 `.pi/agents/auth.json` 中移除您的 API key |
| `/exa-status` | 显示 Pi Exa 扩展状态 |
| `/exa-advanced-search on\|off` | 切换高级 Exa 网络搜索工具 |
| `/exa-deep-search on\|off` | 切换 Exa 深度搜索工具。需要 Exa API key |
| `/exa-mcp-use-api-key on\|off` | 切换是否为 Exa MCP server 使用您的 API key。这将会产生费用。仅在您达到免费请求的速率限制时使用 |
### 工具
在 pi-exa 启用时可用:
| name | interface | description |
| ---------------- | ----------------------------------------------------- | --------------------------------- |
| `web_search_exa` | [Exa MCP](https://github.com/exa-labs/exa-mcp-server) | 常规网络搜索 |
| `web_fetch_exa` | [Exa MCP](https://github.com/exa-labs/exa-mcp-server) | 获取特定网页的内容 |
在 pi-exa 启用时切换启用/禁用。设置偏好会在会话间保持:
| name | interface | description |
| ------------------------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `web_search_advanced_exa` | [Exa MCP](https://github.com/exa-labs/exa-mcp-server) | `web_search_exa`,但提供所有过滤器参数(加载到上下文中约需 1200 tokens) |
| `deep_search_exa` | [Exa API](https://exa.ai/docs/reference/search-api-guide) | 用于多步骤研究或需要从多个来源进行综合以得出答案的情况。当没有可用的 Exa API key 时自动禁用 |
## Bug 和建议
欢迎提交 issue!
标签:AI智能体, MCP, SOC Prime, URL抓取, Web搜索, 开发工具, 数据抓取, 暗色界面, 自动化攻击