FastSocial Instagram Data

npx add-mcp 'https://data.fastsocial.co/mcp'

Instagram Data MCP sunucusu

AI asistanınızı FastSocial'ın Instagram Data API'sine bağlayın; böylece genel Instagram profillerini, gönderileri, reels'ları, hikayeleri, öne çıkanları, yorumları, hashtag'leri, yerleri ve sesleri arayabilir. Yalnızca okuma amaçlıdır: asla gönderi paylaşmaz, takip etmez, beğenmez veya mesaj göndermez.

Sunucu uzaktadır. Kurulacak veya çalıştırılacak bir şey yoktur: asistanınız

https://data.fastsocial.co/mcp

adresiyle Streamable HTTP üzerinden iletişim kurar. İlk bağlantıda tarayıcınızda bir fastsocial.co sayfası açılır; burada oturum açıp İzin Ver'e tıklarsınız.

Bu depo, eklenti manifestlerini (plugin.json, mcp.json ve Cursor'un okuduğu kopya .cursor-plugin/ içindedir), sunucuyu resmi MCP Registry'de io.github.FastSocialCo/instagram-data-mcp olarak listeleyen server.json dosyasını ve bir LobeHub manifestini barındırır. Makinenizde çalışan hiçbir kod içermez. Sunucunun kodu burada değildir.

Kurulum

Cursor

Eklentiyi cursor.directory'den yükleyin veya sunucuyu .cursor/mcp.json (tek proje) ya da ~/.cursor/mcp.json (tüm projeler) içine ekleyin:

{
  "mcpServers": {
    "instagram-data": {
      "url": "https://data.fastsocial.co/mcp"
    }
  }
}

Ayarlar'ı, ardından MCP'yi açın ve bağlanın. Cursor, FastSocial oturum açma sayfasını açar.

Claude Code

claude mcp add --transport http instagram-data https://data.fastsocial.co/mcp

Ardından Claude Code içinde /mcp komutunu çalıştırın, instagram-data seçeneğini seçin ve oturum açın.

Claude uygulaması (web ve masaüstü)

1. Ayarlar'ı, ardından Bağlayıcılar'ı açın ve özel bir bağlayıcı ekleyin.
2. Sunucu URL'si olarak https://data.fastsocial.co/mcp adresini yapıştırın.
3. OAuth istemci kimliğini ve sırrını boş bırakın.
4. Bağlanın ve açılan FastSocial sayfasında oturum açın.

VS Code ve diğer istemciler

Streamable HTTP üzerinden MCP konuşan her istemci, sunucu URL'si ile bağlanabilir. VS Code'da bunu .vscode/mcp.json dosyasına ekleyin ve Başlat'a basın:

{
  "servers": {
    "instagram-data": {
      "type": "http",
      "url": "https://data.fastsocial.co/mcp"
    }
  }
}

Bu eklenti ne yapar ve hangi verileri gönderir

Eklentinin kendisi

Eklenti, istemcinize sunucunun adresini söyleyen iki JSON dosyasıdır. Kod çalıştırmaz, kurulum betiği yoktur ve hiçbir şey saklamaz. İstemciniz her isteği kendisi yapar, doğrudan https://data.fastsocial.co/mcp adresine HTTPS üzerinden.

İstemcinizin gönderdikleri

• MCP el sıkışması: istemcinizin adı ve sürümü ile konuştuğu protokol sürümü.
• Her araç çağrısı: aracın adı ve argümanları; bunlar sizin sorduğunuz şeylerdir: bir Instagram kullanıcı adı veya kullanıcı kimliği, bir gönderi veya reels bağlantısı, bir hashtag, arama kelimeleri, bir konum, ses veya öne çıkan kimliği ve bir sayfalama imleci. Tam liste aşağıdaki tablodadır.
• Oturum açma belirteciniz veya API anahtarınız, bir istek başlığında. Asla URL'de değil.
• Herhangi bir web isteğinin olağan ayrıntıları, örneğin IP adresiniz ve istemcinizin kullanıcı aracısı.

Başka hiçbir şey gönderilmez. Sunucu dosyalarınızı, düzenleyicinizi veya sohbetinizi asla görmez; yalnızca asistanınızın bir araç çağrısına koyduğu argümanları görür.

Geri dönenler

JSON biçiminde genel Instagram verileri ve meta.credits_remaining. Fotoğraflar ve videolar dosya olarak değil, bağlantı olarak döner. Özel hesaplar private_account hatası döndürür. Instagram hesap sahipleri devre dışı bırakabilir; bundan sonra API, hesapları için 451 opted_out döndürür.

Yalnızca okuma

Her araç okur. Hiçbiri Instagram'da hiçbir şeyi değiştirmez. Bir çağrının değiştirdiği tek şey, ay için kendi kredi bakiyenizdir. Sunucu her aracı readOnlyHint: true ve openWorldHint: true olarak tools/list içinde işaretler. Yazma veya silme araçları yoktur.

Oturum açma

İstemciniz ilk kez bağlandığında, sunucu oturum açma gerektiğini ve nasıl yapılacağını nerede bulacağınızı söyler. İstemciniz daha sonra tarayıcınızda fastsocial.co üzerinde bir sayfa açar. Orada:

1. e-postanızı ve FastSocial'ın size e-postayla gönderdiği kodu girersiniz,
2. hangi uygulamanın istediğini görür ve İzin Ver (veya Reddet) düğmesine tıklarsınız.

Henüz bir planınız yoksa, İzin Ver'e tıkladığınızda sizin için bir Ücretsiz plan oluşturulur. Asistanınıza asla şifre yazmazsınız ve eklenti kimlik bilgilerinizi asla görmez veya saklamaz. İstemciniz aldığı belirteçleri saklar. Erişim belirteci bir saat geçerlidir ve istemciniz, her kullanıldığında değişen ve 30 gün geçerli olan bir yenileme belirteciyle yeniler.

Bağladığınız tüm uygulamaların erişimini kesmek için https://fastsocial.co/cart/api/account adresinde oturum açın ve Yeni anahtar'a basın. Eski anahtara bağlı oturumlar anında çalışmayı durdurur.

İstemci geliştiricileri için: keşif https://data.fastsocial.co/.well-known/oauth-protected-resource/mcp adresinden başlar. Yetkilendirme sunucusu, genel istemciler için PKCE (yalnızca S256) ile OAuth 2.1, dinamik istemci kaydı ve belirteç iptalini destekler.

Bunun yerine API anahtarı kullanma

İstemciniz bir başlık ayarlayabiliyor ancak oturum açamıyorsa, https://fastsocial.co/instagram-api?ref=github adresinden bir anahtar alın ve her istekte X-API-Key: YOUR_KEY (veya Authorization: Bearer YOUR_KEY) olarak gönderin. Claude Code için:

claude mcp add --transport http instagram-data https://data.fastsocial.co/mcp --header "X-API-Key: YOUR_KEY"

Anahtarı, taahhüt ettiğiniz dosyalardan uzak tutun.

Politikalar

• Gizlilik politikası: https://fastsocial.co/privacy
• Şartlar: https://fastsocial.co/terms
• Veri kullanım politikası (yalnızca genel veriler, insanları takip etme veya taciz etme yok, küçüklerle ilgili hiçbir şey yok): https://fastsocial.co/instagram-api/docs?ref=github
• Güvenlik sorunu bildirme: SECURITY.md

28 araç

Her çağrı, aylık ödeneğinizden kredi harcar. Başarısız çağrılar hiçbir şeye mal olmaz. Her araç yalnızca okuma amaçlıdır.

Araç	Ne yapar	Argümanlar	Krediler
instagram_profile	Bir Instagram profili al	username veya user_id	1
instagram_user_id	Instagram kullanıcı adını kullanıcı kimliğine çevir	username veya user_id	1
instagram_username	Instagram kullanıcı kimliğini kullanıcı adına çevir	user_id	2
instagram_check	Bir Instagram kullanıcı adının var olup olmadığını ve genel olup olmadığını kontrol et	username	1
instagram_posts	Son Instagram gönderilerini al	username veya user_id, cursor	1
instagram_reels	Bir hesabın Instagram reels'larını al	username veya user_id, cursor	1
instagram_tagged	Bir hesabın etiketlendiği gönderileri al	username veya user_id, cursor	1
instagram_post	Tek bir Instagram gönderisi veya reels al	url veya shortcode	1
instagram_media	Bir gönderi, reels veya karusel için indirme URL'leri	url veya shortcode	1
instagram_comments	Bir Instagram gönderisindeki yorumları al	url veya shortcode	3
instagram_comment_replies	Bir Instagram yorumuna verilen yanıtları al	url veya shortcode, comment_id, cursor	3
instagram_likers	Bir Instagram gönderisini beğenen hesapları al	url veya shortcode	3
instagram_insights	Instagram etkileşim oranı hesaplayıcı	username veya user_id	2
instagram_followers	Bir hesabın takipçilerini al	username veya user_id, cursor	3
instagram_following	Bir hesabın takip ettiği hesapları al	username veya user_id, cursor	3
instagram_similar	Benzer Instagram hesapları bul	username veya user_id	1
instagram_stories	Instagram hikayelerini anonim olarak görüntüle	username veya user_id	3
instagram_highlights	Instagram hikaye öne çıkanlarını al	username veya user_id	3
instagram_highlight	Bir öne çıkanın içindeki öğeleri al	id	3
instagram_search	Instagram hesaplarında, hashtag'lerde ve yerlerde arama yap	q	1
instagram_hashtag	Bir Instagram hashtag'i için gönderileri al	tag, cursor	1
instagram_place	Bir Instagram konumu al	id	3
instagram_place_posts	Bir Instagram konumunda etiketlenen gönderileri al	id, cursor	1
instagram_audio	Bir Instagram ses parçasını ve onu kullanan reels'ları al	id	1
instagram_audio_search	Instagram müzik ve seslerinde arama yap	q	3
instagram_reels_search	Anahtar kelimeye göre Instagram reels'larında arama yap	q, cursor	3
instagram_top_accounts	En çok takip edilen 2.000 hesabın günlük sıralaması	sort, limit	0
instagram_usage	Bu ay kullandığınız ve kalan kredileriniz	yok	0

Tam referans: https://fastsocial.co/instagram-api/docs?ref=github

Sorabileceğiniz şeyler

• "@nasa ve @spacex'in etkileşim oranını karşılaştır."
• "Bu karuselin her slaytını indir: https://www.instagram.com/p/..."
• "@natgeo'nun güncel hikayelerini göster ve özetle."
• "@humansofny'ye benzer 10 hesap bul."

Yerel sürüm

İstemciniz yalnızca yerel (stdio) sunucuları çalıştırıyorsa, aynı araçlar PyPI'da instagram-data-mcp olarak mevcuttur. Bu eklentinin parçası değildir. Kaynağı FastSocialCo/instagram-data-mcp-python adresindedir.

Bağlantılar

• Instagram Data API: https://fastsocial.co/instagram-api?ref=github
• Dokümanlar: https://fastsocial.co/instagram-api/docs?ref=github
• OpenAPI spesifikasyonu: https://fastsocial.co/instagram-api/openapi.json
• MCP Registry girişi: io.github.FastSocialCo/instagram-data-mcp

Lisans

MIT. Bkz. LICENSE.