如何实现用户访问网站时自动将本站搜索添加至用户浏览器

你要实现的浏览器自动收录站点搜索的能力，基于OpenSearch开放标准即可完成，这套标准是Chrome、Edge、Firefox、高版本Safari等所有主流浏览器原生支持的，不需要用户安装任何插件，只要用户访问过你的站点、配置符合规范，浏览器就会自动把你的站内搜索加入内置搜索选项列表。

具体操作步骤 #

• 第一步：编写OpenSearch描述文件
  新建名为opensearch.xml的文件，参考下方模板替换成你自己站点的对应信息：

<?xml version="1.0" encoding="UTF-8"?>
<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/">
  <ShortName>你的站点简称</ShortName>
  <Description>你的站点全称 站内搜索</Description>
  <Image type="image/x-icon" width="16" height="16">https://你的域名/favicon.ico</Image>
  <Url type="text/html" template="https://你的域名/search路径?q={searchTerms}" />
  <InputEncoding>UTF-8</InputEncoding>
</OpenSearchDescription>

字段说明：

• ShortName：展示在浏览器搜索列表里的名称，长度控制在16字符以内，避免显示不全
• Image：搜索选项前展示的图标，直接用你站点的favicon即可，尺寸选1616或3232
• Url的template属性：填你站内搜索的GET接口地址，{searchTerms}是固定占位符，浏览器会自动把用户输入的关键词替换到这个位置
• 第二步：部署配置并添加页面引用
  1. 把编辑好的opensearch.xml上传到站点根目录，确保可以通过https://你的域名/opensearch.xml正常访问
  2. 在站点所有页面的<head>标签内加入如下引用代码，让浏览器能识别到搜索配置：

<link rel="search" type="application/opensearchdescription+xml" title="你的站点名" href="/opensearch.xml">

验证和效果说明 #

配置发布后，用户首次访问你的站点时，浏览器会自动拉取opensearch.xml配置并收录你的站内搜索能力，不需要用户手动操作。收录完成后：

• 点击地址栏的搜索选择按钮，就能在搜索提供商列表里看到你的站点选项，和示例效果一致
• 用户在地址栏输入你的域名，浏览器会提示按Tab键触发专属站内搜索，触发后输入关键词回车就会直接跳转到你站点的搜索结果页。

注意：你的站内搜索接口必须支持GET方式传参，浏览器触发搜索时是直接拼接URL跳转，不支持POST类型的搜索接口。

站点搜索效果示例：

用户触发搜索时的展示效果：

内容的提问来源于stack exchange，提问作者jungle