MCP Server

Dein KI-Client kann jetzt Kleinanzeigen durchsuchen.

Der Kleinanzeigen Agent MCP Server gibt deinem KI-Client echte Werkzeuge: live suchen, Inseratdetails laden und Verkäufer prüfen. URL eintragen, im Browser anmelden, loslegen. Für Agentensysteme mit eigenem Task-Modell gibt es denselben Datenzugang zusätzlich über A2A 1.0.

MCP Server verbinden A2A ansehen

Eine URL, zehn Werkzeuge
MCP und A2A 1.0
Gleiche Credits wie gewohnt
Mit Claude, Codex & Co.

So funktioniert es

Verbunden in unter einer Minute

Wenn dein KI-Client Online-MCP unterstützt, brauchst du nur die URL und bestätigst den Zugriff einmal im Browser.

Server eintragen

Trage https://api.kleinanzeigen-agent.de/mcp in deinem KI-Client ein und starte den Login im Browser.

Werkzeuge erscheinen

Dein Client findet automatisch alles, was er nutzen kann: Suche, Inseratdetails, Verkäufer, Kategorien und Standorte.

Aufgabe stellen

Du beschreibst, was du wissen willst. Der KI-Client lädt die passenden Daten nach und fasst sie für dich zusammen.

Was du bekommst

Eine zweite Oberfläche für dieselbe Plattform

Der MCP Server gibt KI-Clients Zugriff auf die Live-Funktionen von Kleinanzeigen Agent. Du nutzt dieselben Daten, nur in einer Oberfläche, die dein KI-Client versteht.

Echte Live-Daten

Dein KI-Client sucht direkt in aktuellen Kleinanzeigen-Daten. Keine alte Kopie, kein eigener Datenbestand.

Kosten im Blick

Suchen und Detailabrufe kosten dieselben Credits wie gewohnt. Deinen Verbrauch siehst du im Dashboard.

Fehler kosten nichts

Wenn Angaben fehlen oder eine Live-Abfrage fehlschlägt, wird dafür kein Credit berechnet oder er wird erstattet.

Einloggen statt Key kopieren

Moderne Clients verbinden sich per Login im Browser. Für ältere Setups bleibt dein API-Key weiter nutzbar.

Tools

Zehn Werkzeuge, ein Server

Dein KI-Client findet alle Werkzeuge automatisch. Über A2A stehen dieselben zehn Werkzeuge mit denselben Argumenten zur Verfügung. Jede Anfrage kostet die bekannten Credits, ungültige Angaben kosten nichts.

search_kleinanzeigen

Live-Inserate suchen nach Stichwort, Kategorie, Standort, Umkreis, Preis und Versand.

1 Credit

get_kleinanzeigen_ad

Details zu einem Inserat laden, optional mit Aufrufzahlen.

1 Credit

get_kleinanzeigen_ad_status

Prüfen, ob ein Inserat noch aktiv oder bereits gelöscht ist.

1 Credit

get_kleinanzeigen_seller_profile

Öffentliches Verkäuferprofil mit Name, Badges und Zählern.

1 Credit

get_kleinanzeigen_seller_ads

Weitere Inserate eines Verkäufers durchblättern.

2 Credits

list_kleinanzeigen_categories

Den kompletten Kategoriebaum laden.

1 Credit

get_kleinanzeigen_category_metadata

Felder und Metadaten einer Kategorie ansehen.

1 Credit

get_kleinanzeigen_category_search_metadata

Suchfilter und Attribute einer Kategorie laden.

1 Credit

search_kleinanzeigen_locations

Standorte nach Name, PLZ oder Koordinaten finden.

1 Credit

get_kleinanzeigen_location

Details zu einem Standort laden.

1 Credit

Aufrufzahlen kosten je einen zusätzlichen Credit. Schlägt eine Live-Abfrage bei Kleinanzeigen fehl, wird der Credit automatisch zurückerstattet.

Setup

Verbinden ohne Schlüssel-Kopie

URL eintragen, Login im Browser bestätigen, loslegen. Für Claude Code und Codex gibt es fertige Befehle, für andere Clients eine kurze Beispiel-Konfiguration.

Ältere Clients können weiterhin mit API-Key verbunden werden. Wenn dein Client den Login im Browser unterstützt, musst du deinen API-Key aber nicht mehr lokal eintragen.

Setup-Anleitung lesen

MCP-Configmcp.json

1{
2  "mcpServers": {
3    "kleinanzeigen-agent": {
4      "url": "https://api.kleinanzeigen-agent.de/mcp"
5    }
6  }
7}

Per CLIterminal

1# Claude Code
2claude mcp add --transport http kleinanzeigen-agent \
3  https://api.kleinanzeigen-agent.de/mcp
4claude mcp login kleinanzeigen-agent
5 
6# Codex CLI
7codex mcp add kleinanzeigen-agent \
8  --url https://api.kleinanzeigen-agent.de/mcp
9codex mcp login kleinanzeigen-agent

