Exa Websets MCP-Server

Ein Model Context Protocol (MCP) Server, der die Websets-API von Exa in Claude Desktop, Cursor, Windsurf und andere MCP-kompatible Clients integriert.

Was sind Websets?

Websets sind Sammlungen von Web-Entitäten (Unternehmen, Personen, Forschungsarbeiten), die automatisch entdeckt, verifiziert und mit benutzerdefinierten Daten angereichert werden können. Stellen Sie sie sich als intelligente, sich selbst aktualisierende Tabellen vor, die durch KI-Webrecherche betrieben werden.

Hauptfunktionen:

• 🔍 Automatisierte Suche: Finden Sie Entitäten, die Ihren natürlichsprachlichen Kriterien entsprechen

• 📊 Datenanreicherung: Extrahieren Sie benutzerdefinierte Informationen mithilfe von KI-Agenten

• 🎯 Verifizierung: Die KI validiert, ob Entitäten Ihre Kriterien erfüllen

• 🔗 Webhooks: Echtzeit-Benachrichtigungen bei Aktualisierungen der Sammlung

• 📥 Importe: Bringen Sie Ihre eigenen CSV-Daten in Websets ein, um sie anzureichern oder einzugrenzen

Related MCP server: Exa Websets MCP Server

Verfügbare Tools

Dieser MCP-Server stellt die folgenden Tools bereit:

Webset-Verwaltung

Element-Verwaltung

Suchoperationen

Anreicherungsoperationen

Webhooks

Importe

Ereignisse

Installation

Installation über Smithery

Um Exa Websets automatisch über Smithery zu installieren:

npx -y @smithery/cli install @exa-labs/websets-mcp-server

Voraussetzungen

• Node.js v18 oder höher

• Claude Desktop, Cursor oder ein anderer MCP-kompatibler Client

• Ein Exa-API-Schlüssel von exa.ai

Verwendung von Claude Code (Empfohlen)

Der schnellste Weg, Websets MCP einzurichten:

claude mcp add websets -e EXA_API_KEY=YOUR_API_KEY -- npx -y websets-mcp-server

Ersetzen Sie YOUR_API_KEY durch Ihren Exa-API-Schlüssel.

Verwendung von NPX

# Install globally
npm install -g websets-mcp-server

# Or run directly with npx
npx websets-mcp-server

Konfiguration

Claude Desktop-Konfiguration

1. Entwicklermodus aktivieren

   • Öffnen Sie Claude Desktop

   • Klicken Sie auf das Menü → Entwicklermodus aktivieren

   • Gehen Sie zu Einstellungen → Entwickler → Konfiguration bearbeiten

2. Zur Konfigurationsdatei hinzufügen:

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   Windows: %APPDATA%\Claude\claude_desktop_config.json

   {
     "mcpServers": {
       "websets": {
         "command": "npx",
         "args": [
           "-y",
           "websets-mcp-server"
         ],
         "env": {
           "EXA_API_KEY": "your-api-key-here"
         }
       }
     }
   }

3. Claude Desktop neu starten

   • Beenden Sie Claude Desktop vollständig

   • Starten Sie es erneut

   • Suchen Sie nach dem 🔌-Symbol, um die Verbindung zu überprüfen

Konfiguration für Cursor und Claude Code

Verwenden Sie die HTTP-basierte Konfiguration. Übergeben Sie Ihren Exa-API-Schlüssel als Bearer-Token im Authorization-Header (oder als ?exaApiKey=...-Abfrageparameter als Fallback):

{
  "mcpServers": {
    "websets": {
      "type": "http",
      "url": "https://websetsmcp.exa.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_EXA_API_KEY"
      }
    }
  }
}

Tool-Schema-Referenz

⚠️ Wichtig für KI-Aufrufer: Siehe TOOL_SCHEMAS.md für exakte Parameterformate und Beispiele.

Wichtige Schema-Regeln:

• criteria muss ein Array von Objekten sein: [{description: "..."}] (NICHT ein Array von Strings)

• entity muss ein Objekt sein: {type: "company"} (NICHT ein String)

• options muss ein Array von Objekten sein: [{label: "..."}] (NICHT ein Array von Strings)

Diese Formate gewährleisten Konsistenz über alle Tools hinweg und entsprechen der Websets-API-Spezifikation.

Anwendungsbeispiele

