# CLAUDE.md

## Overview

Schema markup generator: create JSON-LD structured data from templates for various content types.

## Quick Start

```bash
pip install -r scripts/requirements.txt

# Generate Organization schema
python scripts/schema_generator.py --type organization --url https://example.com

# Generate from template
python scripts/schema_generator.py --template templates/article.json --data article_data.json
```

## Scripts

| Script | Purpose |
|--------|---------|
| `schema_generator.py` | Generate schema markup |
| `base_client.py` | Shared utilities |

## Supported Schema Types

| Type | Template | Use Case |
|------|----------|----------|
| Organization | `organization.json` | Company/brand info |
| LocalBusiness | `local_business.json` | Physical locations |
| Article | `article.json` | Blog posts, news |
| Product | `product.json` | E-commerce items |
| FAQPage | `faq.json` | FAQ sections |
| BreadcrumbList | `breadcrumb.json` | Navigation path |
| WebSite | `website.json` | Site-level info |

## Usage Examples

### Organization
```bash
python scripts/schema_generator.py --type organization \
  --name "Company Name" \
  --url "https://example.com" \
  --logo "https://example.com/logo.png"
```

### LocalBusiness
```bash
python scripts/schema_generator.py --type localbusiness \
  --name "Restaurant Name" \
  --address "123 Main St, City, State 12345" \
  --phone "+1-555-123-4567" \
  --hours "Mo-Fr 09:00-17:00"
```

### Article
```bash
python scripts/schema_generator.py --type article \
  --headline "Article Title" \
  --author "Author Name" \
  --published "2024-01-15" \
  --image "https://example.com/image.jpg"
```

### FAQPage
```bash
python scripts/schema_generator.py --type faq \
  --questions questions.json
```

## Output

Generated JSON-LD ready for insertion:

```html
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Company Name",
  "url": "https://example.com",
  "logo": "https://example.com/logo.png"
}
</script>
```

## Template Customization

Templates in `templates/` can be modified. Required fields are marked:

```json
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "{{REQUIRED}}",
  "author": {
    "@type": "Person",
    "name": "{{REQUIRED}}"
  },
  "datePublished": "{{REQUIRED}}",
  "image": "{{RECOMMENDED}}"
}
```

## Validation

Generated schemas are validated before output:
- Syntax correctness
- Required properties present
- Schema.org vocabulary compliance

Use skill 13 (schema-validator) for additional validation.

## Dependencies

```
jsonschema>=4.21.0
requests>=2.31.0
python-dotenv>=1.0.0
```