A2A 1.0

Für Agentensysteme mit eigenem Task-Modell

Neben MCP versteht Kleinanzeigen Agent das offene Agent2Agent-Protokoll. Ein anderes Agentensystem sendet einen strukturierten Auftrag, verfolgt ihn als Task und holt das Ergebnis als Artefakt ab.

Wann A2A passt

Deine Plattform orchestriert mehrere Agenten und erwartet überall dasselbe Task-Modell.
Der aufrufende Agent plant die Schritte selbst und braucht nur einen geprüften Datenschritt.
Aufträge sollen asynchron starten und der Status später abgefragt werden.
Ergebnisse laufen als maschinenlesbares Artefakt weiter, ohne HTML zu scrapen.

Endpoint: https://api.kleinanzeigen-agent.de/a2a
Agent Card: https://kleinanzeigen-agent.de/.well-known/agent-card.json
Protokoll: A2A 1.0, Binding JSON-RPC

Es sind dieselben zehn Werkzeuge wie beim MCP Server, mit denselben Argumenten und denselben Credit-Kosten. Wiederholst du einen Auftrag mit derselben Nachrichten-ID, bekommst du den bereits angelegten Task zurück und zahlst kein zweites Mal.

A2A-Dokumentation lesen

POST /a2asend-message.json

1{
2  "method": "SendMessage",
3  "params": {
4    "message": {
5      "messageId": "client-message-1",
6      "role": "ROLE_USER",
7      "parts": [{
8        "data": {
9          "tool": "search_kleinanzeigen",
10          "arguments": { "q": "Lastenrad" }
11        },
12        "mediaType": "application/json"
13      }]
14    }
15  }
16}

Der Endpoint interpretiert keine frei formulierten Prompts. Tool und Argumente wählt der aufrufende Agent ausdrücklich aus, und es wird dafür kein weiteres Sprachmodell aufgerufen.

MCP oder A2A?

	MCP Server	A2A Endpoint
Gedacht für	KI-Clients in einer Unterhaltung	Agentensysteme mit eigenem Task-Modell
Tool-Auswahl	Der Client entdeckt und wählt selbst	Der aufrufende Agent legt sie fest
Ergebnis	Tool-Antwort im Chatverlauf	Artefakt am Task, per Statusabfrage abholbar
Anmeldung	Login im Browser oder API-Key	API-Key
Transport	MCP über Streamable HTTP	A2A 1.0 über JSON-RPC

Beide Wege greifen auf dieselben geprüften Funktionen zu. A2A ist also keine zweite Datenquelle und hebt weder dein Guthaben noch deine Tarifgrenzen auf.

Wofür MCP sich lohnt

Überall dort, wo Recherche mehrstufig ist und ein Modell unterwegs entscheiden soll, welche Daten es als nächstes braucht.

Deal-Recherche

Der Client sucht Angebote, lädt Details der besten Treffer nach, prüft Verkäufer und liefert dir eine Shortlist mit Preisen und Links.

Marktanalyse

Mehrere Suchen über Kategorien oder Städte hinweg, daraus Preisbereiche und Auffälligkeiten als lesbare Zusammenfassung.

Agenten & Automationen

Agenten entscheiden anhand der Zwischenergebnisse selbst, ob sie weitere Details, Kategorien oder Standorte nachladen.

Preise

Abgerechnet wird wie bei der API

Der MCP Server hat keinen eigenen Tarif. Jede Suche oder Detailabfrage kostet dieselben Credits wie gewohnt. Dein bestehender Plan und dein Guthaben gelten unverändert.

Kein eigenes MCP-Abo, du zahlst nur die genutzten Anfragen
Free-Plan mit täglichem Gratis-Guthaben zum Ausprobieren
Credit-Packs und Volumentarife, wenn du mehr abrufst
Ungültige Anfragen kosten nichts, fehlgeschlagene werden erstattet

Kostenlos starten Alle Pläne ansehen

Credits pro Anfrage

Live-Suche: 1
Inseratdetails / Inseratstatus: 1
Verkäuferprofil: 1
Verkäufer-Inserate: 2
Kategorien, Metadaten, Standorte: je 1
Aufrufzahlen: +1

Eine vollständige Übersicht der Kosten steht in der Dokumentation.

Häufig gestellte Fragen

Wenn du etwas vermisst, schreib uns. Wir nehmen es gerne hier mit auf.

MCP verbindet deinen KI-Client mit Kleinanzeigen Agent. Danach kann er echte Suchen starten, Inseratdetails laden, Verkäufer ansehen und Standorte oder Kategorien prüfen. Du stellst eine Aufgabe, der Client nutzt die passenden Werkzeuge.

Eine URL trennt deinen Client von echten Kleinanzeigen-Daten.

Account erstellen, Server im KI-Client eintragen und den Login im Browser bestätigen. Der Free-Plan reicht zum Loslegen, ganz ohne Kreditkarte.

Dokumentation MCP Server verbinden