xinmi/docs/wiki/集成扩展/添加网络搜索引擎.md

title, tags, aliases, source

title	tags	aliases	source
添加网络搜索引擎	集成扩展 搜索 网络搜索 Provider	网络搜索 WebSearch 搜索引擎扩展	添加新的网络搜索引擎.md

添加新的网络搜索引擎

本文档说明如何在 WeKnora 中添加一个新的网络搜索引擎类型（如 Brave Search、Searx 等）。

架构概述

搜索引擎的 API 端点硬编码在代码中，不向用户暴露 BaseURL，从源头消除 SSRF 风险。

internal/types/web_search_provider.go       # 实体定义 + Provider 类型元数据
internal/infrastructure/web_search/          # Provider 实现（bing/google/duckduckgo/tavily）
internal/container/container.go              # DI 注册
internal/types/interfaces/web_search.go      # WebSearchProvider 接口

类似的扩展开发模式参见 集成向量数据库

步骤

以添加 Brave Search 为例：

1. 注册类型常量

在 internal/types/web_search_provider.go 中添加：

WebSearchProviderTypeBrave WebSearchProviderType = "brave"

2. 添加类型元数据

在 GetWebSearchProviderTypes() 中添加：

{
    ID: "brave", Name: "Brave Search", Free: false,
    RequiresAPIKey: true, Description: "Brave Search API",
    DocsURL: "https://brave.com/search/api/",
}

3. 创建 Provider 实现

新建 internal/infrastructure/web_search/brave.go：

• 构造函数签名：func(types.WebSearchProviderParameters) (interfaces.WebSearchProvider, error)
• API 端点硬编码为常量
• 实现 interfaces.WebSearchProvider 接口：Name() 和 Search()

4. 添加参数校验

在 isValidProviderType() 中添加新类型。

5. DI 注册

在 registerWebSearchProviders 中注册。

6. 验证

go build ./...
# 调用 API 验证
curl http://localhost:8080/api/v1/web-search-providers/types

需要额外参数的情况

如果新引擎需要 API Key 以外的参数：

• 方式一：使用 WebSearchProviderParameters.ExtraConfig 字段
• 方式二：在 WebSearchProviderParameters 中添加专用字段

文件变更清单

文件	操作
internal/types/web_search_provider.go	添加常量 + 类型元数据
internal/infrastructure/web_search/brave.go	新建 Provider 实现
internal/application/service/web_search_provider.go	isValidProviderType 加新类型
internal/container/container.go	registerWebSearchProviders 注册

相关主题

• 集成向量数据库 — 同类扩展开发模式（接口实现 + 注册 + DI）
• MCP功能使用说明 — MCP 也可集成搜索工具
• 常见问题 — SSRF 白名单配置

---

反向链接

• Home — Wiki 首页导航
• 集成向量数据库 — 同类扩展开发模式
• MCP功能使用说明 — MCP 搜索工具与网络搜索引擎互补
• 版本路线图 — 路线图中的社区组件扩展方向