Agent Search
为 Agent 提供高效的本地联网搜索能力。支持并发检索多个关键词,通过 cross-encoder rerank 重排返回最相关结果,大幅减少搜索轮次和上下文消耗。
这能帮你做什么?
场景一:快速调研陌生领域
"帮我调研一下 2024 年 RAG 技术的最新进展"
传统方式需要多轮搜索、逐个打开链接。agent-search 一次并发搜索多个关键词,自动重排序返回最相关结果。
Agenten stärken
Der eigene Befehl des Herausgebers. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code hat keinen Installationslink für einen lokalen Befehl. Kopieren Sie den Befehl unten und führen Sie ihn in einem Terminal aus.
claude mcp add agent-local-search -- npx -y agent-local-search@0.2.3In einem Terminal ausführen.
{ "mcpServers": { "agent-local-search": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
为 Agent 提供高效的本地联网搜索能力。支持并发检索多个关键词,通过 cross-encoder rerank 重排返回最相关结果,大幅减少搜索轮次和上下文消耗。
场景一:快速调研陌生领域
"帮我调研一下 2024 年 RAG 技术的最新进展"
传统方式需要多轮搜索、逐个打开链接。agent-search 一次并发搜索多个关键词,自动重排序返回最相关结果。
为 Agent 提供的本地联网搜索工具,支持 CLI 和 MCP 模式
"帮我看看最近关于 AI 编程有什么新闻?"
场景三:隐私敏感搜索
所有搜索请求通过本地 SearXNG 实例发出,数据不出本地。
urls_read 直接读 PDF,本地解析不上传docker run -d --name searxng -p 8080:8080 searxng/searxng:latest
RERANK_BASE_URL=http://localhost:11434RERANK_BASE_URL + RERANK_API_KEY注意:rerank 是唯一的搜索排序方式,
RERANK_BASE_URL或RERANK_API_KEY为必填(MCP 服务模式启动时强制校验)。
支持通过 .env 文件配置环境变量(推荐):
cp .env.example .env
# 编辑 .env 文件填入你的配置
docker run -d --name agent-search -p 3000:3000 \
-e SEARXNG_URL=http://host.docker.internal:8080 \
-e RERANK_BASE_URL=http://host.docker.internal:11434 \
-e MCP_HTTP_PORT=3000 \
ghcr.io/sebrinass/agent-search:latest
HTTP 模式默认有状态(initialize 返回 mcp-session-id,兼容 Hermes 等依赖会话的客户端);
如需多副本/负载均衡部署,设置 MCP_SESSION_MODE=stateless 切换为无状态(无会话 ID,无需粘性会话)。
npm install -g agent-local-search
agent-search
阅读 SKILL.md 获取 Agent 安装指南。
并发搜索 + rerank 重排 + 链接去重,一次请求最多搜索 3 个关键词。
必填参数:
searchedKeywords — 搜索关键词列表(最多 3 个并发)可选参数:
category — 搜索分类(general, news, science, it, images, videos, files, music)site — 限制搜索域名time_range — 时间范围过滤(day, month, year)lang — 搜索语言(如 en, zh, all)safeSearch — 安全搜索级别(0=关闭,1=中等,2=严格)读取网页(自动转 Markdown)或 PDF(本地解析),支持批量、分页、章节提取。
参数:
urls — URL 数组(支持批量读取)startChar / maxLength — 分页读取section — 提取指定章节paragraphRange — 段落范围readHeadings — 仅返回标题列表完整配置请参阅 docs/configuration.md。
安装后可通过 agent-search 命令使用 CLI 工具(命令名与 MCP 工具名对齐)。
# 基本搜索(配好 .env 后直接使用)
agent-search web-search -q "RAG 技术"
# 多关键词并发搜索(推荐)
agent-search web-search -q "RAG" "向量数据库" "Embedding"
# 限制域名和时间范围
agent-search web-search -q "React 19" --site github.com --time-range month
# 指定分类和语言
agent-search web-search -q "TypeScript" --category it --lang en
# JSON 格式输出
agent-search web-search -q "RAG 技术" --json
# 详细输出
agent-search -v web-search -q "RAG 技术"
# 未配置 .env 时,也可通过环境变量指定
SEARXNG_URL=http://localhost:8080 RERANK_BASE_URL=http://localhost:11434 agent-search web-search -q "RAG 技术"
选项:
# 读取单个 URL
agent-search urls-read https://example.com
# 读取多个 URL
agent-search urls-read https://example.com https://example.org
# 读取 PDF(自动本地解析)
agent-search urls-read https://example.com/paper.pdf
# 分页读取
agent-search urls-read https://example.com --start-char 1000 --max-length 5000
# 提取指定章节
agent-search urls-read https://example.com --section "Installation"
# 段落范围
agent-search urls-read https://example.com --paragraph-range 1-5
# 仅返回标题列表
agent-search urls-read https://example.com --headings
# 自定义超时
agent-search urls-read https://example.com --timeout 15000
选项:
# stdio 模式(默认)
agent-search serve
# HTTP 模式(默认有状态,推荐容器部署)
agent-search serve --transport http --port 3000
选项:
CLI 命令依赖以下环境变量:
设置 MCP_HTTP_PORT 启用 HTTP 模式:
MCP_HTTP_PORT=3000 agent-search
MCP_SESSION_MODE=stateless 切无状态(无会话 ID,多副本无需粘性会话)/mcp 端点同时服务 MCP 2026-07-28(modern)与 2025-11-25(legacy)客户端,自动识别可用端点:
MIT License
{ "mcpServers": { "agent-local-search": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Agent Local Search läuft lokal über stdio.
Zuletzt geprüft: 2026-11-16. 为 Agent 提供的本地联网搜索工具,支持 CLI 和 MCP 模式