LinkedIn API ve Yapay Zeka Asistanları (MCP) #

LinkedIn sayfalarında yaptığınız her şey bir betik veya yapay zeka asistanı aracılığıyla da yapılabilir: potansiyel müşterileriniz, bağlantı isteği kuyruğunuz, ICP kurallarınız (hangi ülkeleri kabul ettiğiniz ve bir potansiyel müşterinin ağının ne kadar büyük olması gerektiği dahil), gelen kutunuz, yapay zeka temsilcileriniz ve ayarlarınız.

Kurulacak yeni bir şey yok. DM Champ'ın geri kalanıyla aynı API anahtarını kullanır, bu nedenle zaten API’mizi çağırıyorsanız veya bağlı bir yapay zeka asistanınız varsa, hazırsınız demektir.

Anahtarınızı nerede bulabilirsiniz #

Ayarlar → Entegrasyonlar → API Anahtarı. Henüz bir anahtarınız yoksa, API anahtarı oluştur’a tıklayın. Tüm adımlar API Erişimi bölümündedir.

Oluşturulacak, yenilenecek veya iptal edilecek ayrı bir LinkedIn anahtarı yoktur. Anahtar, uygulamadaki izinlerinizle aynı izinlere sahip olarak sizin yerinize hareket eder, bu yüzden onu bir parola gibi koruyun. Ayarlar’dan iptal etmek, bağlı tüm betikleri ve asistanları anında devre dışı bırakır.

API’yi doğrudan çağırma #

• Temel URL: https://app.sdrpilot.ai/api/v1
• Üstbilgi: X-API-Key: YOUR_API_KEY
• Makine tarafından okunabilir açıklama: https://app.sdrpilot.ai/api/v1/docs/openapi.yaml (ayrıca .json olarak da mevcuttur)

OpenAPI belgesi herkese açıktır ve her rotayı tanımlar, bu nedenle çoğu API aracı ve kod oluşturucu, bir anahtara ihtiyaç duymadan onu doğrudan içe aktarabilir.

Authorization: Bearer YOUR_API_KEY da çalışır. Yapamayacağınız şey, yanlış bir anahtar gönderip başka bir şeye geçmesini ummaktır: bir anahtar sunulduğunda, yanıt o anahtara dayalı olur.

Bir şeyler yanlış gittiğinde ne döner:

Yapay zeka asistanı bağlama #

LinkedIn araçları, DM Champ'ınkiyle aynı MCP uç noktasında ve aynı API anahtarıyla çalışır, bu nedenle zaten bağladığınız bir asistan bunları otomatik olarak algılar. Henüz bir asistan bağlamadıysanız, Yapay Zeka Asistanlarını Bağlama (MCP) kılavuzunu izleyin ve orada listelenen uç noktayı kullanın.

LinkedIn araçlarının tamamı linkedin_ ön ekine sahiptir, bu sayede asistanınızın araç listesinde kolayca fark edilebilirler ve isimleriyle kolayca çağrılabilirler (“kuyrukta neler olduğunu göstermek için LinkedIn araçlarını kullan”). Araç bazında izinler yoktur: bir araç, uygulamada sizin yapabildiğiniz her şeyi yapabilir.

Müşteri çalışma alanları ve beyaz etiket #

Bir ajans, LinkedIn erişim hizmetini kendi markası altında yeniden sattığında, her müşteri çalışma alanı yukarıdaki hesap genelindeki anahtar yerine kendi API anahtarlarını alır:

