Lead-API und MCP-Server für B2B-Leadgenerierung

Was die anilead-API kann

Wofür Teams die Schnittstellen nutzen

In drei Schritten zum ersten Abruf

Du brauchst ein anilead-Konto mit ausgefülltem Firmenprofil, den API-Zusatz und Guthaben. Beides buchst du unter Einstellungen, Abrechnung.

1. 1

   Schlüssel erstellen

   In der App unter Einstellungen, Integrationen einen Schlüssel erzeugen. Wähle „Nur lesen“ für Abrufe oder „Lesen und schreiben“, wenn Suchen gestartet werden sollen. Der Schlüssel wird nur einmal angezeigt.

2. 2

   Suche starten

   POST /api/v1/searches mit der Projekt-id und der gewünschten Zahl an Leads senden. Die Antwort enthält die id der Suche.

3. 3

   Leads abrufen

   Sobald die Suche den Status completed hat, liefert GET /api/v1/leads die Leads mit Score und Begründung.

curl -X POST https://anilead.io/api/v1/searches \
  -H "Authorization: Bearer anl_live_..." \
  -H "Content-Type: application/json" \
  -d '{"projectId": "PROJECT_ID", "maxResults": 20}'

curl "https://anilead.io/api/v1/leads?projectId=PROJECT_ID&minScore=70" \
  -H "Authorization: Bearer anl_ro_..."

{
  "leads": [
    {
      "id": "0b7c1f0e-...",
      "score": 86,
      "priority": "high",
      "scoreReason": "Maschinenbauer mit 40 Mitarbeitenden, sucht laut Website ...",
      "company": { "name": "Beispiel GmbH", "website": "https://beispiel.de", "city": "Augsburg" },
      "contact": { "firstName": "Max", "lastName": "Muster", "jobTitle": "Geschäftsführer", "email": "..." }
    }
  ],
  "nextCursor": null
}

REST-API: Endpunkte

Basis-Adresse: https://anilead.io/api/v1. Anmeldung über den Header „Authorization: Bearer“ mit deinem Schlüssel. Alle Antworten sind JSON.

Die vollständige Beschreibung mit allen Feldern und Fehlercodes steht als OpenAPI 3.1 bereit und lässt sich in Postman, Insomnia oder Code-Generatoren laden. /api/v1/openapi.json

MCP-Server: Werkzeuge für KI-Agenten

Adresse: https://anilead.io/api/mcp (Streamable HTTP). Der Server meldet sich mit demselben Schlüssel an wie die REST-API. Mit einem Nur-Lese-Schlüssel sieht der Agent nur die lesenden Werkzeuge.

Agenten verbinden

Der Server funktioniert mit jedem MCP-Client, der einen Authorization-Header mitsenden kann.

claude mcp add --transport http anilead https://anilead.io/api/mcp \
  --header "Authorization: Bearer anl_ro_..."

{
  "mcpServers": {
    "anilead": {
      "url": "https://anilead.io/api/mcp",
      "headers": { "Authorization": "Bearer anl_ro_..." }
    }
  }
}

{
  "mcpServers": {
    "anilead": {
      "command": "npx",
      "args": ["mcp-remote", "https://anilead.io/api/mcp",
               "--header", "Authorization: Bearer anl_ro_..."]
    }
  }
}

Eine Anmeldung per OAuth, wie sie manche Web-Assistenten für eigene Konnektoren verlangen, gibt es derzeit nicht. Nutze dort einen Client mit Header-Unterstützung.

Beispiel-Anweisung

„Wie viel Guthaben habe ich noch? Starte für mein Projekt Maschinenbau Bayern eine Suche nach 20 Leads und zeig mir danach alle Leads mit einem Score über 75, jeweils mit der Begründung.“

Preise

Der API-Zusatz hat einen festen Monatspreis. Die Nutzung rechnen wir nach unseren tatsächlichen Kosten ab, mit einem festen Aufschlag.

Den berechneten Betrag jedes Laufs siehst du im Feld charged der Antwort und in den Einstellungen unter Abrechnung. Alle Preise zuzüglich Umsatzsteuer.

Sicherheit

Limits im Überblick

Rechtlicher Hinweis

Die API liefert Daten aus öffentlichen Quellen, darunter Kontaktdaten geschäftlicher Ansprechpartner. Für die Verwendung gelten dieselben Regeln wie in der Oberfläche: Eine gefundene Telefonnummer oder E-Mail-Adresse ist keine Erlaubnis zur Kontaktaufnahme. Maßgeblich sind die DSGVO und § 7 UWG. Rechtliche Hinweise lesen

Häufige Fragen zu API und MCP