OpenCart Greece

Search the OpenCart Greece catalog of OpenCart extensions, themes and services, with prices, options and categories. Read-only, no sign-in.

View on opencartgreece.gr

Hosted MCP Server

npx add-mcp 'https://eshop.opencartgreece.gr/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Επισκόπηση

Δημοσιεύουμε τον κατάλογό μας με extensions, themes και υπηρεσίες για OpenCart σε μορφές που διαβάζουν agents και scripts. Όλα τα endpoints αυτής της σελίδας είναι μόνο για ανάγνωση και κανένα δεν χρειάζεται API key ή λογαριασμό.

  • Ο MCP server στο https://eshop.opencartgreece.gr/mcp αναζητά προϊόντα και επιστρέφει τιμές, κατηγορίες και στοιχεία του καταστήματος.
  • Ο MCP server τεκμηρίωσης στο https://eshop.opencartgreece.gr/mcp/docs αναζητά σε αυτή την τεκμηρίωση, στον τιμοκατάλογο και στις πολιτικές του καταστήματος.
  • Το REST API στο https://eshop.opencartgreece.gr/api/v1 απαντά σε JSON. Το έγγραφο OpenAPI περιγράφει κάθε endpoint.
  • Για γλωσσικά μοντέλα υπάρχουν το llms.txt, το pricing.md, το auth.md και έκδοση Markdown για κάθε σελίδα προϊόντος, κατηγορίας και πληροφοριών.

Οι agents δεν μπορούν να αγοράσουν τίποτα μέσα από αυτά τα endpoints. Για αγορά, ο πελάτης ανοίγει τη σελίδα του προϊόντος, το βάζει στο καλάθι και ολοκληρώνει την παραγγελία.

Γρήγορη εκκίνηση

Αναζήτηση στον κατάλογο:

curl 'https://eshop.opencartgreece.gr/api/v1/products?query=courier&limit=5'

Ένα προϊόν με όλες τις τιμές του:

curl 'https://eshop.opencartgreece.gr/api/v1/products/81'

Κλήση εργαλείου στον MCP server:

curl -X POST 'https://eshop.opencartgreece.gr/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"courier","limit":3}}}'

MCP server

Ο server λειτουργεί στο https://eshop.opencartgreece.gr/mcp μέσω Streamable HTTP. Απαντά σε JSON και δεν κρατά session. Υποστηρίζει τις εκδόσεις πρωτοκόλλου 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05, και το server card του βρίσκεται στο https://eshop.opencartgreece.gr/mcp/server-card.

Για να τον προσθέσετε σε MCP client:

{
  "mcpServers": {
    "opencart-greece": {
      "type": "http",
      "url": "https://eshop.opencartgreece.gr/mcp"
    }
  }
}
ΕργαλείοΤι κάνειΠαράμετροι
search_productsΑναζητά δημοσιευμένα προϊόντα με λέξεις-κλειδιά, κατηγορία ή και τα δύο. Επιστρέφει κάθε προϊόν με τη βασική τιμή και τα URL του.query, category_id, cursor, language και limit έως 50, με προεπιλογή 10
get_productΕπιστρέφει ένα προϊόν με την περιγραφή, όλες τις τιμές, τις επιλογές, τη διαθεσιμότητα και την αξιολόγησή του.product_id, που είναι υποχρεωτικό, και language
list_categoriesΕπιστρέφει τις κατηγορίες πρώτου επιπέδου ή τις υποκατηγορίες του parent_id.parent_id, language
get_store_infoΕπιστρέφει στοιχεία επικοινωνίας, νόμισμα, εμφάνιση ΦΠΑ, γλώσσες, σελίδες πολιτικών και χρήσιμους συνδέσμους.language

Όλα τα εργαλεία είναι μόνο για ανάγνωση και λειτουργούν χωρίς σύνδεση. Κάθε αποτέλεσμα περιέχει τα δεδομένα δύο φορές, ως structuredContent και ως κείμενο JSON. Αν μια κλήση αποτύχει, επιστρέφει isError: true με code, μήνυμα και, όπου βοηθά, μια υπόδειξη. Οι διαθέσιμες γλώσσες είναι el-gr, en-gb.

MCP server τεκμηρίωσης

Ο server τεκμηρίωσης λειτουργεί στο https://eshop.opencartgreece.gr/mcp/docs, και το server card του βρίσκεται στο https://eshop.opencartgreece.gr/mcp/docs/server-card.

  • Το search_docs δέχεται query, limit και language, και επιστρέφει τις σελίδες που ταιριάζουν με ένα απόσπασμα, πρώτα την καλύτερη.
  • Το get_docs_page δέχεται page_id και language, και επιστρέφει μία σελίδα σε Markdown.

