3.000'den fazla önceden oluşturulmuş bulut aracı olan Actor'ları kullanarak web siteleri, e-ticaret platformları, sosyal medya, arama motorları, haritalar ve daha birçok kaynaktan veri çıkartın.
Apify Model Context Protocol (MCP) sunucusu mcp.apify.com adresinde, yapay zeka aracılarınızın sosyal medya, arama motorları, haritalar, e-ticaret siteleri ve diğer herhangi bir web sitesinden Apify Store adresinde bulunan binlerce hazır scraper, crawler ve otomasyon aracını kullanarak veri çıkarmasını sağlar. OAuth destekler ve Claude.ai veya Visual Studio Code gibi istemcilerden yalnızca URL'yi kullanarak bağlanmanıza izin verir.
🚀 Barındırılan Apify MCP Server'ı kullanın!
En iyi deneyim için yapay zeka asistanınızı barındırılan sunucumuz https://mcp.apify.com adresine bağlayın. Barındırılan sunucu, yapılandırılmış Actor sonuçları için çıktı şeması çıkarımı dahil olmak üzere en son özellikleri destekler; bu özellikler yerel stdio aracılığıyla çalıştırıldığında mevcut değildir.
💰 Sunucu ayrıca x402 ve Skyfire aracılığıyla ajanlar için ödemeler destekler ve yapay zeka aracılarının API token'ı olmadan Actor çalıştırmaları için ödeme yapmasını sağlar.
Apify MCP Server, Claude Code, Claude.ai, Cursor, VS Code ve Model Context Protocol'e uygun herhangi bir istemciyle uyumludur.
Daha fazla ayrıntı için MCP clients bölümüne bakın veya MCP yapılandırma sayfasını ziyaret edin.
Apify MCP Server, bir yapay zeka asistanının belirli bir görevi gerçekleştirmek için herhangi bir Apify Actor aracını kullanmasına izin verir.
Örneğin:
Birden fazla sayfa/profilden Facebook yazılarından veri çıkarmak için Facebook Posts Scraper kullanabilir.
Instagram yazılarını, profillerini, mekanlarını, fotoğraflarını ve yorumlarını kazımak için Instagram Scraper kullanabilir.
Web'de arama yapmak, ilk N URL'yi kazımak ve içeriğini döndürmek için RAG Web Browser kullanabilir.
Video eğitimi: 8.000+ Apify Actors ve Agents'ı Claude ile Entegre Edin
🚀 Hızlı Başlangıç
Apify MCP Server'ı iki şekilde kullanabilirsiniz:
HTTPS Endpoint (mcp.apify.com): MCP istemcinizden OAuth veya isteklerinize Authorization: Bearer <APIFY_TOKEN> başlığını dahil ederek bağlanın. Bu, çoğu kullanım durumu için önerilen yöntemdir. OAuth'u desteklediğinden Claude.ai veya Visual Studio Code gibi istemcilerden yalnızca URL'yi kullanarak bağlanabilirsiniz: https://mcp.apify.com.
https://mcp.apify.com streamable transport
Standart Girdi/Çıktı (stdio): Yerel entegrasyonlar ve Claude for Desktop istemcisi gibi komut satırı araçları için idealdir.
MCP istemcisi sunucu komutunu npx @apify/actors-mcp-server olarak ayarlayın ve APIFY_TOKEN ortam değişkenini Apify API token'ınıza ayarlayın.
Daha fazla seçenek için npx @apify/actors-mcp-server --help komutuna bakın.
MCP sunucusunu ayarlama hakkında ayrıntılı talimatları Apify belgeleri adresinde bulabilirsiniz.
⚠️ SSE transport kullanımdan kaldırılması (1 Nisan 2026)
1 Nisan 2026 tarihinden önce MCP istemci yapılandırmanızı güncelleyin.
Apify MCP Server, resmi MCP belirtimi uyarınca Server-Sent Events (SSE) transportu Streamable HTTP'nin yerine bırakmaktadır.
Seçtiğiniz istemci için geçerli bir endpoint ile kurulumu güncellemek üzere mcp.apify.com adresine gidin.
🤖 MCP istemcileri
Apify MCP Server, Model Context Protocol protokolüne uyan herhangi bir MCP istemciyle uyumludur, ancak dinamik araç keşfi ve diğer özelliklerin destek seviyesi istemciler arasında değişebilir.
actors araç kategorisi istendiğinde, sunucu istemcinin yeteneklerine dayalı olarak en uygun Actor ile ilgili araçları akıllıca seçer:
Dinamik araç desteğine sahip istemciler (ör. Claude.ai web, VS Code Genie): Sunucu, call-actor yerine add-actor aracını sağlar. Bu, kullanıcıların konuşmaları sırasında dinamik olarak yeni Actors'ları araç olarak keşfetmesine ve eklemesine olanak tanıyan daha iyi bir kullanıcı deneyimine izin verir.
Sınırlı dinamik araç desteğine sahip istemciler (ör. Claude Desktop): Sunucu, diğer Actor kategorisi araçlarıyla birlikte standart call-actor aracını sağlar ve uyumluluğu sağlarken işlevselliği korur.
🪄 Apify MCP'yi hemen deneyin
Apify MCP'yi herhangi bir kurulum olmadan denemek ister misiniz?
Bu etkileşimli, sohbet benzeri arayüz, Apify MCP'nin yeteneklerini herhangi bir yerel kurulum olmadan keşfetmenin kolay bir yolunu sağlar.
Apify hesabınızla oturum açın ve web scraping, veri çıkarma ve otomasyon araçlarıyla deney yapmaya başlayın!
Veya tek tıklamayla kurulum için MCP paket dosyasını (eski adıyla Anthropic Desktop extension dosyası veya DXT olarak bilinir) kullanın: Apify MCP Server MCPB dosyası
💰 Ajanlar için ödemeler
x402 veya Skyfire kullanarak API token olmadan Actor çalıştırmaları için ödeme yapabilirsiniz.
x402, Base üzerinde USDC ile ödeme yapar ve ayrı bir platform hesabı gerektirmez. mcpc (npm install -g @apify/mcpc) tarafından tam olarak desteklenir. mcpc'yi kullandığımız nedeni, en son özellikleri ve x402 protokolünü yerel olarak destekleyen birkaç MCP istemcisinden biridir.
Skyfire, PAY token'ları ile ödeme yapar ve finanse edilmiş bir cüzdanla Skyfire hesabı gerektirir. Özel bir MCP istemcisi gerektirmez; tüm ödeme akışı doğrudan MCP araç çağrısı parametreleri aracılığıyla işlenir.
Ajanlar için ödemeler nasıl çalışır
Actor çalıştırma maliyetleri değişiklik gösterdiğinden, her iki ödeme yöntemi de ön ödemeli bakiye modelini kullanır. Ödeme akışı dört adımda gerçekleşir:
Keşif: Agent, search-actors veya fetch-actor-details ile Actors'ları keşfeder. Bu çağrılar ücretsizdir.
Ön ödeme: Ücretli bir Actor aracını çalıştırmadan önce, agent bir ön ödemeli bakiyeyi finanse eder.
x402: mcpc, $1.00 USDC işlemini otomatik olarak imzalar.
Skyfire: Agent, Skyfire'ın create-pay-token aracını kullanarak bir PAY token (minimum $5.00) oluşturur.
Yürütme: Agent, Actor aracını çağırır.
x402: Ön ödemeli bakiye kullanılarak mcpc tarafından otomatik olarak işlenir.
Skyfire: Agent, skyfire-pay-id giriş özelliğinde PAY token'ını açıkça geçirir.
Çözümleme: Araç, Actor sonuçlarını döndürür. Kullanılmayan fonlar sonraki çalıştırmalar için mevcut kalır.
x402: 60 dakikalık hareketsizlikten sonra sunucu, kullanılmayan bakiyeyi Base üzerindeki cüzdana geri öder.
Skyfire: Skyfire, token'ın süresi dolduğunda kullanılmayan fonları geri verir.
💸 x402
x402 protokolü, doğrudan makine-makine ödemelerine olanak tanır. MCP istemciniz, Base blockchain üzerinde USDC ile Actor çalıştırmaları için ödeme yapmak üzere bunu kullanabilir ve Apify API token'ının gereksinimini tamamen ortadan kaldırabilir.
# Yeni bir cüzdan oluştur
mcpc x402 init
# Mevcut bir cüzdanı içeri aktar
mcpc x402 import <private-key>
# Cüzdan adresini göster; Base'de USDC ile finanse edebilirsin (https://base.org)
mcpc x402 info
mcpc @apify tools-call call-actor actor:="apify/rag-web-browser" input:='{"query": "latest AI news"}'
🔥 Skyfire
Skyfire, yapay zeka aracıları için yönetilen ödeme altyapısı sağlar. Apify API token'ı ile kimlik doğrulaması yapmak yerine, agentiniz her araç çağrısının maliyetini karşılamak için Skyfire ödeme token'ını PAY token'ları kullanarak geçirir.
MCP sunucusu, Apify Actors ile etkileşim kurmak için bir araç seti sağlar.
Apify Store geniş ve hızla büyüdüğünden, MCP sunucusu yeni Actors'ları dinamik olarak keşfetmek ve kullanmak için bir yol sağlar.
Actors
Herhangi bir Apify Actor aracı olarak kullanılabilir.
Varsayılan olarak sunucu, apify/rag-web-browser adlı bir Actor ve birkaç yardımcı araçla önceden yapılandırılmıştır.
MCP sunucusu, bir Actor'ın giriş şemasını yükler ve buna karşılık gelen bir MCP aracını oluşturur.
Bu, yapay zeka aracısının Actor'a hangi argümanları geçireceğini ve geri dönüşte neler bekleyeceğini tam olarak bilmesine izin verir.
Örneğin, apify/rag-web-browser Actor'ı için giriş parametreleri şunlardır:
{
"query": "restaurants in San Francisco",
"maxResults": 3
}
Hangi Actor'ı çağıracağınızı veya giriş parametrelerini manuel olarak belirtmeniz gerekmez; LLM bunu otomatik olarak işler.
Bir araç çağrıldığında, argümanlar LLM tarafından otomatik olarak Actor'a iletilir.
Kullanılabilir argümanların bir listesi için belirli Actor'ın belgesine başvurabilirsiniz.
Yardımcı araçlar
MCP'yi Apify ile kullanmanın en güçlü özelliklerinden biri dinamik araç keşfidir.
Bir yapay zeka aracısının gerektiğinde yeni araçlar (Actors) bulmasına ve bunları kullanmasına izin verir.
İşte bazı özel MCP işlemleri ve Apify MCP Server'ın bunları nasıl desteklediği:
Apify Actors: Actors'ı arayın, ayrıntılarını görüntüleyin ve yapay zeka için araç olarak kullanın.
Apify belgeleri: Apify belgesini arayın ve yapay zekaya bağlam sağlamak için belirli belgeleri getirin.
Actor çalıştırmaları: Actor çalıştırmalarının listesini alın, ayrıntılarını inceleyin ve günlükleri alın.
Apify depolaması: Veri setleriniz ve anahtar-değer depolarınızdan veri alın.
Mevcut araçlara genel bakış
Apify MCP Server tarafından sağlanan tüm araçların bir genel bakış listesi aşağıdadır.
Araç adı
Kategori
Açıklama
Varsayılan olarak etkindir
search-actors
actors
Apify Store'da Actors'ları arayın.
✅
fetch-actor-details
actors
Giriş şeması, README (özet mevcut olduğunda, aksi takdirde tam), fiyatlandırma ve Actor çıktı şeması dahil olmak üzere belirli bir Actor hakkında ayrıntılı bilgi alın.
✅
call-actor*
actors
Bir Actor'ı çağırın ve çalıştırma sonuçlarını alın. Giriş şemasını almak için önce fetch-actor-details kullanın.
❔
get-actor-run
runs
Belirli bir Actor çalıştırması hakkında ayrıntılı bilgi alın.
get-actor-output*
-
Actor çalıştırmasından çıktıyı alın; bu, Actor aracının çıktı önizlemesine dahil değildir.
✅
search-apify-docs
docs
Apify belgesinde ilgili sayfaları arayın.
✅
fetch-apify-docs
docs
URL'ye göre Apify belge sayfasının tam içeriğini getirin.
Bir Actor'ın çalıştırmalarının listesini alın; duruma göre filtrelenebilir.
get-actor-log
runs
Belirli bir Actor çalıştırması için günlükleri alın.
get-dataset
storage
Belirli bir veri seti hakkında meta veri alın.
get-dataset-items
storage
Filtreleme ve sayfalandırma desteği ile bir veri setinden öğeler alın.
get-dataset-schema
storage
Veri seti öğelerinden bir JSON şeması oluşturun.
get-key-value-store
storage
Belirli bir anahtar-değer deposu hakkında meta veri alın.
get-key-value-store-keys
storage
Belirli bir anahtar-değer deposundaki anahtarları listeleyin.
get-key-value-store-record
storage
Bir anahtar-değer deposundaki belirli bir anahtar için ilişkili değeri alın.
get-dataset-list
storage
Kullanıcı için tüm mevcut veri setlerini listeleyin.
get-key-value-store-list
storage
Kullanıcı için tüm mevcut anahtar-değer depolarını listeleyin.
add-actor*
experimental
Bir Actor'ı kullanıcının çağırması için yeni bir araç olarak ekleyin.
❔
Not:
actors araç kategorisi istendiğinde, dinamik araç keşfini destekleyen istemciler (Claude.ai web ve VS Code gibi) geliştirilmiş Actor keşif yetenekleri için otomatik olarak call-actor yerine add-actor aracını alırlar.
get-actor-output aracı, call-actor, add-actor veya apify--rag-web-browser gibi belirli bir Actor aracı gibi herhangi bir Actor ile ilgili araçla otomatik olarak dahil edilir. Bir Actor'ı çağırdığınızda (ister call-actor aracı ister doğrudan apify--rag-web-browser gibi bir Actor aracı kullanarak), çıktının bir önizlemesini alırsınız. Önizleme, Actor'ın çıktı formatına ve uzunluğuna bağlıdır; bazı Actors ve çalıştırmalar için, tüm çıktıyı içerebilir; diğerleri için, LLM'yi ezmeyi önlemek için sınırlı bir sürüm döndürülür. Bir Actor çalıştırmasının tam çıktısını almak için (datasetId destekle, offset ve alan filtrelemesini destekler) get-actor-output aracını Actor çağrısı tarafından sağlanan datasetId ile kullanın.
Araç açıklamaları
Tüm araçlar, MCP istemcilerine ve LLM'lere araç davranışını anlamalarına yardımcı olmak için meta veri açıklamaları içerir:
title: Araçın kısa görüntüleme adı (ör. "Search Actors", "Call Actor", "apify/rag-web-browser")
readOnlyHint: Durumu değiştirmeden yalnızca veri okuyan araçlar için true (ör. get-dataset, fetch-actor-details)
openWorldHint: Apify platformı dışında dış kaynakları erişen araçlar için true (ör. call-actor harici Actors'ı yürütür). Apify platformı ile etkileşim kuran araçlar (search-actors veya fetch-apify-docs gibi) bu ipucuna sahip değildir.
Araçlar yapılandırması
tools yapılandırma parametresi, yüklenen araçları (kategoriler veya belirli araçlar doğrudan ve Apify Actors) belirtmek için kullanılır. Örneğin, tools=storage,runs iki kategori yükler; tools=add-actor yalnızca bir araç yükler.
Hiçbir sorgu parametresi verilmediğinde, MCP sunucusu aşağıdaki tools türünü varsayılan olarak yükler:
actors
docs
apify/rag-web-browser
tools parametresi belirtilirse, yalnızca listelenen araçlar veya kategoriler etkinleştirilecek; varsayılan araçlar dahil edilmeyecektir.
Kolay yapılandırma:
Sunucunuzu yapılandırmak için UI configurator kullanın, ardından yapılandırmayı istemcinize kopyalayın.
Barındırılan sunucuyu yapılandırma:
Barındırılan sunucu, URL'deki sorgu parametreleri kullanılarak yapılandırılabilir. Örneğin, varsayılan araçları yüklemek için:
Minimal yapılandırma için, yalnızca bir single Actor aracı kullanmak istiyorsanız (keşif veya genel çağrı araçları olmadan), sunucu aşağıdaki şekilde yapılandırılabilir:
https://mcp.apify.com?tools=apify/my-actor
Bu kurulum, yalnızca belirtilen Actor'ı (apify/my-actor) araç olarak gösterir. Başka araç kullanılamayacaktır.
CLI'yi yapılandırma:
CLI, komut satırı bayraklarını kullanarak yapılandırılabilir.
