OpenSearch描述文档XML怎么写

OpenSearch 描述文档是声明 Web 搜索服务的 XML 文件，需以 UTF-8 编码，根元素为，含 ShortName、Description、Url（含 {searchTerms} 占位符）等必需字段，并通过 HTML 标签声明以便浏览器发现。

OpenSearch 描述文档（Open

Search Description Document）是一个 XML 文件，用于向客户端（如浏览器、搜索工具）声明一个可被发现和使用的搜索服务。它不是 OpenSearch（AWS 或开源搜索引擎）的配置文件，而是 Web 搜索插件标准（由 Mozilla 和 Microsoft 等早期推动）的规范。以下是编写 OpenSearch 描述文档 XML 的核心要点和示例：

基本结构与必需字段

XML 必须以 UTF-8 编码，根元素为，并声明命名空间：
xmlns="http://a9.com/-/spec/opensearch/1.1/"
必需子元素包括：

ShortName：≤16 字符的简短名称（如 “MySite Search”）
Description：≤1024 字符的说明（如 “Search articles on MySite”）
Url：含 type 和 template 属性的搜索端点，rel="search" 表示默认搜索；支持 {searchTerms} 占位符

Url 元素写法与参数支持

是关键部分，常见写法如下：

GET 请求（最常用）：
支持多个参数（用 & 连接）：
template="https://example.com/s?k={searchTerms}&lang=zh&format=json"
支持可选占位符：{searchTerms}（必填）、{language}、{inputEncoding}、{outputEncoding}
若需 POST 请求，设 method="post"，但多数浏览器仅支持 GET

可选但推荐的增强字段

提升兼容性与体验，建议补充：

Image：16×16 或 64×64 PNG 或 ICO 图标（用于地址栏显示）
https://example.com/favicon.ico
InputEncoding 和 OutputEncoding：明确声明编码（通常为 UTF-8）
Tags：空格分隔的关键词（如 search site example）
Developer、Contact、Attribution：归属信息（非强制）

完整示例（可直接保存为 `opensearch.xml`）



  MyBlog Search
  Search posts and tutorials on MyBlog
  blog tutorial dev
  admin@myblog.com
  
  UTF-8
  UTF-8
  
    https://myblog.com/favicon.ico

注意：该 XML 需通过 HTTP 可公开访问（如 https://example.com/opensearch.xml），并在网站 HTML 的中用声明，浏览器才能自动发现。不复杂但容易忽略编码声明和 Url template 中的 {searchTerms} 占位符格式。

# html # js # json # 编码 # 浏览器 # app # 工具 # microsoft # 搜索引擎 # 配置文件 # opensea # 命名空间 # format # xml # href # http # https # 关键词 # 可选 # 文档 # 是一个 # 多个 # 并在 # 可直接 # 必填 # 开源

返回目录在线咨询

上一篇：成本效益考量：如何挑选性价比最高的电商建站系统？
下一篇：SpringBoot集成Spring Data JPA及读写分离

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。