DM Champ Docs

LinkedIn-API und KI-Assistenten (MCP)

Alles, was Sie auf den LinkedIn-Seiten tun können, lässt sich auch über ein Skript oder einen KI-Assistenten erledigen: Ihre Leads, die Warteschlange für Kontaktanfragen, Ihre ICP-Regeln (einschließlich der akzeptierten Länder und der erforderlichen Größe des Netzwerks eines Leads), Ihr Posteingang, Ihre KI-Agenten und Ihre Einstellungen.

Es muss nichts Neues eingerichtet werden. Es wird der gleiche API-Schlüssel wie für den Rest von DM Champ verwendet. Wenn Sie unsere API also bereits aufrufen oder einen KI-Assistenten verbunden haben, sind Sie startklar.

Wo Sie Ihren Schlüssel finden

Einstellungen → Integrationen → API-Schlüssel. Falls Sie noch keinen haben, klicken Sie auf API-Schlüssel generieren. Die vollständigen Schritte finden Sie unter API-Zugriff.

Es gibt keinen separaten LinkedIn-Schlüssel, der erstellt, rotiert oder widerrufen werden muss. Der Schlüssel agiert als Sie selbst mit denselben Berechtigungen, die Sie in der App haben. Behandeln Sie ihn daher wie ein Passwort. Ein Widerruf in den Einstellungen trennt sofort alle verbundenen Skripte und Assistenten.

Direkter Aufruf der API

  • Basis-URL: https://app.sdrpilot.ai/api/v1
  • Header: X-API-Key: YOUR_API_KEY
  • Maschinenlesbare Beschreibung: https://app.sdrpilot.ai/api/v1/docs/openapi.yaml (auch verfügbar als .json)

Das OpenAPI-Dokument ist öffentlich und beschreibt jede Route, sodass die meisten API-Tools und Codegeneratoren es direkt ohne Schlüssel importieren können.

Authorization: Bearer YOUR_API_KEY funktioniert ebenfalls. Was Sie nicht tun können, ist einen falschen Schlüssel zu senden und darauf zu hoffen, dass er auf etwas anderes zurückgreift: Sobald ein Schlüssel präsentiert wird, basiert die Antwort auf diesem Schlüssel.

Was passiert, wenn etwas schiefgeht:

Antwort Bedeutung
401 Der Schlüssel fehlt, ist fehlerhaft oder wird nicht akzeptiert.
403 Der Schlüssel ist gültig, aber das Konto hat keinen LinkedIn-Arbeitsbereich oder ist noch nicht zugelassen.
429 Zu viele abgelehnte Versuche innerhalb einer Minute für diesen Schlüssel. Bitte langsamer vorgehen.
502 dmchamp_unreachable Ihr Schlüssel konnte in diesem Moment nicht überprüft werden. Dies wird niemals als Erfolg gewertet. Bitte versuchen Sie es erneut.

Verbinden eines KI-Assistenten

Die LinkedIn-Tools befinden sich auf demselben MCP-Endpunkt wie die von DM Champ und verwenden denselben API-Schlüssel. Ein Assistent, den Sie bereits verbunden haben, erkennt sie daher automatisch. Falls Sie noch keinen verbunden haben, folgen Sie der Anleitung KI-Assistenten verbinden (MCP) und verwenden Sie den dort aufgeführten Endpunkt.

Der Endpunkt lautet https://mcp.youraiconnector.com/mcp und wird mit dem Header X-API-Key authentifiziert, genau wie unter „KI-Assistenten verbinden (MCP)“ beschrieben.

Die LinkedIn-Tools haben alle das Präfix linkedin_, sodass sie in der Tool-Liste Ihres Assistenten leicht zu erkennen sind und einfach namentlich angefordert werden können („Verwende die LinkedIn-Tools, um mir zu zeigen, was in der Warteschlange steht“). Es gibt keine Berechtigungen pro Tool: Ein Tool kann alles tun, was Sie auch in der App tun können.

Beispiel 1 — Leads nur aus bestimmten Ländern akzeptieren

Ihr ICP-Profil enthält die Regeln, die Leads erfüllen müssen. Dies legt eine Positivliste für die Niederlande und Belgien fest. Ländercodes sind zweistellig und in Großbuchstaben.

