Μετάβαση στο περιεχόμενο

MCP · Για τεχνικούς

Πώς μιλά το AI σου με τον Valoo

Οι λεπτομέρειες για όσους στήνουν ή ελέγχουν τη σύνδεση. Για την εγκατάσταση στο Claude, στο ChatGPT ή στο Claude Code, δες τη σελίδα εγκατάστασης.

Σύνδεση

Διεύθυνση
https://valoo.gr/mcp
Πρωτόκολλο
MCP μέσω Streamable HTTP (POST).
Σύνδεση λογαριασμού
OAuth 2.1: authorization code με PKCE και αυτόματη εγγραφή του client (dynamic client registration). Κάθε χρήστης συνδέεται με τον δικό του δωρεάν λογαριασμό Valoo.
Διάρκεια
Το access token κρατά μία εβδομάδα και ανανεώνεται για έξι μήνες. Ο χρήστης διακόπτει τη σύνδεση όποτε θέλει από τον λογαριασμό του.

Τα εργαλεία

Τι μπορεί να καλέσει το AI σου.

  • market_overview

    Η αγορά φέτος: ταξινομήσεις, η αλλαγή από πέρσι, ο τελευταίος μήνας, κορυφαίες μάρκες και μοντέλα, καύσιμα, περιοχές και αγοραστές.

    Μόνο ανάγνωση
  • market_latest_days

    Οι ταξινομήσεις των τελευταίων ημερών, μέρα με τη μέρα. Ενημερώνεται κάθε πρωί.

    Μόνο ανάγνωση
  • market_report

    Μια χρονιά (2025) ή ένας μήνας (2025-06), σε σύγκριση με έναν χρόνο πριν.

    Μόνο ανάγνωση
  • market_makes

    Όλες οι μάρκες στη σειρά, ή μία μάρκα και τα μοντέλα της, μήνα με τον μήνα.

    Μόνο ανάγνωση
  • market_fuels

    Ανά καύσιμο: ηλεκτρικά, plug-in υβριδικά, υβριδικά, βενζίνη, diesel, υγραέριο και φυσικό αέριο.

    Μόνο ανάγνωση
  • market_regions

    Ανά περιφέρεια και περιφερειακή ενότητα, με τις μάρκες, τα μοντέλα και τα καύσιμά τους.

    Μόνο ανάγνωση
  • find_dealers

    Αναζητά στον κατάλογο επιχειρήσεων αυτοκινήτου με όνομα, περιοχή, μάρκα και υπηρεσία: κάθε σημείο με στοιχεία επικοινωνίας, υπηρεσίες και ωράριο.

    Μόνο ανάγνωση
  • find_car

    Βρίσκει ένα αυτοκίνητο στον κατάλογο του Valoo και τις εκδόσεις του, για την εκτίμηση.

    Μόνο ανάγνωση
  • request_valuation

    Ζητά δωρεάν εκτίμηση: επιστρέφει την τιμή και το εύρος της, και η πλήρης αναφορά πάει στο email του λογαριασμού.

    Κάνει αλλαγή
  • my_businesses

    Οι επιχειρήσεις του λογαριασμού: στοιχεία επικοινωνίας, σημεία και τι μπορεί να αλλάξει.

    Για επιχειρήσειςΜόνο ανάγνωση
  • business_location

    Ένα σημείο όπως είναι: διεύθυνση, επικοινωνία, υπηρεσίες, ωράριο και μάρκες.

    Για επιχειρήσειςΜόνο ανάγνωση
  • update_business

    Αλλάζει το τηλέφωνο, το email ή τον ιστότοπο της επιχείρησης.

    Για επιχειρήσειςΚάνει αλλαγή
  • update_business_location

    Αλλάζει διεύθυνση, επικοινωνία, ωράριο, υπηρεσίες ή μάρκες ενός σημείου.

    Για επιχειρήσειςΚάνει αλλαγή
  • add_business_location

    Προσθέτει νέο σημείο στην επιχείρηση.

    Για επιχειρήσειςΚάνει αλλαγή

Όρια και έλεγχοι

  • 30 κλήσεις το λεπτό ανά λογαριασμό.
  • find_car: 50 αναζητήσεις την ημέρα ανά διεύθυνση email.
  • find_dealers: 50 αναζητήσεις την ημέρα ανά διεύθυνση email, 10 σημεία ανά σελίδα και έως 5 σελίδες.
  • request_valuation: 5 εκτιμήσεις την ημέρα ανά διεύθυνση email, μία τη φορά.
  • Ο Valoo ελέγχει τον λογαριασμό, τα όριά του και τα δικαιώματά του σε κάθε κλήση, στον server. Δεν τα αποφασίζει ποτέ το AI.
  • Τα εργαλεία επιχείρησης εμφανίζονται μόνο σε λογαριασμούς που ο Valoo ενέκρινε για μια επιχείρηση, και αλλάζουν μόνο ό,τι επιτρέπουν τα δικαιώματά τους: τα στοιχεία επικοινωνίας της επιχείρησης ή τη διεύθυνση, την επικοινωνία, το ωράριο, τις υπηρεσίες και τις μάρκες ενός σημείου.
  • Κάθε αλλαγή χρειάζεται την έκδοση (version) που διάβασε το AI: αν κάποιος άλλος άλλαξε την καταχώριση στο μεταξύ, η αλλαγή απορρίπτεται και το AI διαβάζει ξανά.

Τι επιστρέφουν τα εργαλεία

  • Τα εργαλεία της αγοράς και το find_dealers επιστρέφουν JSON: τα στοιχεία ή τα σημεία και την πηγή τους, με την αναφορά «Πηγή: Valoo», την προέλευση των δεδομένων, τη σελίδα στο valoo.gr στα ελληνικά και στα αγγλικά και τους όρους χρήσης.
  • Το request_valuation επιστρέφει την εκτιμώμενη τιμή, το εύρος της και πόσες εκτιμήσεις μένουν για σήμερα. Η πλήρης αναφορά (PDF) πάει στο email του λογαριασμού.
  • Τα λάθη λένε τι πρέπει να διορθωθεί, για παράδειγμα ποιες μάρκες ή εκδόσεις υπάρχουν.

Τα στοιχεία και οι όροι

Τα στοιχεία της αγοράς προέρχονται από τα αρχεία ταξινομήσεων του Υπουργείου Μεταφορών, με επεξεργασία του Valoo. Για να τα αναδημοσιεύσεις χρειάζεται η αναφορά «Πηγή: Valoo» με σύνδεσμο στη σελίδα τους· δεν επιτρέπεται να φτιαχτεί, να αναδημοσιευτεί ή να πουληθεί βάση δεδομένων ή υπηρεσία από αυτά. Όροι χρήσης