Schema.org 结构化数据最佳实践：开发者工具站的技术实现指南

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "SoftwareApplication",
      "name": "Birdor JSON Formatter",
      "description": "免费的在线 JSON 格式化工具，支持美化、压缩、排序和 JSON to TypeScript 转换。数据在浏览器本地处理，不上传服务器。",
      "applicationCategory": "DeveloperApplication",
      "operatingSystem": "Any (Web-based)",
      "offers": {
        "@type": "Offer",
        "price": "0",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock"
      },
      "featureList": [
        "JSON 美化和压缩",
        "按键排序",
        "JSON 语法验证",
        "JSON to TypeScript 转换",
        "大文件支持（最大 10MB）",
        "本地处理，数据隐私安全"
      ],
      "softwareVersion": "2.1.0",
      "url": "https://birdor.com/tools/json-formatter",
      "screenshot": {
        "@type": "ImageObject",
        "url": "https://birdor.com/images/json-formatter-screenshot.png"
      },
      "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": "4.8",
        "reviewCount": "1250"
      }
    },
    {
      "@type": "FAQPage",
      "mainEntity": [
        {
          "@type": "Question",
          "name": "JSON Formatter 是否免费使用？",
          "acceptedAnswer": {
            "@type": "Answer",
            "text": "完全免费。无需注册，无限次使用。Pro 用户可使用 API 集成和批量处理功能。"
          }
        },
        {
          "@type": "Question",
          "name": "数据是否会上传到服务器？",
          "acceptedAnswer": {
            "@type": "Answer",
            "text": "不会。所有处理在浏览器本地完成，数据不会离开你的设备。"
          }
        },
        {
          "@type": "Question",
          "name": "支持多大的 JSON 文件？",
          "acceptedAnswer": {
            "@type": "Answer",
            "text": "免费版支持最大 10MB 的 JSON 文件。Pro 版支持最大 50MB。"
          }
        }
      ]
    },
    {
      "@type": "HowTo",
      "name": "如何使用 Birdor JSON Formatter 格式化 JSON",
      "description": "三步完成 JSON 格式化：粘贴、点击格式化、复制结果。",
      "totalTime": "PT1M",
      "supply": ["需要格式化的 JSON 文本"],
      "tool": ["Birdor JSON Formatter"],
      "step": [
        {
          "@type": "HowToStep",
          "name": "粘贴 JSON 文本",
          "text": "在输入框中粘贴或输入需要格式化的 JSON 文本。",
          "url": "https://birdor.com/tools/json-formatter#step1"
        },
        {
          "@type": "HowToStep",
          "name": "点击格式化按钮",
          "text": "点击"格式化"按钮，工具会自动验证 JSON 语法并美化输出。",
          "url": "https://birdor.com/tools/json-formatter#step2"
        },
        {
          "@type": "HowToStep",
          "name": "复制格式化结果",
          "text": "点击输出框的复制按钮，将格式化后的 JSON 复制到剪贴板。",
          "url": "https://birdor.com/tools/json-formatter#step3"
        }
      ]
    }
  ]
}

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "TechArticle",
      "headline": "Schema.org 结构化数据最佳实践：开发者工具站的技术实现指南",
      "description": "从 Schema.org 的类型体系出发，为开发者工具平台提供完整的结构化数据实施方案。",
      "author": {
        "@type": "Person",
        "name": "Leeting Yan",
        "url": "https://birdor.com/authors/leeting-yan"
      },
      "publisher": {
        "@type": "Organization",
        "name": "Birdor",
        "logo": {
          "@type": "ImageObject",
          "url": "https://birdor.com/logo.png"
        }
      },
      "datePublished": "2025-12-01",
      "dateModified": "2026-08-09",
      "image": "https://birdor.com/images/structured-data-guide.png",
      "keywords": ["Schema.org", "JSON-LD", "Structured Data", "Developer Tools SEO"],
      "proficiencyLevel": "Intermediate"
    },
    {
      "@type": "FAQPage",
      "mainEntity": [
        {
          "@type": "Question",
          "name": "Schema.org 和 JSON-LD 是什么关系？",
          "acceptedAnswer": {
            "@type": "Answer",
            "text": "Schema.org 是词汇表（定义了类型的属性），JSON-LD 是数据格式（将 Schema.org 数据编码为 JSON）。两者结合是 Google 推荐的标准实现方式。"
          }
        }
      ]
    }
  ]
}

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "WebSite",
      "name": "Birdor - AI 增强型开发者工具平台",
      "url": "https://birdor.com",
      "potentialAction": {
        "@type": "SearchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "https://birdor.com/search?q={search_term_string}"
        },
        "query-input": "required name=search_term_string"
      }
    },
    {
      "@type": "Organization",
      "name": "Birdor",
      "url": "https://birdor.com",
      "logo": "https://birdor.com/logo.png",
      "sameAs": [
        "https://github.com/birdor",
        "https://twitter.com/birdor",
        "https://linkedin.com/company/birdor"
      ]
    },
    {
      "@type": "ItemList",
      "name": "热门开发者工具",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "item": {
            "@type": "SoftwareApplication",
            "name": "JSON Formatter",
            "url": "https://birdor.com/tools/json-formatter"
          }
        },
        {
          "@type": "ListItem",
          "position": 2,
          "item": {
            "@type": "SoftwareApplication",
            "name": "JWT Decoder",
            "url": "https://birdor.com/tools/jwt-decoder"
          }
        }
      ]
    }
  ]
}

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "首页",
      "item": "https://birdor.com"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "工具",
      "item": "https://birdor.com/tools"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "JSON Formatter",
      "item": "https://birdor.com/tools/json-formatter"
    }
  ]
}