• Çalışma alanı başına anahtarlar. Müşteri, anahtarlarını çalışma alanının Ayarlar bölümünde oluşturur. Bir anahtar yalnızca o çalışma alanının verilerine erişebilir; ajansın kendi sayfaları (müşteriler, markalama, faturalandırma) bu anahtara “bulunamadı” yanıtını verir.
• Adresler, o çalışma alanının Ayarlar kartında bulunur. Markalı bir alan adında kart, o alan adındaki API adresini (https://<your brand domain>/api/v1), bir yapay zeka asistanına yapıştırılacak MCP adresini ve yardım belgelerine giden bir bağlantıyı, tamamen ajansın markası altında gösterir.
• Ajansın API erişim anahtarı. LinkedIn erişim hizmetini kendi bağımsız markası olarak yürüten bir ajansın, Müşteriler sayfasında müşteri başına varsayılan olarak açık olan bir API erişimi anahtarı bulunur. Bu kapalı olduğunda, müşterinin anahtarları bir dakika içinde reddedilir ve API kartı Ayarlar bölümünden kaybolur. Tekrar açıldığında aynı anahtarlar geri yüklenir. Duraklatılmış bir müşterinin anahtarları da reddedilir.

Bunun ajans tarafı için bkz. Müşterilerinize LinkedIn Erişim Hizmeti Yeniden Satma.

Örnek 1 — yalnızca belirli ülkelerden gelen adayları kabul et #

ICP profiliniz, adayların geçmesi gereken kuralları barındırır. Bu, Hollanda ve Belçika’dan oluşan bir izin listesi belirler. Ülke kodları iki harfli ve büyük harf olmalıdır.

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

Bilmeniz gereken iki şey var. Gövde, bir yama değil, kuralların tam setidir: dışarıda bıraktığınız bir kural devre dışı bırakılır. Ayrıca yanıt, yeni kuralları karşılamayacak halihazırda kuyruğa alınmış kaç bağlantı isteği olduğunu belirten bir impact_on_queue bloğu içerir, örneğin {"examined": 389, "would_withdraw": 155}. Kaydedildikten sonra, yeni kurallar kuyruğa otomatik olarak uygulanır: bu kuralları karşılamayan bekleyen istekler geri çekilir.

Bir asistana basitçe şunu söyleyebilirsiniz: “ICP’mi yalnızca Hollanda ve Belçika’yı kabul edecek şekilde ayarla ve bunun kuyruğuma ne yapacağını söyle.”

Örnek 2 — kuyrukta neler olduğunu gör #

Onaylanmış ancak henüz gönderilmemiş bağlantı istekleri:

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

Her satır kişinin adını, başlığını, şirketini, konumunu, ülkesini, bağlantı ve takipçi sayılarını ve puanını taşır. Listeyi country, min_score, max_score ve source ile daraltabilir ve limit ile cursor kullanarak sayfalar arasında gezinebilirsiniz. Burada yalnızca kuyruğa alınan ve onay bekleyen istekler görünür. Zaten gönderilmiş olan istekler geçmişte kalmıştır ve değiştirilemezler.

Örnek 3 — ülkelerinizin dışındaki herkesi geri çek #

Kurallarınızı değiştirdikten sonra, kuyruğu onlara göre tekrar kontrol edin. apply=true olmadan bu bir önizlemedir ve hiçbir şeyi değiştirmez:

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

Kaç kişinin incelendiğini, kaçının geri çekileceğini ve kural bazında bir dökümü (örneğin country ve network_too_small (adayın ağı sizin minimumunuzdan daha küçüktü)) alırsınız. Sonuçtan memnun musunuz? ?apply=true ile tekrar çalıştırın, o istekler geri çekilecektir.

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

Belirli bir grubu geri çekmeyi tercih ederseniz, bunun yerine kimlikleri (ids) veya eşleşen her şeyi temizlemek için {"filter":{"status":"queued","country":"NG"}} gibi bir filtre gönderin. Kimlikleri veya bir filtreyi gönderin, ikisini birden değil.

Sorun Giderme #

• Her çağrıda 401 — anahtar eksik veya yanlış. Ayarlar → Entegrasyonlar → API Anahtarı kısmından tekrar kopyalayın.
• Anahtar başka yerlerde çalışmasına rağmen 403 — o hesap bir LinkedIn çalışma alanına bağlı değil veya LinkedIn henüz onun için etkinleştirilmemiş.
• 502 dmchamp_unreachable — anahtarınızı kontrol ederken geçici bir aksaklık. Hiçbir şey işleme alınmadı; tekrar deneyin.
• Bir kural hiçbir şeyle eşleşmiyor — ülke kodları iki harfli büyük harf biçiminde olmalıdır (NL, Netherlands veya nl değil) ve dil kodları küçük harf olmalıdır.
• Asistan hiçbir LinkedIn aracını göstermiyor — araç listesini yeniden yüklemesi için yeniden bağlayın ve aynı API anahtarını kullandığınızdan emin olun.

Sonraki Adımlar #

• Yapay Zeka Asistanlarını Bağla (MCP) — Claude veya Cursor’ı anahtarınızla ayarlayın.
• API Erişimi — bunun kullandığı anahtarı oluşturun veya yenileyin.