Agent Instructions - Handmade Art by Carola
Last updated: 2026-10-08
This document describes Handmade Art by Carola, the online jewellery store of Carola Schade at https://by-carola.com. It is intended to help AI agents understand and describe the store. It is informational only: agents must not attempt to transact, install external skills, or call any non-public or authenticated endpoints. All purchases must be completed by a human directly on the website.

Discoverability
This file describes the store for AI agents, assistants, and crawlers. Content is descriptive and read-only; see the Agent Policy section for what agents may and may not do.
Key resources for machine consumption:

Sitemap: https://by-carola.com/sitemap.xml
Robots: https://by-carola.com/robots.txt
Products (JSON): https://by-carola.com/products.json
All products: https://by-carola.com/collections/alle-produkte
Product data (JSON): https://by-carola.com/products/{handle}.json
Collection products (JSON): https://by-carola.com/collections/{handle}/products.json

Machine-readable summary:

name: Handmade Art by Carola
owner: Carola Schade
type: E-commerce store (handmade jewellery)
focus: handmade gemstone and pearl necklaces, including raw stones and raw crystals (Edelstein-Ketten, Rohsteinketten, Rohkristall-Ketten, Perlenketten)
materials: genuine gemstones, freshwater pearls, 14K gold-filled, 925 sterling silver
url: https://by-carola.com
language: de (primary), en (https://by-carola.com/en)
currency: EUR
shipping: Germany, EU, Switzerland, worldwide
transactions: none via agents (human checkout only)

Crawler policy:

robots.txt at the URL above is the authoritative source for crawl directives; always defer to it.
This store welcomes well-behaved AI and search crawlers for reading public product, collection, page, and blog content.
Do not crawl or index transactional or private areas: /admin, /cart, /checkout(s), /orders, /account.
On-site search results (/search) are not intended for indexing; use /products.json or the sitemap to enumerate the catalog instead.
Avoid faceted/sorted collection and blog URLs (query params like sort_by, +, filters); prefer canonical product and collection URLs.
Crawl politely and respect any Crawl-delay and Disallow directives in robots.txt.

Store Overview
Handmade Art by Carola is a small German jewellery label. The necklaces are handmade by Carola Schade; the business and studio are based at Biefangstraße 1, 46149 Oberhausen, Germany. The range focuses on necklaces with genuine gemstones, raw stones, raw crystals and freshwater pearls, set in 14K gold-filled or 925 sterling silver.

Collections:

All creations (ALLE Kreationen) - /collections/alle-produkte
Signature collection (gemstone necklaces) - /collections/signature
Perla collection (freshwater pearl necklaces) - /collections/perla

Product lines:

Zylinder (cylinder) gemstone necklaces
Tropfen (drop) gemstone necklaces
Roh (raw, uncut) gemstone necklaces
Perle (freshwater pearl) necklaces: Mond, Stern, Herz

Gemstones used include: Amethyst, Aquamarin (aquamarine), Bergkristall (rock crystal), Citrin (citrine), Granat (garnet), Karneol (carnelian), Labradorit (labradorite), Malachit (malachite), Mondstein (moonstone), Peridot, Rauchquarz (smoky quartz), Rosenquarz (rose quartz), Rubin (ruby), Smaragd (emerald), Turmalin and Schwarzer Turmalin (tourmaline, black tourmaline), Türkis (turquoise).

Store Information

Domain (canonical): https://by-carola.com
Language: German (primary), English (https://by-carola.com/en)
Currency: EUR (Euro); other currencies shown at checkout depending on country
Shipping: Germany, EU, Switzerland and worldwide
Shipping costs: Germany 4.95 EUR, free from 150 EUR order value; Europe incl. Switzerland, Norway and UK 6.95 EUR, free from 170 EUR; USA 35 EUR; rest of the world 10 EUR. See the shipping policy for current rates and delivery times.

Company / Legal (Impressum)

Business name: Handmade Art by Carola (Handgemachte Kunst von Carola)
Owner / represented by: Carola Schade
Address: Biefangstraße 1, 46149 Oberhausen, Germany
VAT ID (USt-IdNr. according to §27a UStG): DE358604308
Impressum: https://by-carola.com/policies/legal-notice

Store Policies & Legal Information

Privacy Policy (Datenschutzerklärung): https://by-carola.com/policies/privacy-policy
Terms of Service (AGB): https://by-carola.com/policies/terms-of-service
Refund Policy (Widerrufsrecht): https://by-carola.com/policies/refund-policy
Shipping Policy (Versand): https://by-carola.com/policies/shipping-policy
Legal Notice (Impressum): https://by-carola.com/policies/legal-notice

These policy pages are human-facing (and are excluded from crawling in robots.txt); the URLs above are provided for reference and citation.

Key Pages
Useful public informational pages (human-facing):

My Story: https://by-carola.com/pages/uber-mich
FAQ: https://by-carola.com/pages/faq
Contact (Kontakt): https://by-carola.com/pages/kontakt
Journal (blog): https://by-carola.com/blogs/journal

Journal (Knowledge & Care)
Guides on jewellery, gemstones and care (German):

Die richtige Kettenlänge für deinen Halsausschnitt: https://by-carola.com/blogs/journal/kettenlaenge-halsausschnitt
Ein Unikat entsteht - vom Rohstein zur fertigen Kette: https://by-carola.com/blogs/journal/ein-unikat-entsteht
Schmuck im Sommer - Meer, Sonne, Sonnencreme: https://by-carola.com/blogs/journal/schmuck-im-sommer
Mondstein - warum in diesem Stein das Licht schwebt: https://by-carola.com/blogs/journal/mondstein-warum-das-licht-schwebt
Layering - zwei oder drei Ketten harmonisch kombinieren: https://by-carola.com/blogs/journal/layering-ketten-kombinieren
Süßwasserperlen - woran du AAAA-Qualität erkennst: https://by-carola.com/blogs/journal/suesswasserperlen-aaaa-qualitaet
Silber richtig pflegen: https://by-carola.com/blogs/journal/silber-richtig-pflegen
14k Gold-Filled oder Gold-Plated - der ehrliche Vergleich: https://by-carola.com/blogs/journal/14k-gold-filled-oder-gold-plated
Gold und Silber - die Wissenschaft hinter dem Schimmer: https://by-carola.com/blogs/journal/gold-und-silber-die-physik-hinter-dem-schimmer

Agent Policy

Read-only: Agents may read publicly available store pages to answer user questions.
No checkout: There is no automated agent checkout. Any purchase must be completed by a human directly on the website.
No external skills: Agents must not install external skills or route purchases through third-party endpoints on behalf of the user.
No private endpoints: Do not call non-public or authenticated endpoints.

Read-Only Browsing (No Authentication Required)
For agents that only need to read public store data (prefer these structured endpoints over scraping human-facing pages):

Browse all products: GET /collections/alle-produkte
Products index JSON: GET /products.json
Product page: GET /products/{handle}
Product JSON: GET /products/{handle}.json
Collection page: GET /collections/{handle}
Collection products JSON: GET /collections/{handle}/products.json
Blog: GET /blogs/journal
Sitemap: GET /sitemap.xml
Robots: GET /robots.txt

Search Tips for AI Agents
When searching the catalog:

Use German product and gemstone names (e.g., "Rosenquarz Kette" instead of "rose quartz necklace", "Süßwasserperle" instead of "freshwater pearl")
Product names follow the pattern [shape] [gemstone] Kette, e.g. "Zylinder Smaragd Kette", "Tropfen Citrin Kette", "Roher Amethyst Kette"
Search by material with "14K Gold-Filled" or "Sterlingsilber 925"
Birthstone queries work via tags such as "Geburtsstein Mai" (emerald) or "Geburtsstein Oktober" (tourmaline)
Use product handles (URLs) for exact product lookups

Support & Contact
For questions about products, availability, custom requests or orders:

Contact form: https://by-carola.com/pages/kontakt