Genel Bakış

Firecrawl MCP, herhangi bir web sayfasını veya tüm web sitesini tarayarak içeriği LLM uyumlu, temizlenmiş veri formatında (Markdown, JSON, düz metin vb.) sunan bir MCP servisidir.

Bu sayede Kuika uygulamanız, web üzerindeki içerikleri anlamlandırılmış veri yapıları halinde çekerek AI Agent'lar, otomasyon senaryoları ve veri işleme süreçlerinde doğrudan kullanabilir. Firecrawl MCP entegrasyonu sayesinde:

• Web sayfalarındaki HTML karmaşıklığından kurtulursunuz,
• AI modelleri için optimize edilmiş veri çıktıları elde edersiniz,
• İçerik özetleme, analiz, indeksleme ve chatbot gibi senaryolar kolaylaştırılır.

Firecrawl MCP yalnızca AI Agents içinde kullanılabilir.

Config Manager Üzerinden Firecrawl MCP Tanımlama

Firecrawl MCP ayarları, Kuika Config Manager modülü üzerinden tanımlanır. Firecrawl entegrasyonu, dinamik olarak oluşturulan web sitelerinden veri çekme (scraping) işlemlerini mümkün kılar.

Ayar Adımları

1. Kuika platformuna giriş yapın.
2. Apps ekranından çalışacağınız projeyi açın.
3. Üst menüden Config Manager modülüne tıklayın.

4. Var olan bir konfigürasyonu düzenlemek için listeden adına tıklayın veya Create a blank configuration kartıyla yeni bir konfigürasyon oluşturun.
5. Konfigürasyon ekranının üst kısmında App Settings sekmesinin seçili olduğundan emin olun.
6. Sol menüde INTEGRATIONS başlığı altındaki MCP seçeneğine tıklayın.
7. Firecrawl alanının altındaki Add New bağlantısına tıklayın.

8. Açılan Firecrawl MCP Setting penceresinde aşağıdaki alanları doldurun:

• Name (zorunlu): Firecrawl yapılandırmanız için tanımlayıcı bir isim. Örneğin:
  
  • Firecrawl_Main_Key
  • WebScraping_Service
  • Firecrawl_MCP_Prod
• API Key (zorunlu): Firecrawl servisinden alınan API anahtarı. Anahtarınızı Firecrawl panelindeki API Keys bölümünden alabilirsiniz.

9. Create butonuna tıklayın.
10. Firecrawl açılır menüsünden oluşturduğunuz yapılandırmayı seçin.
11. Sağ üst köşedeki Save butonuna tıklayarak değişiklikleri kaydedin. (Mevcut bir konfigürasyonda bu buton Update olarak görünür.)

Firecrawl API Key Oluşturma

Firecrawl MCP’yi kullanabilmek için bir API Key oluşturmanız gerekmektedir.

Adım Adım API Key Alma Süreci

1. Tarayıcıdan aşağıdaki siteye gidin: https://www.firecrawl.dev/ 

2. Henüz hesabınız yoksa Sign Up ile kayıt olun.
3. Kayıt sonrası hesabınıza giriş yapın.
4. Uygun bir Subscription Plan seçin.
5. Dashboard ekranına gelin.

6. Sağ menüden API Keys sekmesine tıklayın.

7. Açılan ekranda oluşturulmuş olan API anahtarınızı bulun.
8. Copy butonuna tıklayarak anahtarı kopyalayın.

9. Kuika projenizde:
   
   • Configuration Manager → Firecrawl MCP Setting alanına gidin,
   • API Key alanına aldığınız anahtarı yapıştırın.

Kullanım Senaryoları

Firecrawl MCP aşağıdaki senaryolarda yoğun olarak kullanılır:

• Web site içeriklerini AI Agents ile analiz etmek,
• Blog, haber veya dokümantasyon sitelerini taramak,
• İçerik özetleme ve sınıflandırma yapmak,
• Arama indeksleri oluşturmak,
• Chatbot sistemlerine canlı web verisi sağlamak,
• Otomatik veri güncelleme ve scraping senaryoları oluşturmak.

AI Agent İçinde Firecrawl Kullanımı

Firecrawl MCP, AI Agent ekranında bulunan:

• AI Agents içinde Dynamic Website Scraper tool adıyla kullanılır.

Kullanım Akışı

1. Datasources modülüne geçin. 
2. AI Agent sekmesine girin.
3. Agent içerisine Add Tool ile:
   
   • Dynamic Website Scraper ekleyin.
4. Tool ayarlarında:
   
   • Daha önce oluşturduğunuz Firecrawl MCP konfigürasyonunu seçin.
5. Agent Instruction içinde:
   
   • Hangi sitelerin taranacağı,
   • Ne tür veri beklendiği,
   • Verinin nasıl yorumlanacağı yazılır.
6. Agent çalıştırıldığında, içerik Firecrawl üzerinden çekilir ve AI çıktısına dahil edilir.