Debug Guide

Debugging Guide

Preview Generators

Use preview generators to test meta tags:

import { generateSerpPreview, generateOgPreview } from '@power-seo/preview';

const serp = generateSerpPreview({
  title: 'My Title',
  description: 'My description',
  url: 'https://example.com/page',
});

console.log(serp.titleTruncated); // Check if title gets cut off
console.log(serp.displayUrl);     // How URL appears

const og = generateOgPreview({
  title: 'My Title',
  description: 'My description',
  image: { url: 'https://example.com/og.jpg', width: 1200, height: 630 },
});

console.log(og.image?.valid);    // Image valid?
console.log(og.image?.message);  // Any errors?

Content Analysis Scoring

Check individual factors:

import { analyzeContent } from '@power-seo/content-analysis';

const result = analyzeContent({...});

result.results.forEach(check => {
  console.log(`${check.name}: ${check.status}`);
  console.log(`  Message: ${check.message}`);
});

Schema Validation

Validate before publishing:

import { validateSchema } from '@power-seo/schema';

const { valid, issues } = validateSchema(schema);

if (!valid) {
  issues.forEach(issue => {
    console.error(`${issue.path}: ${issue.message}`);
  });
}

Common Issues

1. Title too long: Check serp.titleTruncated
2. Description missing: Validate with preview generator
3. Image not loading: Check og.image?.message
4. Schema invalid: Run validateSchema()

---

See Troubleshooting Guide for detailed solutions.