[Feature]关于网页搜索的自定义引擎问题

[wjiajian]

Description / 描述

目前可用的内置网页搜索工具为图中的四种。

---

---

我希望能够使用别的工具（例如firecrawl），我想知道目前内置的网页搜索工具处在哪一层，如果我要自己添加用于自用，是作为插件添加更好还是作为 MCP 添加更好。

Use Case / 使用场景

添加一个自定义网页搜索配置功能

Willing to Submit PR? / 是否愿意提交PR？

• Yes, I am willing to submit a PR. / 是的，我愿意提交 PR。

Code of Conduct

• I have read and agree to abide by the project's Code of Conduct. /

[dosubot]

Hi @wjiajian! I'm Dosu and I’m helping the AstrBot team.

@wjiajian 内置网页搜索工具的代码位于 astrbot/core/tools/web_search_tools.py，属于 内置 Function Tool 层，通过 @builtin_tool 装饰器注册，并在 registry.py 的 _BUILTIN_TOOL_MODULES 中自动加载 [1]。目前支持 Tavily、BoCha、Brave、百度 AI 四种搜索引擎 [2]。

如果你想添加 Firecrawl 用于自用，有两条推荐路径：

1. MCP 方式（最快，零代码）

直接在 data/mcp_server.json 中配置 Firecrawl MCP 服务即可，无需写任何代码 [3]：

{
    "mcpServers": {
        "firecrawl": {
            "command": "npx",
            "args": ["-y", "@mendable/firecrawl-mcp-server"],
            "env": { "FIRECRAWL_API_KEY": "fc-xxx" },
            "active": true
        }
    }
}

也可以通过 Dashboard Web UI 管理 MCP 服务 [4]。

2. 插件方式（更灵活，推荐生产使用）

使用 @llm_tool 装饰器在插件中注册工具函数，LLM 可直接调用 [5]：

@star.register("firecrawl_search", "Author", "Firecrawl 搜索", "1.0.0")
class FirecrawlPlugin(star.Star):
    @llm_tool(name="web_search_firecrawl")
    async def search(self, query: str, max_results: int = 10) -> str:
        """使用 Firecrawl 搜索网页。
        
        Args:
            query(string): 搜索关键词
            max_results(number): 最大结果数
        """
        # 调用 Firecrawl API ...

简单对比：

• MCP：5 分钟上手、纯配置、适合快速验证，但有跨进程通信开销
• 插件：性能更好、可自定义缓存/错误处理，适合长期使用

如果你打算提交 PR 将 Firecrawl 作为内置搜索引擎，可以参考现有的 TavilyWebSearchTool 实现 [6]，在 web_search_tools.py 中添加对应的工具类并更新配置项。之前也有类似的 EXA MCP 集成需求 [7] 可以参考。

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.

[7618104m]

确实现在的网络搜索太简陋了