ExpertLocal als MCP-Server

Verbinden

Endpunkt

https://www.expertlocal.de/api/mcp

Transport

streamable-http

Discovery

https://www.expertlocal.de/.well-known/mcp.json

Protokollversion

2025-06-18

Anmeldung

keine (zwei Datenwerkzeuge brauchen einen Schlüssel, siehe unten)

In Claude Desktop oder einem anderen MCP-Client als Remote-Server mit Streamable HTTP eintragen. Ein direkter Aufruf sieht so aus:

curl -s -X POST https://www.expertlocal.de/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Öffentliche Werkzeuge (11)

Ohne Schlüssel nutzbar, ohne Kosten, ohne Kontingent.

• search_providers

  Sucht Dienstleister und Agenturen auf ExpertLocal nach Leistung und Ort. Das Kernwerkzeug: damit beantwortest du Fragen wie "wer macht SEO in der Naehe von 88339" oder "Webdesign-Agenturen in Wien". Ruf vorher list_services auf, wenn du den Service-Slug nicht sicher kennst. Nur aktive, oeffentlich sichtbare Profile.

• get_provider

  Liefert ein einzelnes Anbieterprofil per Slug, im selben Umfang wie die oeffentliche Profilseite. Nutze es, nachdem search_providers oder compare_providers einen Slug geliefert hat und der Nutzer Details will.

• compare_providers

  Vergleicht 2 bis 5 Anbieter anhand ihrer Slugs in einer flachen Matrix (Rating, Bewertungen, Ort, Branche, Teamgroesse, Gruendungsjahr, Arbeitsweise, verifiziert). Spart das einzelne Abrufen mehrerer Profile.

• list_services

  Listet alle Leistungen, nach denen ExpertLocal Anbieter vermittelt, mit Slug, Titel, Gruppe, bekannten Branchen-Aliasen und Landingpage-URL. Ruf das auf, bevor du search_providers oder get_service_guide benutzt, sonst raetst du den Slug.

• get_service_guide

  Sachinhalt zu einer Leistung: typische Preisspannen, FAQ, Vergleichstabellen (z.B. WordPress vs. Webflow vs. Shopify), Auswahlkriterien und verwandte Leistungen. Nutze das fuer Fragen wie "was kostet Webdesign" oder "worauf muss ich bei einer SEO-Agentur achten". Achte auf das Feld data_quality.

• list_locations

  Liefert die Standort-Hierarchie Land, Region, Stadt mit den gueltigen Slugs und den kanonischen URL-Mustern. Nutze das, damit du keine erfundenen Ortsslugs verlinkst. ExpertLocal deckt Deutschland, Oesterreich, die Schweiz und die Niederlande ab.

• get_local_market

  Marktueberblick fuer eine Leistung in einer Stadt: wie viele aktive Anbieter es im Umkreis gibt, wie viele davon Bewertungen haben, die drei bestbewerteten Profile und die passenden Landingpages. Nutze das fuer "lohnt sich die lokale Suche oder muss ich remote suchen".

• search_guides

  Volltextsuche ueber die Ratgeber von ExpertLocal (Auswahl, Kosten, Zusammenarbeit mit Agenturen und Dienstleistern). Der Einstieg fuer jede inhaltliche Frage. Fuer den vollen Text danach get_guide aufrufen.

• get_guide

  Liefert einen Ratgeber im Volltext, damit du daraus zitieren kannst statt nur zu verlinken. Slug kommt aus search_guides.

• explain_request_process

  Erklaert, wie eine Anfrage ueber ExpertLocal ablaeuft: was abgefragt wird, dass es fuer Auftraggeber kostenlos ist, das Storno-Fenster vor dem Versand und die Einstiegs-URL. Rein erklaerend. Leite den Nutzer auf die Seite, lege niemals selbst eine Anfrage an.

• get_listing_plans

  Die Pakete fuer Anbieter, die sich auf ExpertLocal eintragen wollen: Preise monatlich und jaehrlich sowie Leistungsumfang. Fuer Fragen wie "was kostet ein Eintrag als Agentur".

Datenwerkzeuge mit Schlüssel (2)

Liefern vollständige Adressen und auf bezahlten Stufen E-Mail und Telefon. Sie verlangen einen Data-API-Schlüssel im Header Authorization: Bearer el_live_… und rechnen pro geliefertem Firmeneintrag ab. Ohne Schlüssel antworten sie mit einem Hinweis auf die Preisseite. Kostenlos sind 100 Einträge im Monat, ohne Kontaktdaten.

• search_companies_data

  Paid directory access: providers in a radius around a point, or in a city, postal code or country, sorted, with full address and website. On paid plans the response also carries email and phone. Returns the total match count, so a client can page through it. Coverage is uneven and the response says so: team size and rating exist for roughly a tenth of the records, address and website for the large majority. Requires an expertlocal Data API key, sent by the MCP client as "Authorization: Bearer el_live_...". Without a key this returns 401 and a link to the pricing page. Do not ask the user to paste the key into the chat.

• get_company_data

  Paid single-record lookup by slug, with full address, website and, on paid plans, email and phone. Counts as one record against the quota. Requires an expertlocal Data API key, sent by the MCP client as "Authorization: Bearer el_live_...". Without a key this returns 401 and a link to the pricing page. Do not ask the user to paste the key into the chat.

Beispiel

Anbieter für eine Leistung in einer Stadt suchen. Den Service-Slug vorher mit list_services holen, statt ihn zu raten:

curl -s -X POST https://www.expertlocal.de/api/mcp \
  -H 'content-type: application/json' \
  -d '{
    "jsonrpc": "2.0", "id": 2, "method": "tools/call",
    "params": {
      "name": "search_providers",
      "arguments": { "service": "seo", "city": "Berlin", "limit": 3 }
    }
  }'

REST statt MCP

Dieselben Daten gibt es als REST-Schnittstelle unter /api/v1/: companies für die Suche, companies/{slug} für einen Einzeleintrag, meta für Branchen, Länder und Sortierschlüssel (ohne Schlüssel abrufbar, verbraucht kein Kontingent) und usage für Verbrauch und Guthaben. Details auf der Daten-API-Seite.