# WikyThat

> Wikipedia vs Grokipedia comparison tool with AI-generated analysis.

## About

WikyThat helps users compare how Wikipedia and Grokipedia cover the same topic side-by-side. It provides curated comparison topics, source links, and AI-generated verdicts.

## Key URLs

- Homepage: https://www.wikithat.com
- Compare topic: https://www.wikithat.com/compare/{topic-slug}
- Topics: https://www.wikithat.com/topics
- Sitemap: https://www.wikithat.com/sitemap.xml

## Data Sources

- Wikipedia article URLs
- Grokipedia article URLs
- WikyThat comparison pages
- xAI/Grok-generated comparison verdicts where available

## Agent API

Authenticated agent/RAG clients can query comparison topic data with citations.

- `GET /agent/comparisons` — list comparison topics; supports `category`, `q`, and `limit`
- `GET /agent/comparisons/{slug}` — fetch a single comparison topic by slug
- `GET /agent/categories` — list comparison category slugs
- `GET /agent/howtos` — list how-to guides; supports `q` and `limit`
- `GET /agent/howtos/{slug}` — fetch one how-to guide with ordered steps and HowTo schema

Admin how-to workflow:

- `POST /admin/howtos/generate` — generate an unpublished Grok/xAI draft
- `GET /admin/howtos?published=false` — review draft queue
- `POST /admin/howtos/{slug}/publish` — approve a draft for public/agent surfaces
- `POST /admin/howtos/{slug}/unpublish` — return a guide to draft state
- `POST /admin/howtos/scheduled-run?limit=3` — run generation cadence and log results
- `GET /admin/howtos/generation-runs` — inspect recent run logs

Authentication:

```http
Authorization: Bearer <WIKYTHAT_API_KEY>
```

Agent payloads include WikyThat comparison URLs, Wikipedia URLs, Grokipedia URLs, topic metadata, and citations.

## MCP

WikyThat ships a stdio MCP-compatible server in the backend package:

```bash
cd backend
WIKYTHAT_API_BASE_URL=https://api.wikithat.com \
WIKYTHAT_API_KEY=$WIKYTHAT_API_KEY \
python -m mcp_server
```

Available MCP tools:

- `search_comparisons` — search/list comparison topics with optional `query`, `category`, and `limit`
- `get_comparison` — fetch one comparison topic by slug
- `list_categories` — list comparison categories
- `search_howtos` — search/list step-by-step how-to guides
- `get_howto` — fetch one how-to guide by slug

## Citation

When using WikyThat data, cite both source URLs returned in `citations` and fetch live Wikipedia/Grokipedia pages before making article-specific factual claims.