Sobald die Konfiguration abgeschlossen ist, können Sie Claude bitten, mit Websets zu interagieren:

Erstellen eines Websets

Create a webset of AI startups in San Francisco with 20 companies. 
Add enrichments for revenue, employee count, and funding stage.

Auflisten und Anzeigen von Websets

List all my websets and show me the details of the one called "AI Startups"

Verwalten von Elementen

Show me the first 10 items from my "AI Startups" webset with all their enrichment data

Hinzufügen weiterer Elemente

Run another search on my "AI Startups" webset for 20 more companies focused on
enterprise voice agents, appending to the existing items

Erweiterte Anreicherungen

Add an enrichment to my webset that extracts the company's latest product launch 
and the CEO's LinkedIn profile

Beispiel-Workflow

Hier ist ein vollständiger Workflow zum Aufbau einer Unternehmensforschungsdatenbank:

1. Die Sammlung erstellen:

   Create a webset called "SaaS Companies" that searches for 
   "B2B SaaS companies with $10M+ revenue"

2. Anreicherungen hinzufügen:

   Add enrichments to extract: annual recurring revenue, number of customers, 
   primary market segment, and tech stack used

3. Ereignisse abonnieren:

   Create a webhook to https://example.com/hook subscribed to
   webset.search.completed and webset.enrichment.completed

4. Ergebnisse anzeigen:

   Show me all items with their enrichment data, sorted by revenue

Tool-Details

create_webset

Erstellt eine neue Webset-Sammlung mit optionaler automatischer Befüllung und Anreicherungen.

Parameter:

• externalId (optional): Ihre eigene Kennung für das Webset (max. 300 Zeichen)

• searchQuery (optional): Natürlichsprachliche Abfrage zum Finden von Entitäten

• searchCount (optional): Anzahl der zu findenden Entitäten (Standard: 10, Min: 1)

• searchEntity (optional): Entitätstyp für die Suche, z. B. {type: "company"}. Für den Typ "custom" fügen Sie eine description hinzu.

• searchCriteria (optional): Zusätzliche Filterkriterien — [{description: "..."}] (max. 5)

• searchBehavior (optional): "override" (Standard) ersetzt bestehende Elemente, "append" fügt sie hinzu

• searchExclude (optional): Importe/Websets, deren Ergebnisse ausgeschlossen werden sollen — [{source: "webset"|"import", id: "..."}]

• searchScope (optional): Begrenzen Sie die Suche auf einen bestehenden Import oder ein Webset — ermöglicht Hop-Suchen mit einer relationship

• searchRecall (optional): Ob Recall-Metriken für die Suche berechnet werden sollen

• searchMaxPeoplePerCompany (optional): Weiches Limit für Personen pro Arbeitgeber bei Personensuchen

• searchMetadata (optional): Schlüssel-Wert-Metadaten, die mit der Suche verknüpft werden sollen

• enrichments (optional): Datenanreicherungen, die automatisch für jedes Element extrahiert werden sollen

• metadata (optional): Schlüssel-Wert-Metadaten, die mit dem Webset verknüpft werden sollen

• excludes (optional): Globale Ausschlüsse — Quellen, deren Ergebnisse bei allen Operationen auf diesem Webset weggelassen werden

Hinweis: Es gibt keinen name- oder description-Parameter auf oberster Ebene für das Webset selbst. Verwenden Sie update_webset mit title nach der Erstellung oder metadata, um beliebige Schlüssel-Wert-Paare anzuhängen.

Beispiel:

{
  "externalId": "tech-unicorns-2024",
  "searchQuery": "Technology companies valued over $1 billion",
  "searchCount": 50,
  "searchEntity": {"type": "company"},
  "searchCriteria": [
    {"description": "Valued at over $1 billion"},
    {"description": "Technology sector"}
  ],
  "enrichments": [
    {
      "description": "Current company valuation in USD",
      "format": "number"
    },
    {
      "description": "Names of company founders",
      "format": "text"
    },
    {
      "description": "Company stage",
      "format": "options",
      "options": [
        {"label": "Series A"},
        {"label": "Series B"},
        {"label": "Series C+"},
        {"label": "Public"}
      ]
    }
  ]
}

create_enrichment

Fügt eine neue Datenanreicherung hinzu, um benutzerdefinierte Informationen aus jedem Webset-Element zu extrahieren.

Parameter:

• websetId: Die ID des Websets

