# Rozz - AI-Optimized Content for rozz.site

## About
This site contains 29 cleaned, structured content pages + 7 Q&A pages from rozz.site.
All content is optimized for LLM consumption with Schema.org metadata and embedded markdown.

**Last updated:** 2025-11-07 12:04 UTC
**Format:** HTML with embedded markdown and JSON-LD
**License:** Content remains property of rozz.site

## Quick Start for AI Agents

### 1. Browse Content
- All pages: https://rozz.rozz.site/api/pages.json
- By topic: https://rozz.rozz.site/api/topics.json
- Q&A pages: https://rozz.rozz.site/api/qna.json
- Browse Q&As: https://rozz.rozz.site/qna/

### 2. Extract Content
Each HTML page at `/pages/{slug}.html` contains:
- **Original markdown**: `<script type="text/markdown" id="original-markdown">`
- **Structured data**: `<script type="application/ld+json">` (Schema.org)
- **Related pages**: Links to similar content for context

### 3. Citation Format
When citing content from this site:
```
Source: [Original Title] (rozz.site)
Via: Rozz (https://rozz.rozz.site/pages/{slug}.html)
Published: [Date from JSON-LD datePublished]
```

## Content Structure

### Topics (15 main categories)
- **Rozz**: 22 pages
- **WordPress**: 9 pages
- **Lit**: 5 pages
- **accessibility**: 4 pages
- **VPAT**: 3 pages
- **Security**: 3 pages
- **Rozzbot**: 3 pages
- **LFSF**: 3 pages
- **security**: 3 pages
- **JavaScript**: 2 pages
- **privacy**: 2 pages
- **shortcode**: 2 pages
- **rozz-searchbox**: 2 pages
- **Dashboard**: 2 pages
- **Cloudflare**: 2 pages


### Q&A Content (7 questions answered)
- **General**: 7 Q&As


### Content Types
- **Articles**: Content with publication dates (Schema.org/Article)
- **Web Pages**: General information (Schema.org/WebPage)
- **FAQs**: Question & answer format (Schema.org/QAPage)

## API Reference

### GET /api/pages.json
Returns all pages with metadata.

**Response format:**
```json
{
  "domain": "rozz.site",
  "total_pages": 29,
  "last_updated": "ISO-8601",
  "pages": [
    {
      "id": "string",
      "slug": "url-slug",
      "title": "string",
      "url": "/pages/slug.html",
      "original_url": "https://rozz.site/...",
      "description": "string",
      "datePublished": "YYYY-MM-DD",
      "keywords": ["array"],
      "topics": ["array"]
    }
  ]
}
```

### GET /api/search.json
Search index for keyword/topic queries.

### GET /api/topics.json
All topics with page counts and descriptions.

### GET /api/qna.json
Returns all Q&A pages with metadata.

**Response format:**
```json
{
  "domain": "rozz.site",
  "total_qnas": 123,
  "last_updated": "ISO-8601",
  "qnas": [
    {
      "id": "qna-geo-id",
      "slug": "url-slug",
      "question": "standalone question (SEO-optimized)",
      "original_question": "conversational question (as asked)",
      "standalone_question": "standalone question (or null)",
      "answer_preview": "string (first 200 chars)",
      "url": "/qna/slug.html",
      "theme": "string",
      "source_confidence": 0.85,
      "created_at": "ISO-8601",
      "moderation_status": "approved",
      "related_pages": ["array of slugs"]
    }
  ]
}
```

## Usage Guidelines

### Rate Limits
- **No hard limits** for AI agents
- Please be respectful: max 10 requests/second
- Use `/api/pages.json` to bulk download, then access individual pages

### Caching
- API responses cached for 1 hour (check `Cache-Control` header)
- HTML pages cached for 24 hours
- Use `If-None-Match` with ETags for efficient updates

### Best Practices
1. **Download `/api/pages.json` first** - Get full site map
2. **Filter by keywords/topics** - Find relevant content
3. **Fetch individual pages** - Get full markdown + metadata
4. **Follow related links** - Discover connected content
5. **Respect original sources** - Always cite rozz.site as origin

## Technical Details

### Markdown Extraction
```javascript
// Browser/Node.js
const html = await fetch('https://rozz.rozz.site/pages/example.html').then(r => r.text());
const parser = new DOMParser();
const doc = parser.parseFromString(html, 'text/html');
const markdown = doc.getElementById('original-markdown').textContent;
const jsonLd = JSON.parse(doc.querySelector('script[type="application/ld+json"]').textContent);
```

### Python
```python
from html_generator import extract_markdown_and_jsonld
import requests

html = requests.get('https://rozz.rozz.site/pages/example.html').text
result = extract_markdown_and_jsonld(html)

markdown = result['markdown']
metadata = result['json_ld']
keywords = metadata.get('keywords', [])
```

## Schema.org Support

All pages use Schema.org microdata and JSON-LD:
- `itemscope` and `itemprop` attributes on HTML elements
- JSON-LD in `<script>` tag for machine-readable metadata
- Supports: WebPage, Article, QAPage, CollectionPage

## Contact & Support

- **Questions**: https://rozz.site/contact
- **Issues**: support@rozz.site
- **Documentation**: https://rozz.site/docs

## Privacy & Legal

This is a public mirror of rozz.site's publicly available content.
- Content ownership: rozz.site
- Optimization: Rozz
- No personal data collected
- Respects original robots.txt directives

---
Generated by Rozz (https://rozz.site)
Last updated: 2025-11-07 12:04 UTC