DM Champ Docs

LinkedIn-API och AI-assistenter (MCP)

Allt du gör på LinkedIn-sidorna kan även göras från ett skript eller en AI-assistent: dina leads, kön för anslutningsförfrågningar, dina ICP-regler (inklusive vilka länder du accepterar och hur stort ett leads nätverk måste vara), din inkorg, dina AI-agenter och dina inställningar.

Det finns inget nytt att konfigurera. Den använder samma API-nyckel som resten av DM Champ, så om du redan anropar vårt API eller har en AI-assistent ansluten är du redo.

Var du hittar din nyckel

Inställningar → Integrationer → API-nyckel. Om du inte har en ännu, klicka på Generera API-nyckel. De fullständiga stegen finns i API-åtkomst.

Det finns ingen separat LinkedIn-nyckel att skapa, rotera eller återkalla. Nyckeln agerar som du, med samma behörigheter som du har i appen, så behandla den som ett lösenord. Att återkalla den i Inställningar bryter omedelbart anslutningen för alla anslutna skript och assistenter.

Anropa API:et direkt

  • Bas-URL: https://app.sdrpilot.ai/api/v1
  • Rubrik: X-API-Key: YOUR_API_KEY
  • Maskinläsbar beskrivning: https://app.sdrpilot.ai/api/v1/docs/openapi.yaml (finns även som .json)

OpenAPI-dokumentet är offentligt och beskriver varje rutt, så de flesta API-verktyg och kodgeneratorer kan importera det direkt utan en nyckel.

Authorization: Bearer YOUR_API_KEY fungerar också. Vad du inte kan göra är att skicka en felaktig nyckel och hoppas att den går igenom till något annat: när en nyckel väl har presenterats baseras svaret på den nyckeln.

Vad som returneras när något är fel:

Svar Vad det betyder
401 Nyckeln saknas, är felaktigt formaterad eller accepteras inte.
403 Nyckeln är giltig, men det kontot har ingen LinkedIn-arbetsyta eller är ännu inte tillåtet.
429 För många avvisade försök på en minut för den nyckeln. Sakta ner.
502 dmchamp_unreachable Vi kunde inte kontrollera din nyckel just då. Det behandlas aldrig som ett godkännande. Försök igen.

Ansluta en AI-assistent

LinkedIn-verktygen finns på samma MCP-slutpunkt som DM Champ:s, med samma API-nyckel, så en assistent du redan har anslutit hittar dem automatiskt. Om du inte har anslutit någon ännu, följ Anslut AI-assistenter (MCP) och använd slutpunkten som anges där.

Slutpunkten är https://mcp.youraiconnector.com/mcp, autentiserad med X-API-Key-rubriken, precis som beskrivs i Anslut AI-assistenter (MCP).

LinkedIn-verktygen har prefixet linkedin_, så de är lätta att identifiera i din assistents verktygslista och lätta att efterfråga vid namn (“använd LinkedIn-verktygen för att visa mig vad som ligger i kö”). Det finns inga behörigheter per verktyg: ett verktyg kan göra vad du än kan göra i appen.

Exempel 1 — acceptera endast leads från vissa länder

Din ICP-profil innehåller reglerna som leads måste uppfylla. Detta skapar en tillåten lista för Nederländerna och Belgien. Landskoder består av två bokstäver med versaler.

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"]}}'

Två saker att känna till. Brödtexten är den kompletta uppsättningen regler, inte en korrigering: en regel som du utelämnar stängs av. Svaret innehåller också ett impact_on_queue-block som berättar hur många redan köade anslutningsförfrågningar som inte skulle uppfylla de nya reglerna, till exempel {"examined": 389, "would_withdraw": 155}. Att spara regler drar inte tillbaka någonting i sig självt.

I en assistent skulle du helt enkelt säga: “Ställ in min ICP till att endast acceptera Nederländerna och Belgien, och berätta för mig vad det skulle innebära för min kö.”

Exempel 2 — se vad som ligger i kö

Anslutningsförfrågningar som har godkänts men ännu inte skickats:

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

Varje rad innehåller personens namn, rubrik, företag, plats, land, antal anslutningar och följare, samt poäng. Du kan begränsa listan med country, min_score, max_score och source, och bläddra igenom den med limit och cursor. Endast köade och väntande förfrågningar visas här. Förfrågningar som redan har skickats är historik och kan inte ändras.

Exempel 3 — dra tillbaka alla utanför dina länder

Efter att ha ändrat dina regler, kontrollera kön mot dem igen. Utan apply=true är detta en förhandsgranskning och ändrar ingenting:

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

Du får tillbaka information om hur många som granskades, hur många som skulle dras tillbaka, och en uppdelning per regel, såsom country och network_too_small (leadets nätverk var mindre än ditt minimum). Nöjd med resultatet? Kör det igen med ?apply=true så dras dessa förfrågningar tillbaka.

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

Om du hellre vill dra tillbaka en specifik uppsättning, skicka id-numren istället, eller ett filter såsom {"filter":{"status":"queued","country":"NG"}} för att rensa allt som matchar. Skicka id-nummer eller ett filter, inte båda.

Felsökning

  • 401 vid varje anrop — nyckeln saknas eller är felaktig. Kopiera den igen från Inställningar → Integrationer → API-nyckel.
  • 403 trots att nyckeln fungerar på andra ställen — det kontot är inte kopplat till en LinkedIn-arbetsyta, eller så är LinkedIn inte aktiverat för det ännu.
  • 502 dmchamp_unreachable — ett tillfälligt problem vid kontroll av din nyckel. Ingenting släpptes igenom; försök igen.
  • En regel matchar ingenting — landskoder måste vara i formatet med två versala bokstäver (NL, inte Netherlands eller nl), och språkkoder måste vara med gemener.
  • Assistenten visar inga LinkedIn-verktyg — återanslut den så att den laddar om verktygslistan, och kontrollera att du använder samma API-nyckel.

Nästa steg