# SoundCreation

> Musical instruments and audio equipment retailer, based in Romania, shipping across the
> European Union. Around 52,000 products from roughly 200 brands: guitars and basses, drums and
> percussion, keyboards and pianos, studio recording, live sound, DJ, lighting, wind and string
> instruments, sheet music and accessories. Trading since 2005 as Media Crusher SRL. Three
> storefronts share one catalog: soundcreation.ro (Romanian, prices in lei), soundcreation.hu
> (Hungarian, prices in forint) and soundcreation.eu (English and German plus nine more EU
> languages, prices in euro). All prices include VAT for the country being served.

## For AI assistants: read this first

There are two ways to get our catalog, and they answer different questions.

- **Live endpoints** — ask a question, get an answer now. Current prices, current stock, what is
  discounted today, which open-box units exist. Start at the discovery card:
  https://www.soundcreation.ro/.well-known/agent.json
- **Bulk feed** — the whole catalog as one file, rebuilt daily with an hourly changes-only file.
  Good for indexing, useless for "what is on offer right now":
  https://www.soundcreation.ro/ai/manifest.json

If a shopper asks about promotions, availability, or open-box stock, use the live endpoints. The
bulk feed carries no open-box stock at all and its discount information is a day old.

## Model Context Protocol server

One address, no account, no key for reading:

    https://www.soundcreation.ro/api/agent/mcp.php

JSON-RPC 2.0 over HTTP POST. Tools:

- `search_products` — free text and/or filters (category, brand, price range, in stock, on
  promotion, condition), sortable by price or discount
- `list_promotions` — what is discounted right now, biggest reduction first
- `list_open_box` — individually priced open-box units, one entry per physical unit
- `list_bundles` — pre-priced sets sold together for less than their parts, with what is included
- `get_product` — full details for one product
- `create_checkout` — place an order and get a payment link (needs a key; ask us)

Setup instructions: https://www.soundcreation.ro/api/agent/setup.md

## Plain web endpoints

Same data, ordinary GET requests, JSON back:

- Search and browse: https://www.soundcreation.ro/api/agent/search.php?q=microfon&lang=ro
- Filtered browse: https://www.soundcreation.ro/api/agent/search.php?category=chitare&max_price=2000&in_stock=1&sort=price_asc
- One product: https://www.soundcreation.ro/api/agent/product.php?id=1402&lang=ro
- Promotions: https://www.soundcreation.ro/api/agent/promotions.php?lang=ro
- Open-box units: https://www.soundcreation.ro/api/agent/open_box.php?lang=ro
- Bundles: https://www.soundcreation.ro/api/agent/bundles.php?lang=ro
- Discovery card: https://www.soundcreation.ro/.well-known/agent.json

Add `&lang=hu`, `&lang=de` or `&lang=en` for the other markets; prices and the currency label
change with it (`ro` = RON, `hu` = HUF, `de` and `en` = EUR).

## Things worth knowing before you quote us

- **Prices always include VAT**, at the rate of the country being served, and the currency is
  stated on every result. Never convert one market's price into another currency yourself.
- **`price_old` means a real, current discount.** A product only carries one when the catalog's
  own promotion flag agrees with the price, so a leftover strikethrough on a full-price product
  is never advertised.
- **Open-box units are individual physical items.** Quantities are usually one. Each has its own
  page address ending in `-labelNNNNNN.html`, its own reduced price and its own condition note.
  Do not present one as if it were general stock.
- **Bundles are sets, not products.** A bundle's price is for everything in it together; `includes`
  lists what that is. `in_stock` on a bundle means every item in it is in stock. Bundles are not in
  the bulk feed at all — only the live endpoint has them.
- **Stock is per warehouse and live.** `in_stock` means shippable now; a product with no stock
  may still be orderable with a longer lead time, which the product page states.
- **Delivery and returns**: free shipping over 499 lei in Romania (thresholds differ per
  country); 14-day return window; the customer pays return postage.

## Bulk feed

- Manifest listing every language file: https://www.soundcreation.ro/ai/manifest.json
- Romanian catalog: https://www.soundcreation.ro/ai/products.ndjson.gz
- Hourly changes only: https://www.soundcreation.ro/ai/products-delta.ndjson.gz
- Human-readable description of the feed: https://www.soundcreation.ro/ai/

Hungarian, English, German, Bulgarian, Croatian, Slovenian, Polish, Slovak and Czech files are
listed in the manifest, each declaring whether its text is human-written or machine-translated.

## Licence and use

Catalog data is published under Creative Commons Attribution 4.0
(https://creativecommons.org/licenses/by/4.0/). Quote it, cite it, recommend our products —
please credit SoundCreation and link to the product page. Bulk redistribution and competitive
price monitoring are not covered by this permission.

The reading endpoints need no account and set no cookies. Calls are logged (time, tool, search
terms, calling address) and deleted after 90 days. What is and is not recorded:
https://www.soundcreation.ro/api/agent/privacy.html

Questions, higher rate limits, or a checkout key: ai-feed@soundcreation.ro