Developers
Developers & API
Το δημόσιο, read-only API του tapa.gr για AI agents και developers: OpenAPI 3.1, JSON endpoints, MCP server, σελίδες σε Markdown. Χωρίς κλειδί, χωρίς λειτουργίες εγγραφής.
Τελευταία ενημέρωση: 17 Νοεμβρίου 2026
Τι προσφέρεται
Το tapa.gr διαθέτει δημόσιες λειτουργίες μόνο ανάγνωσης για AI agents και developers: αναζήτηση σελίδων, ανάγνωση σελίδων σε Markdown, τιμές και στοιχεία επικοινωνίας. Δεν χρειάζεται κλειδί ή λογαριασμός. Δεν υπάρχει sandbox, OAuth ή λειτουργία εγγραφής: αιτήματα προσφοράς, audit και επικοινωνίας τα στέλνει ο ίδιος ο χρήστης από τις φόρμες του site, που προστατεύονται με Cloudflare Turnstile.
- OpenAPI 3.1: https://tapa.gr/openapi.json (και /.well-known/openapi.json)
- MCP server (Streamable HTTP): https://tapa.gr/mcp, server card: /mcp/server-card
- Οδηγός για agents: llms.txt, κατάλογος: ai-catalog.json
Endpoints
Όλα απαντούν σε GET με CORS ανοιχτό (Access-Control-Allow-Origin: *). Οι τιμές είναι χωρίς ΦΠΑ (+ ΦΠΑ 24%).
- GET /api/agent/search?q=…&limit=… (searchPages): Αναζήτηση στις δημόσιες σελίδες (ελληνικά ή αγγλικά).
- GET /api/agent/page?path=/about/ (getPageMarkdown): Μία σελίδα του tapa.gr σε Markdown (μόνο σελίδες του tapa.gr).
- GET /api/agent/pricing (getPricing): Πακέτα 399€, 690€, 990€ + ΦΠΑ, ανανεώσεις, έξτρα και πακέτα υποστήριξης 80€, 300€, 400€ + ΦΠΑ.
- GET /api/agent/contact (getContact): Email, τηλέφωνο, WhatsApp, διεύθυνση και η φόρμα αιτήματος προσφοράς.
- GET /agent-index.json (getAgentIndex): Ευρετήριο όλων των δημόσιων σελίδων σε JSON.
- GET /<σελίδα>/index.md (getPageMarkdownFile): Η εκδοχή Markdown κάθε σελίδας (ή αίτημα με Accept: text/markdown).
- GET /pricing.md (getPricingMarkdown): Τιμές σε Markdown, με σύνοψη στα αγγλικά.
- GET /llms.txt (getLlmsTxt): Οδηγός για AI agents.
Παράδειγμα: curl "https://tapa.gr/api/agent/search?q=ιατρούς&limit=3"
MCP server
Ο MCP server στο https://tapa.gr/mcp δέχεται JSON-RPC με POST (εκδόσεις πρωτοκόλλου 2026-07-28, 2025-11-25, 2025-06-18 και 2025-03-26) και έχει τέσσερα εργαλεία μόνο ανάγνωσης: search_pages, get_page_markdown, get_pricing και get_contact. Δεν απαιτεί πιστοποίηση.
Καταχώριση στο επίσημο MCP Registry ως gr.tapa/mcp: registry.modelcontextprotocol.io.
A2A agent
Ο βοηθός του site είναι διαθέσιμος και ως A2A agent στο https://tapa.gr/a2a (JSON-RPC, A2A 1.0 με SendMessage και 0.3 με message/send). Agent card: /.well-known/agent-card.json. Απαντά μόνο σε ερωτήσεις για υπηρεσίες, τιμές και επικοινωνία, με το ίδιο μοντέλο και περιεχόμενο με τη συνομιλία του site. Δεν κρατά ιστορικό (κάθε μήνυμα απαντάται αυτόνομα), δεν υποστηρίζει streaming και δεν εκτελεί ενέργειες: δεν υποβάλλει φόρμες, δεν καταχωρεί αιτήματα και δεν δέχεται πληρωμές. Όριο: 10 μηνύματα ανά λεπτό ανά IP.
Όρια και σφάλματα
- Όριο: 60 αιτήματα ανά λεπτό ανά IP για το API και 60 για τον MCP server. Πάνω από το όριο επιστρέφεται 429 με Retry-After: 60.
- Σφάλματα API σε JSON: {"error":{"code":"…","message":"…"}} με 400, 404, 405 ή 429.
- Το περιεχόμενο είναι κυρίως στα ελληνικά. Ισχύουν οι Όροι Χρήσης.
Επικοινωνία
Ερωτήσεις για το API: hello@tapa.gr ή +30 210 4408777.