Καλύπτει αυτή τη σελίδα, την πιστοποίηση των agents, τον τιμοκατάλογο και τις σελίδες πληροφοριών του καταστήματος. Κάθε σελίδα διαβάζεται επίσης ως resource Markdown με τα resources/list και resources/read. Οι σελίδες επιστρέφονται στα αγγλικά, εκτός αν η κλήση ορίσει language.

REST API v1

Το βασικό URL είναι https://eshop.opencartgreece.gr/api/v1, και κάθε endpoint δέχεται GET και HEAD. Ορίστε το language σε el-gr, en-gb για να επιλέξετε τη γλώσσα του καταλόγου.

EndpointΠαράμετροιΕπιστρέφει
GET /api/v1/productsquery, category_id, cursor, language και limit έως 50, με προεπιλογή 20Σύνοψη προϊόντων στο data, μαζί με pagination
GET /api/v1/products/{product_id}languageΈνα προϊόν στο data, με offers και options
GET /api/v1/categoriesparent_id, με προεπιλογή 0, και languageΚατηγορίες στο data

Το base_price είναι η τιμή καταλόγου πριν από τις υποχρεωτικές επιλογές ή εκδόσεις, γι' αυτό μην το δίνετε ως τιμή σε πελάτη. Δώστε τα offers. Κάθε offer είναι μια διαμόρφωση που ο πελάτης αγοράζει όπως είναι, με τιμή σε EUR. Αν το προϊόν έχει δωρεάν δοκιμαστική έκδοση, αυτή εμφανίζεται δίπλα στις πληρωμένες. Οι προαιρετικές υπηρεσίες, όπως η εγκατάσταση, χρεώνονται χωριστά και δεν εμφανίζονται ποτέ στα offers.

Ορίστε το language σε el-gr, en-gb ή στείλτε header Accept-Language. Χωρίς κανένα από τα δύο, παίρνετε ελληνικά. Το header Content-Language και το meta.language δείχνουν σε ποια γλώσσα είναι η απάντηση. Κάθε προϊόν και κατηγορία δίνει επίσης το URL του σε όλες τις γλώσσες στο alternates.

Οι απαντήσεις δεν ορίζουν cookies. Μια κοινόχρηστη cache μπορεί να κρατήσει μια απάντηση για 5 λεπτά, αν το URL της περιέχει language. Οι απαντήσεις που πήραν τη γλώσσα τους από το Accept-Language είναι ιδιωτικές, γιατί το ίδιο URL μπορεί να επιστρέψει άλλη γλώσσα.

Ένα συντομευμένο παράδειγμα απάντησης:

{
  "data": [
    {
      "product_id": 81,
      "name": "Product name",
      "url": "https://eshop.opencartgreece.gr/product-keyword",
      "markdown_url": "https://eshop.opencartgreece.gr/product-keyword.md",
      "base_price": { "amount": "0.00", "currency": "EUR", "display": "0.00", "tax_included": true },
      "in_stock": true
    }
  ],
  "pagination": { "limit": 20, "next_cursor": "bzoyMA", "has_more": true, "total": 120 }
}

Σελιδοποίηση

Οι λίστες χρησιμοποιούν σελιδοποίηση με cursor, όπως και το εργαλείο search_products. Κάθε απάντηση έχει pagination.next_cursor και pagination.has_more. Για την επόμενη σελίδα, στείλτε πίσω το next_cursor ως cursor. Όταν το has_more είναι false, το next_cursor είναι null και έχετε όλα τα αποτελέσματα. Μην ερμηνεύετε και μην φτιάχνετε δικούς σας cursors.

Σφάλματα

Τα σφάλματα του REST API ακολουθούν το RFC 9457 με application/problem+json. Βασιστείτε στο code, που μένει ίδιο από έκδοση σε έκδοση, και όχι στο κείμενο του μηνύματος. Όταν η απάντηση έχει hint, εξηγεί πώς να διορθώσετε το αίτημα.

{
  "type": "https://eshop.opencartgreece.gr/developers#error-invalid_parameter",
  "title": "Bad Request",
  "status": 400,
  "code": "invalid_parameter",
  "detail": "Parameter limit must be an integer from 1 to 50."
}
ΚωδικόςΚατάσταση HTTPΣημασία
invalid_parameter400Μια παράμετρος λείπει, είναι πολύ μεγάλη ή είναι εκτός ορίων.
invalid_cursor400Ο cursor έχει αλλάξει ή δεν προέρχεται από αυτό το API.
not_found404Δεν υπάρχει endpoint σε αυτή τη διαδρομή.
product_not_found404Δεν υπάρχει δημοσιευμένο προϊόν με αυτό το id.
method_not_allowed405Το API είναι μόνο για ανάγνωση. Χρησιμοποιήστε GET.
rate_limited429Πάρα πολλά αιτήματα. Περιμένετε όσα δευτερόλεπτα γράφει το Retry-After.
internal_error500Κάτι απέτυχε στη δική μας πλευρά. Δοκιμάστε ξανά αργότερα.