// 伪代码示例
function generateToolPageSchema(tool) {
  const schema = {
    "@context": "https://schema.org",
    "@graph": [
      generateSoftwareApplicationSchema(tool),
      generateFAQPageSchema(tool.faqs),
      generateHowToSchema(tool.howToSteps),
      generateBreadcrumbSchema(tool.breadcrumbs)
    ]
  };
  return `<script type="application/ld+json">${JSON.stringify(schema)}</script>`;
}

// 使用 schema-dts 和 jest 进行自动化测试
describe('Structured Data Validation', () => {
  it('JSON Formatter page should have valid SoftwareApplication schema', async () => {
    const response = await fetch('https://birdor.com/tools/json-formatter');
    const html = await response.text();
    const schemas = extractJsonLd(html);
    
    const appSchema = schemas.find(s => s['@type'] === 'SoftwareApplication');
    expect(appSchema).toBeDefined();
    expect(appSchema.name).toBe('Birdor JSON Formatter');
    expect(appSchema.applicationCategory).toBe('DeveloperApplication');
  });
});

{
  "@type": "SoftwareApplication",
  "name": "Birdor JSON Formatter",
  "offers": [
    {
      "@type": "Offer",
      "name": "Web 版",
      "price": "0",
      "url": "https://birdor.com/tools/json-formatter"
    },
    {
      "@type": "Offer",
      "name": "VS Code 扩展",
      "price": "0",
      "url": "https://marketplace.visualstudio.com/items/birdor.json-formatter"
    },
    {
      "@type": "Offer",
      "name": "Pro API 订阅",
      "price": "9.99",
      "priceCurrency": "USD",
      "priceValidUntil": "2026-12-31"
    }
  ]
}

{
  "@type": "SoftwareApplication",
  "name": "Birdor JSON Formatter",
  "isRelatedTo": {
    "@type": "SoftwareApplication",
    "name": "Birdor JSON to TypeScript Converter",
    "url": "https://birdor.com/tools/json-to-typescript"
  }
}

{
  "@type": "TechArticle",
  "articleBody": {
    "@type": "SoftwareSourceCode",
    "programmingLanguage": "JavaScript",
    "code": "const formatted = JSON.stringify(data, null, 2);",
    "description": "使用 JSON.stringify 美化 JSON 输出"
  }
}