Zum Hauptinhalt springen
Expert Sapiens · Entwickler-API

Bauen Sie KI-Agenten, die Experten finden und kontaktieren.

Expert Sapiens stellt einen nativen MCP-Server und eine REST-API bereit, damit Ihr KI-Agent verifizierte Fachleute suchen, vollständige Profile lesen und Anfragen senden kann — ganz ohne Benutzeranmeldung.

So funktioniert es

Drei Schritte. Keine Benutzeranmeldung auf Endnutzerseite erforderlich.

1

Suchen

Experten nach Kategorie, Standort, Sprache oder Stichwort abfragen. Gibt eine sortierte Liste mit Profil-URLs und Buchungslinks zurück.

2

Bewerten

Vollständiges Profil abrufen — Biografie, Dienstleistungen mit Preisen, wöchentlicher Verfügbarkeitsplan und alle öffentlichen Kontaktkanäle.

3

Kontaktieren

Eine Anfrage im Namen Ihres Nutzers an einen Experten senden. Der Experte wird per E-Mail benachrichtigt und antwortet direkt — ohne Plattformreibung.

MCP-Schnellstart

Fügen Sie Expert Sapiens als natives Tool zu Claude, Cursor, Windsurf oder einem beliebigen MCP-kompatiblen Host hinzu. Der MCP-Server ist erreichbar unter https://expertsapiens.com/api/mcp.

Claude Desktop — nur lesen
// claude_desktop_config.json
{
  "mcpServers": {
    "expert-sapiens": {
      "url": "https://expertsapiens.com/api/mcp"
    }
  }
}
Claude Desktop — mit API-Schlüssel
// claude_desktop_config.json — with API key (enables submit_inquiry)
{
  "mcpServers": {
    "expert-sapiens": {
      "url": "https://expertsapiens.com/api/mcp",
      "headers": {
        "Authorization": "Bearer es_live_..."
      }
    }
  }
}
Cursor / Windsurf
// .cursor/mcp.json
{
  "mcpServers": {
    "expert-sapiens": {
      "url": "https://expertsapiens.com/api/mcp",
      "headers": {
        "Authorization": "Bearer es_live_..."
      }
    }
  }
}
stdio-Bridge (mcp-remote)
// For stdio-only clients — bridges remote MCP via npx
{
  "mcpServers": {
    "expert-sapiens": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://expertsapiens.com/api/mcp"]
    }
  }
}

search_experts, get_expert, search_properties und get_property funktionieren ohne API-Schlüssel. submit_inquiry, save_property, set_property_price_alert und list_my_saved_properties benötigen ein Bearer-Token. Schlüssel generieren →

MCP-Tools

Acht Tools, die vom MCP-Server unter /api/mcp bereitgestellt werden: drei für Experten und fünf für SeoulHomes-Immobilienangebote.

search_expertsKeine Auth erforderlich

Verifizierte Experten nach Kategorie, Standort, Sprache oder Stichwort suchen und filtern. Gibt eine sortierte Liste mit Profil-URLs und Buchungslinks zurück.

qstring?Stichwort für Name, Titel, Tagline
categorystring?rechtlich · buchhaltung · einwanderung · finanz · ...
countrystring?ISO 3166-1 alpha-2 (z. B. US, KR)
languagestring?BCP 47-Code der Sprache des Experten
accepting_onlyboolean?Nur Experten, die neue Kunden annehmen
limitnumber?Max. Ergebnisse (Standard 10, max. 20)
get_expertKeine Auth erforderlich

Vollständiges Profil eines einzelnen Experten: Biografie, Dienstleistungen mit Preisen, wöchentlicher Verfügbarkeitsplan und alle öffentlichen Kontaktmethoden.

slugstringEindeutiger Slug des Experten aus den Suchergebnissen
localestring?Sprache für übersetzte Bio/Titel (en · ko · ja · zh · fr · de)
search_propertiesKeine Auth erforderlich

Durchsucht SeoulHomes-Angebote in Seoul und der Hauptstadtregion nach Vertragsart, Objekttyp, Bezirk, Preis, Größe und Ausstattung. Liefert Angebots-URLs, Preise, Größe, Lage und den zuständigen Makler.