Οι MCP servers αναφέρουν τα προβλήματα πρωτοκόλλου ως σφάλματα JSON-RPC, π.χ. -32601 για άγνωστη μέθοδο. Όταν ένα εργαλείο αποτύχει, παίρνετε κανονικό αποτέλεσμα με isError: true.

Όρια αιτημάτων

Κάθε διεύθυνση IP έχει 120 αιτήματα ανά 60 δευτερόλεπτα, συνολικά για το REST API, τους δύο MCP servers και τα αρχεία Markdown. Οι διευθύνσεις IPv6 μετρούν ανά δίκτυο /64. Κάθε απάντηση έχει τα headers RateLimit-Policy και RateLimit, καθώς και τα X-RateLimit-Limit, X-RateLimit-Remaining και X-RateLimit-Reset. Αν ξεπεράσετε το όριο, παίρνετε HTTP 429 και το Retry-After λέει πόσα δευτερόλεπτα να περιμένετε.

Εκδόσεις και κατάργηση

Η έκδοση φαίνεται στη διαδρομή, /api/v1, και στο header API-Version. Η έκδοση 1 μπορεί να αποκτήσει νέα πεδία και endpoints, οπότε αγνοήστε όσα πεδία δεν αναγνωρίζετε. Ό,τι θα έσπαγε έναν client μπαίνει σε νέα διαδρομή, π.χ. /api/v2. Πριν καταργήσουμε μια έκδοση, οι απαντήσεις της στέλνουν headers Deprecation και Sunset για τουλάχιστον έξι μήνες, και αυτή η σελίδα ανακοινώνει την ημερομηνία. Τα εργαλεία MCP λειτουργούν με τον ίδιο τρόπο. Μπορούν να προστεθούν εργαλεία και πεδία, ενώ μια αλλαγή που σπάει τη συμβατότητα παίρνει νέο όνομα εργαλείου.

Πιστοποίηση

Δεν χρειάζεται πιστοποίηση. Το REST API και οι MCP servers είναι δημόσια και μόνο για ανάγνωση, αγνοούν το header Authorization και δεν ξέρουν ποιος καλεί. Ό,τι αφορά συγκεκριμένο πελάτη, όπως το καλάθι, η ολοκλήρωση παραγγελίας, οι παραγγελίες και τα downloads, απαιτεί τον πελάτη συνδεδεμένο στο κατάστημα από browser, μέσω Clerk ή της σύνδεσης του καταστήματος. Το auth.md δείχνει τι υπάρχει και τι όχι.

Markdown και llms.txt

  • Προσθέστε .md στο URL μιας σελίδας προϊόντος, κατηγορίας, κατασκευαστή ή πληροφοριών για να την πάρετε σε Markdown. Για την αρχική σελίδα, χρησιμοποιήστε το https://eshop.opencartgreece.gr/index.md. Κάθε σελίδα δείχνει την έκδοσή της σε Markdown με <link rel="alternate" type="text/markdown">.
  • Μπορείτε επίσης να ζητήσετε Markdown από οποιαδήποτε σελίδα, και από τις σελίδες 404, στέλνοντας Accept: text/markdown.
  • Το llms.txt είναι το ευρετήριο του ιστότοπου. Το llms-full.md περιέχει ολόκληρο τον κατάλογο με περιγραφές, και το pricing.md τις τρέχουσες τιμές.

Αρχεία ανακάλυψης

  • Το /.well-known/ai-catalog.json παραθέτει τα server cards των MCP servers και το API. Το ίδιο αρχείο υπάρχει και στο /.well-known/ard.json.
  • Το /.well-known/mcp/server-card.json είναι το card του κύριου MCP server.
  • Το /.well-known/openapi.json περιγράφει το REST API, και το /.well-known/api-catalog είναι ο κατάλογος RFC 9727 που παραπέμπει σε αυτό.
  • Το /robots.txt ορίζει τους κανόνες για crawlers και για χρήση από AI.

WebMCP στον browser

Όταν ο browser υποστηρίζει WebMCP, οι σελίδες του καταστήματος καταχωρούν εργαλεία με document.modelContext.registerTool() ή, σε παλαιότερες εκδόσεις, με navigator.modelContext. Τα εργαλεία αυτά τρέχουν στο session του επισκέπτη, όσο βρίσκεται στη σελίδα. Μπορούν να κάνουν αναζήτηση, να ανοίξουν το καλάθι ή να οδηγήσουν στην ολοκλήρωση της παραγγελίας.

