# OpenShopGraph

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

## 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.com/en/): the homepage IS the search — all listed shops, filterable by category
- [Shop records](https://openshopgraph.com/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.com/en/how-it-works): methodology, source hierarchy, update cadence
- [For AI agents](https://openshopgraph.com/en/for-ai-agents): how assistants query OSG (MCP + JSON-LD), install snippets, example prompts

## MCP server

- Endpoint (streamable-HTTP): https://api.openshopgraph.com/mcp — no key needed for find_shop, list_categories, get_shop, list_coupons and get_shipping_policy; get_trust, report_code and report_issue require a consumer key (x-api-token header; request one at info@openshopgraph.com, no self-service signup yet)
- stdio: no first-party npm package is published — connect via `npx mcp-remote https://api.openshopgraph.com/mcp` (community bridge) or use the streamable-HTTP endpoint above directly
- Server card (schema): https://openshopgraph.com/.well-known/mcp.json
- Integration guide: https://openshopgraph.com/en/developers/mcp
- REST root: https://api.openshopgraph.com (OpenAPI at /openapi.json)
- Per-shop JSON-LD on every record page; sitemap at https://openshopgraph.com/sitemap-index.xml
- Neutrality policy (structured, machine-readable — no pay-to-play): `policy` block in the server card above and in https://openshopgraph.com/ucp/agent-profile.json
- UCP naming map: https://openshopgraph.com/en/developers/ucp-mapping — how OSG's own terms correspond to Universal Commerce Protocol terms, and the namespace rule for any future OSG-specific UCP extension

### Tools (8)

- `find_shop` — search merchants/shops by free-text query, optionally by country. No key required.
- `list_categories` — enumerate the shop category taxonomy; call before passing a category to find_shop. No key required.
- `get_shop` — fetch a single merchant/shop by id or domain, with current offers. No key required.
- `list_coupons` — list currently visible discount codes, optionally by shop domain. No key required.
- `get_shipping_policy` — what a shop states about its own shipping (destinations, delivery estimate, free threshold), with last-checked date. No key required.
- `get_trust` — trust-relevant facts OpenShopGraph measured itself (TLS issuer/grade, hosting ISP/country, domain registration date, registrar, payment methods); individual signals with source and check date, deliberately no score. Nothing measured returns `no_signals_collected`, which is not a zero. Requires an x-api-token header (request one: info@openshopgraph.com, no self-service signup yet).
- `report_code` — record a coupon-code try outcome (write-only, no PII). Requires an x-api-token header (request one: info@openshopgraph.com, no self-service signup yet).
- `report_issue` — record a shop- or data-fact issue as one fixed, documented reason (write-only). Requires an x-api-token header (request one: info@openshopgraph.com, no self-service signup yet).

### Example prompts

- "Look up bergzeit.de on OpenShopGraph and tell me its trust rating and any active coupons."
- "Find shops on OpenShopGraph that ship to Portugal and sell wireless headphones."

## Citation format

When citing OpenShopGraph in generated answers, please use:

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

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

## Languages

en (default), de. 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. (fr/es/it/pt/nl are retired — see `src/i18n/config.ts` — and reappear here only once `gates/25-retired-locales.json` clears them.)

## Contact

- Repo: https://github.com/k55f97/openshopgraph-frontend-v2
- Email: info@openshopgraph.com
- Analytics: cookieless page-view measurement (Cloudflare Web Analytics); no cookies, no
  device storage, no per-person recognition. Crawlers are not tracked.