curl -X PUT https://app.sdrpilot.ai/api/v1/icp/YOUR_ICP_ID/filters \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countries":{"mode":"allow","codes":["NL","BE"]}}'

Zwei Dinge, die Sie wissen sollten: Der Body ist der vollständige Regelsatz, kein Patch: Eine Regel, die Sie weglassen, wird deaktiviert. Die Antwort enthält einen impact_on_queue-Block, der Ihnen mitteilt, wie viele bereits in der Warteschlange befindliche Verbindungsanfragen die neuen Regeln nicht erfüllen würden, zum Beispiel {"examined": 389, "would_withdraw": 155}. Das Speichern von Regeln zieht von sich aus nichts zurück.

In einem Assistenten würden Sie einfach sagen: „Setze mein ICP so, dass nur die Niederlande und Belgien akzeptiert werden, und sag mir, wie sich das auf meine Warteschlange auswirken würde.“

Beispiel 2 — sehen, was in der Warteschlange steht

Verbindungsanfragen, die genehmigt, aber noch nicht gesendet wurden:

curl -s "https://app.sdrpilot.ai/api/v1/connections/queue?status=queued&limit=100" \
  -H "X-API-Key: YOUR_API_KEY"

Jede Zeile enthält den Namen der Person, die Schlagzeile, das Unternehmen, den Standort, das Land, die Anzahl der Verbindungen und Follower sowie den Score. Sie können die Liste mit country, min_score, max_score und source eingrenzen und mit limit und cursor durchblättern. Hier erscheinen nur Anfragen, die in der Warteschlange stehen oder auf Genehmigung warten. Bereits gesendete Anfragen sind Historie und können nicht mehr geändert werden.

Beispiel 3 — alle Personen außerhalb Ihrer Länder zurückziehen

Überprüfen Sie nach dem Ändern Ihrer Regeln die Warteschlange erneut anhand dieser Regeln. Ohne apply=true ist dies eine Vorschau und ändert nichts:

curl -X POST "https://app.sdrpilot.ai/api/v1/connections/queue/rescreen" \
  -H "X-API-Key: YOUR_API_KEY"

Sie erhalten eine Rückmeldung darüber, wie viele geprüft wurden, wie viele zurückgezogen würden, sowie eine Aufschlüsselung pro Regel, wie z. B. country und network_too_small (das Netzwerk des Leads war kleiner als Ihr Minimum). Zufrieden damit? Führen Sie es erneut mit ?apply=true aus, und diese Anfragen werden zurückgezogen.

curl -X POST "https://app.sdrpilot.ai/api/v1/connections/queue/rescreen?apply=true" \
  -H "X-API-Key: YOUR_API_KEY"

Wenn Sie lieber eine bestimmte Gruppe zurückziehen möchten, posten Sie stattdessen die IDs oder einen Filter wie {"filter":{"status":"queued","country":"NG"}}, um alles zu entfernen, was übereinstimmt. Senden Sie entweder IDs oder einen Filter, nicht beides.

Fehlerbehebung

  • 401 bei jedem Aufruf — der Schlüssel fehlt oder ist falsch. Kopieren Sie ihn erneut unter Einstellungen → Integrationen → API-Schlüssel.
  • 403, obwohl der Schlüssel anderswo funktioniert — dieses Konto ist nicht mit einem LinkedIn-Arbeitsbereich verknüpft oder LinkedIn ist dafür noch nicht aktiviert.
  • 502 dmchamp_unreachable — ein vorübergehendes Problem bei der Überprüfung Ihres Schlüssels. Es wurde nichts durchgelassen; versuchen Sie es erneut.
  • Eine Regel stimmt mit nichts überein — Ländercodes müssen die zweistellige Großbuchstabenform haben (NL, nicht Netherlands oder nl), und Sprachcodes müssen kleingeschrieben sein.
  • Der Assistent zeigt keine LinkedIn-Tools an — verbinden Sie ihn erneut, damit die Tool-Liste neu geladen wird, und stellen Sie sicher, dass Sie denselben API-Schlüssel verwenden.

Nächste Schritte