# CatalogHub

> CatalogHub is the structured supplier catalogue network for hospitality procurement.
> Food and drink suppliers publish their product data once — including pack sizes,
> units, allergens, and origin — and CatalogHub normalises it and distributes it to
> restaurants, procurement systems, and AI purchasing agents.

CatalogHub is infrastructure, not a marketplace. It does not sell products or hold
stock. It is the structured data layer underneath: one canonical source of supplier
product data, distributed consistently to the systems that consume it.

The problem it addresses: hospitality suppliers distribute catalogues as PDF brochures,
Excel price lists, and email attachments. Every restaurant, wholesaler, and procurement
platform then re-keys the same products by hand, so the same item means different things
in different systems. CatalogHub converts those documents into validated, structured
product records once, and serves them to every downstream system from a single source.

## Who it is for
- Food and drink wholesalers and suppliers distributing catalogues to trade customers.
- Restaurants, pubs, hotels, and restaurant groups buying from multiple suppliers.
- Procurement, inventory, and back-of-house platforms that need clean supplier data.
- AI purchasing agents that need one structured interface instead of per-supplier feeds.

## What it does today
- Ingests supplier catalogues and price lists from PDF, Excel, and CSV, using AI-assisted
  extraction to read unstructured documents into typed product records.
- Normalises products against a shared category taxonomy, so the same item resolves to
  the same category and attributes across suppliers.
- Captures and validates structured attributes: pack size, unit of measure, unit price,
  country of origin, and allergen declarations.
- Records allergen data against products and propagates it into recipes and menu items.
- Publishes managed and private catalogues, including customer-specific negotiated
  contract pricing visible only to the accounts it applies to.
- Supports procurement workflows: baskets, purchase orders, and order submission between
  restaurants and their authorised suppliers.
- Processes supplier invoices and reconciles invoice lines against catalogue products.
- Costs recipes and menu items from live supplier pricing, including margin impact when
  supplier prices change.
- Manages trade relationships, so a supplier controls which customers see which
  catalogue and which pricing.

## Primary pages
- Home: https://cataloghub.hopshq.com/
- For suppliers: https://cataloghub.hopshq.com/suppliers
- For restaurants: https://cataloghub.hopshq.com/restaurants
- For AI agents: https://cataloghub.hopshq.com/agents
- About: https://cataloghub.hopshq.com/about

## Machine-readable resources
- Agent interaction model: https://cataloghub.hopshq.com/agents.txt
- Agent manifest: https://cataloghub.hopshq.com/.well-known/agent.json
- CatalogHub manifest: https://cataloghub.hopshq.com/.well-known/cataloghub-agent.json
- OpenAPI (JSON): https://cataloghub.hopshq.com/openapi.json
- OpenAPI (YAML): https://cataloghub.hopshq.com/openapi.yaml
- MCP descriptor: https://cataloghub.hopshq.com/mcp
- Catalogue product JSON Schema: https://cataloghub.hopshq.com/schemas/catalog-product.schema.json
- Agent skill documentation: https://cataloghub.hopshq.com/agent/skill.md

## Agent API status
The public agent API described in agents.txt and the manifests is a draft. The
capabilities listed there — catalog.search, supplier.discover, price.compare,
basket.create, order.submit, invoice.query, delivery.query — describe the intended
interaction model. Treat them as a published interface contract, not as generally
available endpoints. Catalogue and pricing access is always scoped to an authenticated
workspace and to the trade relationships a supplier has authorised; there is no
anonymous access to supplier pricing.

## Not accurate to say
- That CatalogHub is a marketplace, or that it sells food and drink.
- That supplier prices are publicly queryable. Pricing is per trade relationship.
- That autonomous ordering happens without workspace authorisation.

## Terminology
- Catalogue: a supplier's set of published products, optionally scoped to one customer.
- Managed catalogue: a catalogue a supplier shares with a named trade customer.
- Trade relationship: the authorised link between a supplier and a buying account that
  determines catalogue and pricing visibility.
- Master supplier item: the canonical, deduplicated product record behind supplier
  variants of the same item.

## Contact
See https://cataloghub.hopshq.com/about for how to get in touch.