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.

Ö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, kuralların tamamını içerir, bir yama değildir: dışarıda bıraktığınız bir kural devre dışı bırakılır. Ayrıca yanıt, yeni kurallara uymayacak 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}. Kuralları kaydetmek tek başına hiçbir şeyi geri çekmez.

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, ChatGPT veya Cursor’ı anahtarınızla kurun.
• API Erişimi — bunun kullandığı anahtarı oluşturun veya yenileyin.