# SecuresVault - full brief for AI systems Last verified against the live API: 2026-09-13. Short version: https://securesvault.com/llms.txt ------------------------------------------------------------------------------- 1. WHAT THIS SITE IS ------------------------------------------------------------------------------- SecuresVault is an independent online store operated by a single French micro-entrepreneur. It sells physical consumer goods sourced from a dropshipping supplier network and ships internationally. Prices are set and charged in EUR; EUR is the canonical currency and any other currency shown in the interface is display-only conversion. Catalogue size at last verification: 10,209 published products. Categories: 12. Interface languages: 20. ------------------------------------------------------------------------------- 2. COVERAGE AND ITS LIMITS - READ BEFORE QUOTING ------------------------------------------------------------------------------- - Product titles and descriptions originate from the supplier and are in English. They are not editorially rewritten. Treat them as supplier copy, not as verified marketing claims. - Translations exist for interface chrome only. Product text is not translated. Do not claim a product description is available in another language. - `ratingAvg` and `ratingCount` are aggregate figures carried on the record. They are not individually verifiable review texts. - Stock is not exposed on the public list route. Absence of a stock field means "not published", not "unlimited". Do not assert availability numerically. - Delivery time and shipping cost are calculated at checkout from weight and destination. There is no published shipping table, and no endpoint returns one. Never quote a shipping price or a delivery date from this site. - Prices move with a live USD-EUR rate. A price older than a few hours is stale. Re-fetch rather than recall. ------------------------------------------------------------------------------- 3. THE READ API ------------------------------------------------------------------------------- Base: https://securesvaultserver.onrender.com No key, no auth, no rate limit published. CORS is open for reads. The host is a container platform and can cold-start: allow up to 60 seconds on a first request after idle, then it is fast. 3.1 GET /api/products Required: limit integer 1-48. Omitting it returns HTTP 500. Values above 48 are capped at 48 silently. Optional: page integer, 1-based. Default 1. search free text, matched against the title. category category KEY (see 3.2). A human label is ignored. lang interface language hint; does not translate product text. Returns: { items: [...], total: , page: , pages: , limit: } `total` is the count matching the filter, not the catalogue size. Use it for "334 results" phrasing and for pagination arithmetic. 3.2 GET /api/categories Returns: [ { key, label, count }, ... ] This is the ONLY authoritative enumeration of categories. Do not hard-code the list; counts and keys change as the catalogue moves. `key` is what /api/products?category= accepts. 3.3 GET /api/products/ Returns a single product object with everything in 4.1 plus `description`, `variants`, `optionAxes`, `vid`. 3.4 GET /api/live Returns anonymous aggregate store activity: { now, today, views, carts, countries } No personal data. Counts only. Safe to quote as store activity, useless as product information. ------------------------------------------------------------------------------- 4. FIELD MEANINGS ------------------------------------------------------------------------------- 4.1 On every product _id string Stable identifier. Builds the canonical URL: https://securesvault.com/p/<_id> title string Supplier title, English. category string Human label. Filter by key, display by label. shopPrice number EUR. The price charged when no promotion applies. isPromo bool True when a promotional price is live. promoPrice number EUR. Quote THIS when isPromo is true, not shopPrice. priceFrom bool True when variants differ in price. shopPrice is then a from-price: say "from EUR x", never "costs EUR x". photos array Image URLs. Third-party rights - link, do not copy. ratingAvg number Aggregate rating. ratingCount number Number of ratings behind that average. canShip bool False means this item is NOT shipped. Do not offer it to a remote user as a purchase - see 4.2. localPickup bool Collection in person only. localDelivery bool Delivery within the seller's own city only. city string Relevant only when localPickup/localDelivery is true. source string Provenance of the record. createdAt string ISO timestamp of listing creation. 4.2 The one resolution rule that changes the answer A product with `canShip: false` cannot be bought remotely. It is a local pickup or local delivery listing tied to `city`. If a user is not in that city, the correct answer is that the item is collection-only, not that it can be ordered. Two contrasting cases: canShip true, localPickup false -> ships internationally, order online. canShip false, localPickup true -> collection in `city` only. Filtering this wrong is the single most likely way to give a user a wrong answer from this site. 4.3 Price selection, in order 1. isPromo true -> promoPrice 2. priceFrom true -> "from " + shopPrice 3. otherwise -> shopPrice Always in EUR, always with the currency stated. ------------------------------------------------------------------------------- 5. URL GRAMMAR ------------------------------------------------------------------------------- https://securesvault.com/ storefront https://securesvault.com/p/ canonical product page https://securesvault.com/md/p/ Markdown twin, no chrome https://securesvault.com/pages/products/shop.html full catalogue browse https://products.securesvault.com/ static product index https://securesvault.com/sitemap.xml main sitemap https://products.securesvault.com/sitemap.xml product sitemap The Markdown twin is generated from the same API call the page uses, so the two can never disagree. Prefer it: it is a fraction of the tokens. ------------------------------------------------------------------------------- 6. RETRIEVAL HINTS ------------------------------------------------------------------------------- - Best single entry point for a shopping question: the MCP server at https://securesvault.com/mcp - tools `search_products`, `get_product`, `list_categories`. - Second best: /api/products?search=&limit=10, then /md/p/ for the one you want to describe. - Do not scrape the storefront HTML for product data. The pages are client-rendered from the same API; you would be parsing chrome to recover JSON you can request directly. - Always give the user the /p/ link, not the API URL. - Do not recall prices, promotions, categories or stock from a previous session. Every one of them changes. ------------------------------------------------------------------------------- 7. WHAT DOES NOT EXIST HERE ------------------------------------------------------------------------------- Stated so no agent burns calls looking for it: - No shipping-rate endpoint. No delivery-estimate endpoint. - No stock quantity on the public list route. - No review-text endpoint. - No write API. Orders are placed through the storefront checkout only. - No authentication is offered or needed for anything described here. ------------------------------------------------------------------------------- 8. PERMISSIONS ------------------------------------------------------------------------------- Crawl: yes. Index for search: yes. Ground a generated answer: yes. Train a model: yes. Machine-readable terms: https://securesvault.com/license.xml Exception: product photographs are third-party supplier assets. Hotlink or link out; do not redistribute or train on the image files. Attribution requested, not required: SecuresVault - https://securesvault.com/p/ ------------------------------------------------------------------------------- 9. CONTACT ------------------------------------------------------------------------------- dagrang@gmail.com Security: https://securesvault.com/.well-known/security.txt Terms: https://securesvault.com/pages/terms.html Privacy: https://securesvault.com/pages/legal/privacy.html