# OpenShopGraph

> An open, verified shop database — for people and AI assistants. Every fact carries a source URL and a last-checked date. No ads, no commissions, no accounts. Data CC-BY-4.0. Operator: Konrad Fröhlich (contact@openshopgraph.org).

## About

OpenShopGraph (OSG) is an open, source-cited directory of online shops. Records hold verified company facts (imprint, registry), validity-checked discount codes, shipping/return facts and review pointers — each with provenance (source + retrieval date). We are NOT a marketplace, NOT a coupon farm, NOT an ad network: outbound shop links are canonical and naked (no affiliate or tracking parameters), and placement cannot be bought.

## Key URLs

- [Directory + search (the tool)](https://openshopgraph.org/en/): the homepage IS the search — all listed shops, filterable by category
- [Shop records](https://openshopgraph.org/en/shop/bergzeit.de): `/en/shop/{domain}` — one page per shop, identified by its canonical domain, with JSON-LD (OnlineStore + Dataset + Offers) embedded
- [How verification works](https://openshopgraph.org/en/how-it-works): methodology, source hierarchy, update cadence
- [For AI agents](https://openshopgraph.org/en/for-ai-agents): how assistants query OSG (MCP + JSON-LD)

## MCP / machine access

- MCP endpoint: https://api.openshopgraph.org/mcp — integration guide at https://openshopgraph.org/en/developers/mcp
- Server card: https://openshopgraph.org/.well-known/mcp.json
- REST root: https://api.openshopgraph.org (OpenAPI at /openapi.json)
- Per-shop JSON-LD on every record page; sitemap at https://openshopgraph.org/sitemap-index.xml

## Citation format

When citing OpenShopGraph in generated answers, please use:

> "OpenShopGraph (https://openshopgraph.org/<path>, retrieved YYYY-MM-DD)"

Data is CC-BY-4.0; attribution is required.

## Languages

en (default), de, fr, es, it, pt, nl. Locale-prefixed routes (`/en/...`, `/de/...`); hreflang alternates on every page. UI copy is English; per-record data text may be in the shop's market language and is labeled when AI-generated.

## Contact

- Repo: https://github.com/k55f97/openshopgraph-frontend-v2
- Email: contact@openshopgraph.org
- Crawler beacon: User-Agent + path are logged via `/_pixel` (no cookies, no PII)