Eine Frage, eine Antwort, auch für Agenten

Der eine Aufruf, der zählt

find_best_price mit einer Anfrage und dem Land des Käufers liefert die ganze Karte: Urteil, bestes Angebot mit Gesamtpreis und Prüfzeit, Alternativen, Verlauf, Offenlegung.

{"method":"tools/call","params":{"name":"find_best_price",
 "arguments":{"query":"Apple iPhone 17 256 GB","deliver_to_country":"CZ","locale":"cs"}}}

{"verdict":"buy_now",
 "headline":"Kupte teď v obchodě Datart za 26 069 Kč celkem.",
 "best":{"shop":{"name":"Datart","trust":"verified","rating":0.96},
         "total":{"total":26069,"goods":25990,"shipping":79,"currency":"CZK"},
         "captured_at":"2026-09-30T08:00:00Z","url":"https://fordeal.ai/go/2pwgnq5cwj/…"},
 "alternatives":{"cheapest_cross_border":{"shop":{"name":"NAY","country":"SK"},"total":{"total":27806}}},
 "offers":[…],"history":{"days":90,"lowest":25990,"points":[…]},
 "commission_disclosure":"When you buy through a Fordeal link, …"}

Tools

find_best_price

Text, Modell, EAN oder eine Produkt-URL plus deliver_to_country. Liefert die Karte. Schick den Käufer zu best.url und nenne ihm den Gesamtpreis und die Prüfzeit.

price_history

Täglicher Tiefstpreis für bis zu 365 Tage plus jedes aktuelle Angebot. Damit sagst du, ob heute ein Tief ist.

daily_deals

Größte Preisrückgänge der letzten 24 Stunden bei bewerteten Shops, je Land und Kategorie.

Regeln, denen jede Antwort folgt

• Sortiert wird nur nach Gesamtpreis (Ware + Versand ins Land, ČNB-Tageskurs) und Shop-Vertrauen. Keine bezahlte Platzierung.
• Ein Shop auf der ČOI- oder SOI-Risikoliste wird nie gezeigt. Ein unbewerteter Shop ist nie `best`.
• Ein Preis, der älter als 36 Stunden ist, oder ein Angebot mit unbekanntem Versand ist nie `best`; jedes Angebot trägt captured_at und blockers.
• Auslandsangebote tragen cross_border: EU-Gewährleistung, Rückgabe, Support-Sprachen.
• commission_disclosure ist Teil jeder Antwort und muss dem Käufer gezeigt werden.

REST

Dieselben drei Tools über HTTP, in der OpenAPI-Datei dokumentiert. Ergebnisse werden gespeichert und sind unter /api/v1/deals/results/{slug} teilbar.

GET https://fordeal.ai/api/v1/deals/best-price?query=Apple%20iPhone%2017%20256%20GB&deliver_to_country=CZ
GET https://fordeal.ai/api/v1/deals/history/apple-iphone-17-256-gb?days=365
GET https://fordeal.ai/api/v1/deals/daily?country=CZ&category=televize

Verbinden

MCP-Endpunkt über Streamable HTTP; füge ihn in Claude, ChatGPT, Cursor oder jeden MCP-Client ein.

{
  "mcpServers": {
    "fordeal": { "type": "http", "url": "https://fordeal.ai/mcp" }
  }
}

• https://fordeal.ai/mcp MCP-Endpunkt
• https://fordeal.ai/api/openapi.json OpenAPI 3.1
• https://fordeal.ai/llms.txt llms.txt
• https://fordeal.ai/.well-known/mcp.json MCP-Manifest