# yaml-language-server: $schema=https://schema.zeabur.app/template.json
apiVersion: zeabur.com/v1
kind: Template
metadata:
    name: Agent Web Search
spec:
    description: Multi-provider web search MCP server for AI agents, with free keyless providers enabled by default.
    icon: https://cdn.simpleicons.org/modelcontextprotocol/24A148
    variables:
        - key: PUBLIC_DOMAIN
          type: DOMAIN
          name: Public domain
          description: Public domain for the stateless Streamable HTTP MCP endpoint.
        - key: AGENT_WEB_SEARCH_AUTH_TOKEN
          type: PASSWORD
          name: MCP bearer token
          description: Secret bearer token used to protect /mcp. It must be at least 32 characters long.
    tags:
        - AI
        - Tool
        - API
    readme: |-
        # Agent Web Search

        A stateless Streamable HTTP MCP server that combines multiple independent
        web-search providers behind one `web_search` tool.

        DDGS, Exa, and Parallel are enabled by default and can be used without API
        keys. Provider failures are isolated; successful results are still returned
        when another provider fails.

        ## Connect

        - MCP endpoint: `https://${PUBLIC_DOMAIN}/mcp`
        - Authorization: `Bearer ${AGENT_WEB_SEARCH_AUTH_TOKEN}`
        - Health check: `https://${PUBLIC_DOMAIN}/healthz`

        The MCP endpoint accepts `POST` requests only. It uses JSON responses and is
        stateless, so clients do not need to retain an `MCP-Session-Id`.

        ## Optional provider keys

        The default deployment works without provider keys. To use paid provider
        APIs or enable additional providers, add the relevant environment variables
        in the Zeabur service settings. See the project README for the full provider
        list and configuration options.

        Source: https://github.com/JerryLiu369/agent-web-search
    services:
        - name: agent-web-search
          icon: https://cdn.simpleicons.org/modelcontextprotocol/24A148
          template: GIT
          spec:
            id: agent-web-search
            source:
                source: GITHUB
                repo: 1340504349
                branch: main
            ports:
                - id: web
                  port: 8000
                  type: HTTP
            instructions:
                - title: MCP endpoint
                  content: https://${PUBLIC_DOMAIN}/mcp
                - title: MCP bearer token
                  content: ${AGENT_WEB_SEARCH_AUTH_TOKEN}
                - title: Health check
                  content: https://${PUBLIC_DOMAIN}/healthz
            env:
                AGENT_WEB_SEARCH_ALLOW_ANONYMOUS:
                    default: "false"
                AGENT_WEB_SEARCH_HTTP_HOST:
                    default: 0.0.0.0
                AGENT_WEB_SEARCH_HTTP_PORT:
                    default: "8000"
                AGENT_WEB_SEARCH_MCP_TRANSPORT:
                    default: http
                AGENT_WEB_SEARCH_PROVIDERS:
                    default: ddgs,exa,parallel
                AGENT_WEB_SEARCH_TIMEOUT:
                    default: "60"
            healthCheck:
                type: HTTP
                port: web
                http:
                    path: /healthz
          domainKey: PUBLIC_DOMAIN
localization:
    zh-CN:
        description: 面向 AI Agent 的多服务商网页搜索 MCP Server，默认启用无需密钥的免费搜索服务。
        variables:
            - key: PUBLIC_DOMAIN
              type: DOMAIN
              name: 公网域名
              description: 无状态 Streamable HTTP MCP 端点使用的公网域名。
            - key: AGENT_WEB_SEARCH_AUTH_TOKEN
              type: PASSWORD
              name: MCP Bearer Token
              description: 用于保护 /mcp 的私密令牌，长度必须至少为 32 个字符。
        readme: |-
            # Agent Web Search

            一个无状态的 Streamable HTTP MCP Server，通过统一的 `web_search`
            工具聚合多个相互独立的网页搜索服务商。

            默认启用 DDGS、Exa 和 Parallel，无需 API Key 即可开始使用。单个
            Provider 失败不会拖垮整次搜索；只要仍有成功结果，就会正常返回。

            ## 连接方式

            - MCP 端点：`https://${PUBLIC_DOMAIN}/mcp`
            - 鉴权：`Bearer ${AGENT_WEB_SEARCH_AUTH_TOKEN}`
            - 健康检查：`https://${PUBLIC_DOMAIN}/healthz`

            MCP 端点只接受 `POST` 请求，使用 JSON 响应并保持无状态，客户端
            不需要保存 `MCP-Session-Id`。

            ## 可选 Provider 密钥

            默认部署不需要任何 Provider Key。如需调用付费 API 或启用更多
            Provider，可在 Zeabur 服务设置中添加相应环境变量。完整列表和配置
            方法请查看项目 README。

            源码：https://github.com/JerryLiu369/agent-web-search