• description: Detaillierte Beschreibung dessen, was extrahiert werden soll

• format (optional): Eines von "text", "date", "number", "options", "email", "phone", "url" — wird automatisch ausgewählt, falls weggelassen

• options (optional): Wenn format "options" ist, die Auswahlmöglichkeiten, aus denen der Anreicherungsagent wählt — [{label: "..."}]

• metadata (optional): Schlüssel-Wert-Metadaten, die mit dieser Anreicherung verknüpft werden sollen

Beispiel:

{
  "websetId": "webset_abc123",
  "description": "Total number of full-time employees as of the most recent data",
  "format": "number"
}

Monitore (geplante Aktualisierung/Suche) werden von der zugrunde liegenden Websets-API bereitgestellt, sind aber derzeit nicht als MCP-Tools in diesem Server verfügbar. Konfigurieren Sie Monitore direkt über die Websets-API oder websets.exa.ai.

API-Endpunkte

Der Server verbindet sich mit der Websets-API von Exa unter https://api.exa.ai/websets/v0.

Vollständige API-Dokumentation: docs.exa.ai/reference/websets

Erweiterte Konfiguration

Nur bestimmte Tools aktivieren

Um nur bestimmte Tools zu aktivieren, verwenden Sie die enabledTools-Konfiguration:

{
  "mcpServers": {
    "websets": {
      "command": "npx",
      "args": [
        "-y",
        "websets-mcp-server",
        "--tools=create_webset,list_websets,list_webset_items"
      ],
      "env": {
        "EXA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Debug-Modus

Aktivieren Sie das Debug-Logging, um Probleme zu beheben:

{
  "mcpServers": {
    "websets": {
      "command": "npx",
      "args": [
        "-y",
        "websets-mcp-server",
        "--debug"
      ],
      "env": {
        "EXA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Fehlerbehebung

Verbindungsprobleme

1. Überprüfen Sie, ob Ihr API-Schlüssel gültig ist

2. Stellen Sie sicher, dass sich keine Leerzeichen oder Anführungszeichen um den API-Schlüssel befinden

3. Starten Sie Ihren MCP-Client vollständig neu (nicht nur das Fenster schließen)

4. Überprüfen Sie die MCP-Protokolle auf Fehlermeldungen

API-Ratenbegrenzungen

Die Websets-API hat die folgenden Limits:

• Überprüfen Sie Ihre Plan-Limits unter exa.ai/dashboard

• Verwenden Sie Paginierung für große Websets

• Überwachen Sie die API-Nutzung in Ihrem Dashboard

Häufige Fehler

• 401 Unauthorized: Ungültiger oder fehlender API-Schlüssel

• 404 Not Found: Webset-ID existiert nicht oder wurde gelöscht

• 422 Unprocessable: Ungültiges Abfrage- oder Kriterienformat

• 429 Rate Limited: Zu viele Anfragen, warten und erneut versuchen

Ressourcen

• Exa Websets-Dokumentation

• Exa-Dashboard

• MCP-Protokollspezifikation

• Exa-API-Schlüssel erhalten

Entwicklung

Aus dem Quellcode bauen

git clone https://github.com/exa-labs/websets-mcp-server.git
cd websets-mcp-server
npm install
npm run build

Projektstruktur

websets-mcp-server/
├── src/
│   ├── index.ts              # Main server setup
│   ├── types.ts              # TypeScript type definitions
│   ├── tools/                # MCP tool implementations
│   │   ├── config.ts         # API configuration
│   │   ├── createWebset.ts
│   │   ├── listWebsets.ts
│   │   ├── getWebset.ts
│   │   ├── updateWebset.ts
│   │   ├── deleteWebset.ts
│   │   ├── listItems.ts
│   │   ├── createEnrichment.ts
│   │   ├── createSearch.ts
│   │   ├── createWebhook.ts
│   │   ├── createImport.ts
│   │   └── ...
│   └── utils/
│       ├── api.ts            # Shared API client and error handling
│       └── logger.ts         # Logging utilities
├── package.json
└── tsconfig.json

Lizenz

MIT

Mitwirken

Beiträge sind willkommen! Bitte öffnen Sie ein Issue oder einen PR unter github.com/exa-labs/websets-mcp-server.

Support

• Dokumentation: docs.exa.ai

• Discord: Treten Sie der Exa-Community bei

• E-Mail: support@exa.ai