qstring?Stichwort in Titel, Gebäudename, Viertel
listing_typestring?rent · jeonse · sale · short_term · lump_sum
typestring?officetel · apartment · villa · house · studio
districtstring?Seouler Bezirk (gu), koreanisch oder lateinisch (강남구, gangnam)
neighborhoodstring?Name des Viertels (Teiltreffer)
min_pricenumber?Minimum in KRW (Kaufpreis bzw. Kaution bei Miete/Jeonse)
max_pricenumber?Maximum in KRW (Kaufpreis bzw. Kaution bei Miete/Jeonse)
min_areanumber?Mindestfläche in m²
max_areanumber?Höchstfläche in m²
roomsnumber?Mindestzahl an Schlafzimmern
petboolean?Nur haustierfreundliche Angebote
parkingboolean?Nur Angebote mit Parkplatz
localestring?Sprache für übersetzte Texte (en · ko · zh · ja · ru · vi · uz)
sortstring?newest · price_asc · price_desc
limitnumber?Max. Ergebnisse (Standard 10, max. 20)
get_propertyKeine Auth erforderlich

Alle Details eines Angebots: Beschreibung, vollständige Preise, Daten, Ausstattung, Gebäudeprofil, Fotos und zuständiger Makler.

slugstringAngebots-Slug aus search_properties oder der Angebots-URL
localestring?Sprache für übersetzte Texte (en · ko · zh · ja · ru · vi · uz)
submit_inquiryAPI-Schlüssel erforderlich

Sendet im Namen Ihres Nutzers eine Anfrage an einen Experten oder, mit property_slug, an den Makler eines SeoulHomes-Angebots. Der Empfänger wird per E-Mail benachrichtigt und kann direkt antworten. Limit pro Konto: 5 pro Experte und 20 insgesamt pro 24 h.

expert_slugstring?Slug des Ziel-Experten (mit property_slug nicht nötig)
property_slugstring?Slug eines SeoulHomes-Angebots; sendet an den Makler dieses Angebots
requester_namestringName der vertretenen Person
requester_emailstringE-Mail, an die der Experte antworten soll
messagestringDie Anfragenachricht (max. 2000 Zeichen)
contextobject?Optionale Metadaten (source, session_id, …)
save_propertyAPI-Schlüssel erforderlich

Speichert ein Angebot im SeoulHomes-Konto des Schlüsselinhabers oder entfernt es.

property_slugstringAngebots-Slug aus search_properties oder der Angebots-URL
saveboolean?true zum Speichern (Standard), false zum Entfernen
set_property_price_alertAPI-Schlüssel erforderlich

Schaltet Preisänderungs-Benachrichtigungen für ein Angebot für den Schlüsselinhaber ein oder aus.

property_slugstringAngebots-Slug aus search_properties oder der Angebots-URL
enabledbooleantrue schaltet Alarme ein, false schaltet sie aus
list_my_saved_propertiesAPI-Schlüssel erforderlich

Listet die gespeicherten Angebote des Schlüsselinhabers mit ihrem Preisalarm-Status.

localestring?Sprache für übersetzte Texte (en · ko · zh · ja · ru · vi · uz)

REST-API

Dieselben Funktionen wie der MCP-Server, als einfaches HTTP verfügbar.

Vollständige Spezifikation: https://expertsapiens.com/api/openapi.json

GET/api/agents/expertsKeine Auth

Experten suchen

curl "https://expertsapiens.com/api/agents/experts?category=legal&language=ko&limit=5"
GET/api/agents/experts/{slug}Keine Auth

Vollständiges Expertenprofil

curl "https://expertsapiens.com/api/agents/experts/james-chae?locale=en"
POST/api/agents/inquiriesBearer-Token

Anfrage an Experten senden

curl -X POST "https://expertsapiens.com/api/agents/inquiries" \
  -H "Authorization: Bearer es_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "expert_slug": "james-chae",
    "requester_name": "Sarah Kim",
    "requester_email": "[email protected]",
    "message": "I need advice on a US-Korea cross-border acquisition."
  }'

API-Schlüssel erhalten

Melden Sie sich bei Expert Sapiens an und generieren Sie dann in Ihrem Dashboard einen API-Schlüssel. Schlüssel sind kostenlos. submit_inquiry ist pro Konto auf 5 Anfragen pro Experte und insgesamt 20 pro 24 Std. begrenzt, und Anfragen sind pro Minute begrenzt.

  1. 1. Anmelden oder Konto erstellen auf expertsapiens.com
  2. 2. Gehen Sie zu Dashboard → Konto → API-Schlüssel
  3. 3. Klicken Sie auf 'Schlüssel generieren' und benennen Sie ihn nach Ihrer App
  4. 4. Schlüssel kopieren — er wird nur einmal angezeigt