Όροι χρήσης

Χρησιμοποιήστε το REST API, τους MCP servers και τα αρχεία Markdown για αναζήτηση στον κατάλογο, σύγκριση προϊόντων, απαντήσεις σε ερωτήσεις και παραπομπή πελατών στις σελίδες των προϊόντων. Οι περιγραφές, οι εικόνες και η τεκμηρίωση των προϊόντων ανήκουν στην Custom Services Limited. Μην τις χρησιμοποιείτε για εκπαίδευση μοντέλων AI και μην αναδημοσιεύετε ή αντιγράφετε τον κατάλογο χωρίς τη γραπτή μας άδεια. Τα content signals στο robots.txt λένε το ίδιο: search=yes, ai-input=yes, ai-train=no. Μείνετε εντός των ορίων αιτημάτων και στέλνετε User-Agent που δείχνει ποιος είστε.

Υποστήριξη

{"@context":"https:\/\/schema.org","@type":"Organization","@id":"https:\/\/eshop.opencartgreece.gr\/#organization","name":"OpenCart Greece - Custom Services LTD - OpenCart Development Services","url":"https:\/\/eshop.opencartgreece.gr\/","sameAs":["https:\/\/www.opencartgreece.gr","https:\/\/support.opencartgreece.gr"],"logo":"https:\/\/eshop.opencartgreece.gr\/image\/catalog\/company\/logo-655x223.png"}
{"@context":"https:\/\/schema.org","@type":"Store","@id":"https:\/\/eshop.opencartgreece.gr\/#store","name":"OpenCart Greece - Custom Services LTD - OpenCart Development Services","url":"https:\/\/eshop.opencartgreece.gr\/","parentOrganization":{"@id":"https:\/\/eshop.opencartgreece.gr\/#organization"},"logo":"https:\/\/eshop.opencartgreece.gr\/image\/catalog\/company\/logo-655x223.png","image":"https:\/\/eshop.opencartgreece.gr\/image\/catalog\/company\/logo-655x223.png","hasMerchantReturnPolicy":{"@type":"MerchantReturnPolicy","@id":"https:\/\/eshop.opencartgreece.gr\/#merchant-return-policy","applicableCountry":["AT","BE","BG","HR","CY","CZ","DK","EE","FI","FR","DE","GR","HU","IE","IT","LV","LT","LU","MT","NL","PL","PT","RO","SK","SI","ES","SE"],"returnPolicyCountry":"GR","returnPolicyCategory":"https:\/\/schema.org\/MerchantReturnFiniteReturnWindow","merchantReturnDays":10,"itemCondition":"https:\/\/schema.org\/NewCondition","returnFees":"https:\/\/schema.org\/FreeReturn","refundType":"https:\/\/schema.org\/StoreCreditRefund","merchantReturnLink":"https:\/\/support.opencartgreece.gr\/terms-and-conditions\/"},"hasShippingService":{"@type":"ShippingService","@id":"https:\/\/eshop.opencartgreece.gr\/#merchant-shipping-policy","name":"Free worldwide shipping","fulfillmentType":"https:\/\/schema.org\/FulfillmentTypeDelivery","handlingTime":{"@type":"ServicePeriod","duration":{"@type":"QuantitativeValue","value":0,"unitCode":"DAY"}},"shippingConditions":{"@type":"ShippingConditions","shippingRate":{"@type":"MonetaryAmount","value":0,"currency":"EUR"},"transitTime":{"@type":"ServicePeriod","duration":{"@type":"QuantitativeValue","value":0,"unitCode":"DAY"}}}}}
{"@context":"https:\/\/schema.org","@type":"WebSite","@id":"https:\/\/eshop.opencartgreece.gr\/#website","url":"https:\/\/eshop.opencartgreece.gr\/","name":"OpenCart Greece - Custom Services LTD - OpenCart Development Services","publisher":{"@id":"https:\/\/eshop.opencartgreece.gr\/#store"},"potentialAction":{"@type":"SearchAction","target":"https:\/\/eshop.opencartgreece.gr\/index.php?route=product\/search&search={search_term_string}","query-input":"required name=search_term_string"}}
{"@context":"https:\/\/schema.org","@type":"WebPage","@id":"https:\/\/eshop.opencartgreece.gr\/mcp#webpage","url":"https:\/\/eshop.opencartgreece.gr\/mcp","name":"OpenCart Greece MCP server για AI agents","isPartOf":{"@id":"https:\/\/eshop.opencartgreece.gr\/#website"},"description":"Συνδέστε έναν AI agent με τον κατάλογο του OpenCart Greece μέσω MCP. Μπορεί να βρίσκει extensions για OpenCart και να διαβάζει τις τιμές τους. Χωρίς API key."}