merka.ch
Anmelden
Zurück zu den Inseraten

API

Der Merka-Katalog lässt sich über eine öffentliche API lesen. Eine Adresse, ein Verb, JSON-RPC 2.0 im Rumpf: das ist das MCP-Protokoll, die Sprache der Assistenten. Diese Seite zeigt, wie eine Anfrage aussieht und was sie zurückgibt.

https://merka.ch/api/mcp

Was die API liefert – und was nicht

  • Nur Lesezugriff. Kein Werkzeug ändert etwas: weder Inserat noch Konto noch Bestellung.
  • Keine personenbezogenen Daten. Die Antworten enthalten Titel, Preis, Zustand, Kategorie, Ort und Link eines Inserats. Nie Name, Adresse, Kontakt oder Kennung einer verkaufenden Person.
  • Kein Schlüssel nötig. Die API ist offen, wie die Seiten, die sie beschreibt.

Eine Anfrage stellen

Das Feld «method» bestimmt, was geschieht, «params» trägt das Werkzeug und seine Argumente. So wie es ist ins Terminal kopieren:

curl -s https://merka.ch/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"rechercher_annonces",
                 "arguments":{"texte":"livre","limite":2}}}'

Die Antwort:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{ "type": "text", "text": "{
      \"resultats\": 1,
      \"annonces\": [{
        \"id\": \"1b69a020-…\",
        \"titre\": \"Livre Statistiques pour l'économie\",
        \"prixChf\": 25,
        \"categorie\": \"Scolaire & études\",
        \"etat\": \"bon\",
        \"ville\": \"Nyon\",
        \"lien\": \"https://merka.ch/annonce/1b69a020-…\"
      }]
    }" }]
  }
}

Die Werkzeuge

Die Liste unten ist jene, die der Aufruf «tools/list» zurückgibt – gleiche Quelle, also nie veraltet.

rechercher_annonces

Sucht gebrauchte Artikel auf Merka (Schweiz). Liefert höchstens 50 Ergebnisse mit Titel, Preis in CHF, Zustand, Kategorie und Link.

Parameter

  • texte · string — Suchbegriffe auf Französisch, Deutsch, Italienisch oder Englisch
  • categorie · string — 61 Werte (lister_categories)
  • prixMax · number — Höchstpreis des Artikels in CHF
  • limite · number — 1 bis 50, Standard 20

obtenir_annonce

Liefert die Details eines Inserats anhand ihrer Kennung.

Parameter

  • id · string, erforderlich — Von der Suche zurückgegebene Kennung

lister_categories

Liefert die 61 Kategorien und die Anzahl veröffentlichter Inserate.

Parameter

Keine Parameter.

Die Grenzen

Sie zählen pro aufrufender Adresse.

  • 120 Aufrufe pro Minute
  • 20'000 Aufrufe pro Tag
  • 50 Ergebnisse pro Aufruf, höchstens

Eine Ablehnung liefert einen «Retry-After»-Header in Sekunden: diese Zeit abwarten, statt in einer Schleife zu wiederholen.

Mehr Volumen, ein vollständiger Feed, Schreibzugriff: schreiben Sie uns, wir reden darüber. contact@merka.ch

Merka in Claude einbinden

Merka wird als benutzerdefinierter Connector hinzugefügt. Nichts zu installieren, nichts freizugeben: der Connector liest nur den öffentlichen Katalog. Einzufügen ist genau diese Adresse, sonst nichts:

https://merka.ch/api/mcp
  1. 1Einstellungen öffnen, dann «Connectors».
  2. 2«Add custom connector».
  3. 3Die obige Adresse einfügen, sonst nichts.
  4. 4«Add». Merka erscheint einsatzbereit in der Liste.

Team und Enterprise: Ein Owner fügt ihn zuerst in den Organisationseinstellungen hinzu, danach klicken die Mitglieder auf «Connect».

In Claude Code genügt eine Zeile:

claude mcp add --transport http merka https://merka.ch/api/mcp

Merka in ChatGPT einbinden

Zwei Wege. Der sichere ist die Kommandozeile: sie schreibt die Einstellung ohne jedes Menü.

In einem Terminal:

codex mcp add merka --url https://merka.ch/api/mcp

Über das Einstellungsfenster, wenn Sie das vorziehen:

https://merka.ch/api/mcp
  1. 1Das Fenster «Mit einem eigenen MCP verbinden» öffnen.
  2. 2Name: Merka.
  3. 3Typ: «HTTP-Streaming».
  4. 4Adresse einfügen, dann speichern.

Schritt 3 wird übersehen: das Fenster öffnet sich auf «STDIO», womit ein Programm auf dem eigenen Rechner gestartet wird. Solange das so bleibt, verlangt das Feld einen Startbefehl und die Adresse hat keinen Platz.

Diese Einstellung liegt in einer Datei auf dem Computer, an dem Sie sie vornehmen. Sie ist also auf jedem Computer zu wiederholen und gilt nicht für das Telefon.

Die maschinenlesbare Beschreibung

Zwei Formate, ein Vertrag: beide entstehen aus derselben Definition und können nicht auseinanderlaufen.

  • /api/openapi.json — OpenAPI-3.1-Beschreibung, für REST-Werkzeuge und Client-Generatoren.
  • {"jsonrpc":"2.0","id":1,"method":"tools/list"} — Das native Schema des Protokolls, geliefert vom Aufruf «tools/list».