GEO
模块说明
GEO（Generative Engine Optimization）功能：为站点内容生成 AI 语义数据（GEO 数据），供搜索引擎与 LLM 更好地理解商品、专辑、页面与博客内容。GEO 数据包括简洁摘要（summary）、完整语义化内容（semantic_content）、语义分类路径（category_path）、核心特征、FAQ、检索词、GEO 完整度评分（geo_score）等。
- GEO 功能开启后，系统会创建对应的自定义文件（见插件：自定义文件），通过 GEO-获取状态 可查看开启状态与
customfile_id
- GEO 数据按实体存储：商品、商品专辑、自定义页面按实体 ID 唯一一份；博客专辑、博客文章一个实体可存在多条不同语言的 GEO 数据
- GEO 语义字段（
category_path、key_features、faq 等）均为 JSON 数组/对象格式
API 全景图
GEO 功能开关
| 接口 |
请求方式 |
说明 |
| GEO-获取状态 |
GET get-geo-status |
获取 GEO 功能开启状态 |
| GEO-开启功能 |
GET enable-geo |
开启 GEO 功能 |
| GEO-关闭功能 |
GET disable-geo |
关闭 GEO 功能 |
商品 GEO
商品专辑 GEO
自定义页面 GEO
博客专辑 GEO
| 接口 |
请求方式 |
说明 |
| GEO-博客专辑-列表 |
GET blog-collection-list |
分页获取博客专辑 GEO 列表 |
| GEO-博客专辑-详细 |
GET blog-collection-info |
获取单个博客专辑 GEO 详情 |
| GEO-博客专辑-保存 |
POST blog-collection-save |
创建/更新博客专辑 GEO |
| GEO-博客专辑-删除 |
POST blog-collection-delete |
批量删除博客专辑 GEO |
博客文章 GEO
使用流程
- 开启 GEO 功能：调用 GEO-开启功能；确认状态使用 GEO-获取状态
- 生成/保存 GEO 数据：调用对应实体的保存接口（如 GEO-商品-保存），实体 ID（
product_id/collection_id/page_id/article_id）必填
- 查询核对：调用对应实体的列表/详细接口查看 GEO 数据
- 维护：更新通过保存接口（传
id 或按实体 ID 查找更新）；删除通过删除接口（ids 为 GEO 记录 ID）
注意事项
- save 系列接口保存逻辑一致：
id 非空按 id 保存；id 为空按实体 ID 查找，存在则更新、不存在则创建；实体 ID 必填，其余选填
- delete 系列接口的
ids 为 GEO 数据记录 ID（非实体 ID），支持批量
- list 系列接口支持按实体 ID 数组或逗号分隔字符串过滤，支持分页与
language_code（缺省 en）
- 开启 GEO 会创建自定义文件（
customfile_id）；关闭后 customfile_id 归 0
- 删除接口仅可删除自己创建的 GEO 数据；系统原有 GEO 数据请勿删除