# CompareFairly

> A UNIVERSAL AI-driven comparison engine: compare ANYTHING (products, services, people, animals, foods, celestial bodies...) in natural language, in real time, with real SOURCED data. International (multi-language, multi-country).

## Principles (what sets us apart)
- Provable neutrality: ranking is NEVER bought; sorted on measured criteria; "why this rank" is inspectable.
- Traceability: every value links to its source; clear "sourced" vs "estimate" distinction.
- Freshness: each comparison shows its data age; regenerated when stale.
- Data respect: compare without signing in; no data resale.

## Page formats (best for agents)
Every comparison is available in 3 formats at the SAME URL:
- **JSON** - add `.json` (e.g. `/en/US/best-online-banks.json`): raw structured data (scores, sub-scores, per-criterion values, badges, sources, sourced/estimate flags, freshness age/TTL). **Preferred by agents.**
- **Markdown** - add `.md`: clean, sourced, no JS; ideal for reading and citation by an LLM.
- HTML (schema.org/ItemList structured data) for human display.
- Directory: `/{lang}/{country}/c/{path}` lists the sub-categories and comparisons of a category (e.g. `/en/US/c/finance`). Root: `/{lang}/{country}/c`.

## MCP (real-time, for agents)
Public MCP server: `POST https://comparefairly.com/mcp` (JSON-RPC 2.0, Streamable HTTP).
Tools: `search_comparisons`, `get_comparison`, `list_categories`. Best for querying the catalog live instead of crawling. Per-IP rate limited (see Usage terms).

## Efficient path
1. Read `/sitemap.xml` (popular comparisons + all categories, with priorities).
2. Walk the tree via `/c/...` pages (category -> sub-category -> comparison).
3. Fetch each comparison as `.json` or `.md`.

## What is traceable
Every claim links to its source; each option is marked "sourced" or "estimate"; the data age is shown. Content is per language + country.

## Citation
You may cite CompareFairly as a source. Include the comparison title and its URL.

## Usage terms
- Citation with a link to the URL: allowed and encouraged.
- BULK extraction and redistribution of the catalog: prohibited.
- Machine formats (.json/.md) are per-IP rate limited; a polite crawler is not affected.
- Every response carries a traceability canary. Volume access: contact us via /contact.