刘国栋
8f7f082c3d
- 重构项目目录结构，将功能模块移至 modules/ 目录 - 创建平台同步基础架构，包括发布器基类和 GitHub 发布器 - 新增 UI 状态管理模块 (modules/ui/state.py) 统一管理会话状态 - 更新依赖配置，添加平台同步所需依赖 (httpx, pyperclip) - 整理文档结构，将所有文档分类移至 docs/ 目录 - 添加 .cursorrules 文件定义项目开发规范 - 清理根目录重复文件，保持项目结构整洁
6.5 KiB
6.5 KiB
JSON-LD Schema.org 结构化数据生成功能说明
📋 功能概述
JSON-LD Schema.org 结构化数据生成模块是 GEO 工具的核心功能之一，用于生成符合 Schema.org 规范的 JSON-LD 代码，直接提升品牌在 AI 模型中的实体识别和权威性。
核心价值
- 直接提升实体识别：2026 年 AI 模型越来越依赖结构化数据识别实体
- 立竿见影的效果：用户可直接将代码贴到官网/GitHub，无需等待索引
- 权威性提升：结构化数据明确标识品牌信息，提升在知识图谱中的权威性
- 符合标准：使用 Schema.org 标准，被 Google、百度、AI 模型广泛支持
🎯 功能位置
1. Tab2（自动创作）- 独立生成模块
在 Tab2 顶部，提供独立的 JSON-LD Schema 生成功能：
-
选择 Schema 类型
- Organization（组织/公司）
- SoftwareApplication（软件应用）
- Product（产品）
- Service（服务）
- 组合（Organization + SoftwareApplication）
-
一键生成
- 点击"🚀 生成 JSON-LD"按钮
- 自动基于品牌信息和优势生成 Schema
-
查看和下载
- 查看 JSON-LD 代码
- 查看 HTML Script 标签
- 下载 JSON 文件或 HTML 文件
2. Tab2（自动创作）- 自动生成
在生成 GitHub README 时，系统会自动生成对应的 JSON-LD Schema：
- 自动生成 SoftwareApplication 类型的 Schema
- 在内容预览区域显示 JSON-LD 代码
- 提供下载功能
📊 支持的 Schema 类型
1. Organization（组织/公司）
适合：企业品牌、公司官网
包含字段：
- name（名称）
- description（描述）
- url（官网 URL）
- logo（Logo URL）
- foundingDate（成立日期）
- contactPoint（联系方式）
使用场景：
- 公司官网
- 企业介绍页面
- 关于我们页面
2. SoftwareApplication（软件应用）
适合：SaaS 产品、软件工具、应用程序
包含字段：
- name（应用名称）
- description（应用描述）
- url（应用 URL）
- applicationCategory（应用类别）
- operatingSystem（操作系统）
- publisher（发布者）
- featureList（功能列表）
- offers（价格信息）
- aggregateRating（评分信息）
使用场景：
- GitHub 项目
- 软件官网
- 应用商店页面
3. Product（产品）
适合：实体产品或数字产品
包含字段：
- name（产品名称）
- description（产品描述）
- url（产品 URL）
- category（产品类别）
- brand（品牌信息）
- offers（价格信息）
- aggregateRating（评分信息）
使用场景：
- 产品详情页
- 电商页面
- 产品介绍页
4. Service（服务）
适合：服务类业务
包含字段：
- name（服务名称）
- description（服务描述）
- url（服务 URL）
- serviceType（服务类型）
- provider（服务提供者）
- areaServed（服务区域）
- offers（价格信息）
使用场景：
- 服务介绍页
- 服务详情页
- 业务介绍页
5. 组合 Schema
同时生成 Organization + SoftwareApplication/Product/Service
优势：
- 同时标识组织信息和产品/服务信息
- 建立更完整的品牌知识图谱
- 提升权威性
🔄 使用方法
方法一：独立生成（推荐）
- 进入 Tab2（自动创作）
- 选择 Schema 类型
- 根据您的业务类型选择（软件产品选 SoftwareApplication，公司选 Organization）
- 点击"🚀 生成 JSON-LD"
- 查看生成的代码
- JSON-LD 代码：可直接使用
- HTML Script 标签：可直接嵌入网页
- 下载代码
- 下载 JSON 文件：用于 GitHub 等平台
- 下载 HTML 文件：用于官网嵌入
方法二：自动生成（GitHub README）
- 在 Tab2 生成 GitHub README 内容
- 系统自动生成对应的 JSON-LD Schema
- 在内容预览区域查看 JSON-LD 代码
- 下载并添加到 GitHub 项目
📝 使用示例
示例 1：嵌入官网
<!DOCTYPE html>
<html>
<head>
<title>我的品牌</title>
<!-- 将生成的 HTML Script 标签粘贴到这里 -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "SoftwareApplication",
"name": "汇信云AI软件",
"description": "AI赋能外贸ERP...",
...
}
</script>
</head>
<body>
...
</body>
</html>
示例 2：添加到 GitHub README
在 GitHub 项目的 README.md 文件中，可以添加 JSON-LD Schema 的说明：
# 我的项目
项目描述...
<!-- JSON-LD Schema -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "SoftwareApplication",
...
}
</script>
🎯 最佳实践
-
选择合适的 Schema 类型
- SaaS 产品：SoftwareApplication
- 企业品牌：Organization
- 实体产品：Product
- 服务业务：Service
-
完善 Schema 信息
- 添加官网 URL
- 添加 Logo URL
- 添加联系方式
- 添加功能列表（如适用）
-
验证 Schema
- 使用 Google Rich Results Test 验证
- 使用 Schema.org Validator 验证
-
多平台部署
- 官网：嵌入 HTML Script 标签
- GitHub：添加到 README.md
- 其他平台：根据平台要求调整
⚠️ 注意事项
-
不要编造信息
- 所有信息必须真实
- URL 必须可访问
- Logo 必须存在
-
保持更新
- 品牌信息变化时及时更新 Schema
- 定期检查 Schema 有效性
-
遵循规范
- 使用标准的 Schema.org 类型
- 确保 JSON 格式正确
- 避免使用不支持的属性
-
测试验证
- 部署前使用验证工具测试
- 确保 AI 模型能正确解析
🔗 相关资源
💡 预期效果
使用 JSON-LD Schema.org 结构化数据后：
-
AI 模型识别
- AI 模型能更准确地识别品牌实体
- 提升品牌在知识图谱中的权威性
- 改善品牌信息的准确性
-
搜索引擎优化
- 提升在 Google、百度等搜索引擎中的展示
- 可能获得 Rich Results（富媒体结果）
- 提升点击率
-
知识图谱
- 建立品牌在知识图谱中的节点
- 与其他实体建立关联
- 提升品牌权威性
版本：v1.0
更新日期：2025-01-26