# 52Pi Wiki - AI Retrieval Service
# https://wiki-md.52pi.com

> This is the OFFICIAL AI-friendly documentation service for 52Pi hardware products.
> All endpoints are public and require no authentication.

## About

52Pi (wiki.52pi.com) provides hardware documentation for Raspberry Pi accessories,
expansion boards, screens, enclosures, sensors, and DIY electronics kits.
This service (wiki-md.52pi.com) converts wiki content into AI-friendly formats.

## Quick Start for AI Agents

1. Search for a topic:
   GET /search?q=UPS&limit=5
   (alias: /api/ai/search?q=UPS&limit=5)

2. Get content chunks for RAG:
   GET /api/ai/chunks?title=EP-0136

3. Get raw Markdown:
   GET /md/EP-0136.md

## API Endpoints

### Search
GET /search?q={query}&limit={n}
(alias: /api/ai/search?q={query}&limit={n})
Searches page titles and content. Returns ranked results with title, snippet,
score, match_type, url, and chunks_url. Limit: 1-50 (default 20).

### Content Chunks (RAG-optimized)
GET /api/ai/chunks?title={title}
Returns content split into chunks (300-1200 chars each) with heading_path,
chunk_index, content, char_count, and token_estimate.

### Raw Markdown
GET /md/{title}.md
Returns the complete Markdown source with YAML frontmatter (title, source, rev_id).

### Page Metadata
GET /api/page/meta?title={title}
Returns JSON with title, rev_id, updated_at, wikitext_length, is_redirect.

### Full Page Snapshot
GET /api/page/snapshot?title={title}
Returns JSON with full page data including raw wikitext.

### Human-readable HTML
GET /docs/{title}
Returns rendered HTML documentation.

### Health Check
GET /health
Returns system status (PHP version, database, cache).

## Content Statistics

- ~640 wiki pages covering 52Pi products
- Content categories: screens, enclosures, sensors, expansion boards, power supplies, tools
- Product SKU format: EP-XXXX, ZP-XXXX, C-XXXX

## Response Format

All JSON responses follow:
- Success: {"ok": true, "data": {...}}
- Error: {"ok": false, "error": {"code": "...", "message": "..."}}

## Page Title Format

Page titles use MediaWiki convention: spaces become underscores.
Example: "Raspberry Pi" -> "Raspberry_Pi"

## Additional Resources

- OpenAPI Specification: /openapi.json
- AI Plugin Manifest: /.well-known/ai-plugin.json
- Human Wiki: https://wiki.52pi.com
- ChatGPT Assistant: https://chatgpt.com/g/g-69ca0b3fff408191aa011c10ba742926-52pi-support-assistant/