Decodo

Decodo MCP Server

MCP (Model Context Protocol) kullanarak LLM'leri ve yapay zekâ ajanlarını canlı web verilerine bağlayın. Decodo MCP Server, sıfırdan kazıma altyapısı oluşturmanıza gerek kalmadan Claude, Cursor ve Windsurf gibi yapay zekâ araçlarından web sitelerini, arama motorlarını, e-ticaret platformlarını ve sosyal medyayı doğrudan kazımanızı sağlar.

• JSON, Markdown ve ekran görüntülerinde yapılandırılmış çıktılar
• Sunucu tarafında JavaScript işleme ve bot önleme yönetimi
• 195'ten fazla konumda 125 milyondan fazla IP

Decodo MCP server nedir?

Decodo MCP Server, yapay zekâ ajanları için bir web kazıma katmanıdır. MCP uyumlu istemcileri Decodo'nun Web Scraping API'sine bağlayarak şunları mümkün kılar:

• LLM'ler için web kazıma
• RAG için gerçek zamanlı veri alma
• Yapay zekâ ajanlarıyla gezinme ve araştırma
• Dinamik web sitelerinden yapılandırılmış veri çıkarma

Proxy'leri, ayrıştırıcıları ve yeniden deneme mantığını yönetmek yerine, güvenilir web verilerine erişim için tek bir entegrasyon noktası elde edersiniz.

Web kazıma için neden MCP kullanmalı?

Model Context Protocol (MCP), yapay zekâ ajanlarını harici araçlara ve veri kaynaklarına bağlamak için gelişmekte olan standarttır. MCP ile:

• Ajanlar araçları dinamik olarak çağırabilir
• Entegrasyonlar standartlaştırılmış kalır
• İş akışları farklı ortamlarda ölçeklenir

Decodo MCP Server, bu standart üzerinden ajanlarınıza güvenilir ve üretime hazır web erişimi sağlar.

Temel özellikler

Altyapı gerektirmeden yapay zekâ ajanları için web kazıma. Proxy rotasyonunu, CAPTCHA çözümünü veya bot önleme sistemlerini yönetmeden JavaScript ağırlıklı sayfalar da dahil olmak üzere tüm web sitelerini kazıyın.

LLM iş akışları için yapılandırılmış çıktılar. RAG işlem hatları, yapay zekâ araştırma ajanları ve otomasyon akışları için hazırlanmış Markdown (LLM'lere hazır), JSON (yapılandırılmış işlem hatları için) ve ekran görüntüleri (görsel bağlam için).

Popüler hedefler için yerleşik destek. Google ve Bing (SERP'ler), Amazon, Walmart ve Target (e-ticaret), TikTok ve YouTube (sosyal medya) ile ChatGPT ve Perplexity (yapay zekâ araması) için kullanıma hazır araçlar.

Küresel proxy altyapısı. 115 milyondan fazla konut IP'si, 195'ten fazla coğrafi konum ve en korunaklı hedeflerde bile %99,99 başarı oranı.

Modüler MCP araç kümeleri. Daha düzenli araç seçimi ve daha iyi ajan performansı için yalnızca ihtiyacınız olanları etkinleştirin: web, search, ecommerce, social_media, ai.

Değere hızlı ulaşma. API anahtarından ilk kazımaya dakikalar içinde geçin; kurulum yükü yok.

Kullanım alanları

Yapay zekâ ajanları için web kazıma, büyük ölçekte yapılandırılmış veri çıkarma, dinamik web sitelerine güvenilir erişim, RAG için gerçek zamanlı veri veya sıfırdan kazıma altyapısı oluşturmanın alternatifi gerektiğinde Decodo MCP Server'ı kullanın. Yaygın senaryolar:

• Yapay zekâ destekli web kazıma – LLM'lerin statik eğitim verilerine güvenmek yerine güncel verileri toplamasını sağlayın.
• Canlı verilerle RAG – Google, Bing ve yapay zekâ arama sonuçlarını gerçek zamanlı olarak bilgi getirme işlem hatlarına aktarın.
• E-ticaret istihbaratı – Engellenmeden pazaryerlerindeki ürün fiyatlarını, ilanları ve satıcıları takip edin.
• Sosyal medya verisi toplama – TikTok ve YouTube'dan gönderileri, kanalları ve etkileşim verilerini toplayın.
• Seyahat ve fiyat toplama – Web sitelerindeki güncel fiyatları ve müsaitlik durumunu toplayan araçlar oluşturun.

Hızlı başlangıç

1. Ücretsiz hesap oluşturun: dashboard.decodo.com – kredi kartı gerekmeden 10 bine kadar ücretsiz istek.
2. API anahtarınızı alın. Web Data API aboneliğinizdeki Web Data API anahtarını dashboard üzerinden kopyalayın. Eski planlarda temel kimlik doğrulama belirteci bulunur; bu da çalışır (Kimlik doğrulama bölümüne bakın).
3. Node.js 18+ sürümünü indirin: https://nodejs.org.
4. Claude Desktop, Cursor, Windsurf veya diğer MCP uyumlu araçlar gibi bir MCP istemcisi edinin.
5. MCP server'ı yapay zekâ istemcinizde yapılandırın (aşağıdaki yapılandırma örneklerine bakın).

Decodo's MCP server ile bağlantı kurma

Tercih ettiğiniz MCP istemcisini açın ve aşağıdaki yapılandırmayı ekleyin (Claude Code, Cursor ve Windsurf örneklerine aşağıdan bakın):

{
  "mcpServers": {
    "Decodo": {
      "url": "https://mcp.decodo.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Kimlik doğrulama

Yerel server, SCRAPER_API_TOKEN üzerinden her iki kimlik bilgisini de okur ve hangisinin verildiğini belirler.

Claude Desktop

1. Claude Desktop → Settings → Developer → Edit Config'i açın.
2. claude_desktop_config.json dosyasına ekleyin:

{
  "mcpServers": {
    "Decodo": {
      "command": "npx",
      "args": ["-y", "@decodo/mcp-server"],
      "env": {
        "SCRAPER_API_TOKEN": "<api_key>",
        "TOOLSETS": "web,ai"
      }
    }
  }
}

3. Kaydedin ve Claude Desktop'ı yeniden başlatın.

Cursor

1. Settings → MCP'yi açın.
2. Add a new global MCP server'a tıklayın (mcp.json açılır).
3. Yukarıdaki yapılandırmanın aynısını ekleyin.
4. Kaydedin — Decodo'nun yanında yeşil durum göstergesini arayın.

Windsurf

1. Settings → Windsurf Settings'i açın.
2. Cascade → Add custom server + bölümüne gidin (mcp_config.json açılır).
3. Yukarıdaki yapılandırmanın aynısını ekleyin.
4. Kaydedin ve Windsurf'ü yeniden başlatın.

eve (Vercel)

1. eve ajan projenizde eve add connection/decodo komutunu çalıştırın veya agent/connections/decodo.ts oluşturun:

import { always } from 'eve/tools/approval';
import { defineMcpClientConnection } from 'eve/connections';

export default defineMcpClientConnection({
  url: 'https://mcp.decodo.com/mcp',
  description:
    'Decodo: scrape web pages as Markdown, search the web, map and crawl sites, and read e-commerce and YouTube data.',
  headers: () => ({
    Authorization: `Bearer ${process.env.DECODO_API_KEY!}`,
  }),
  approval: always(),
});

2. Ajanın sunucu tarafı ortamında DECODO_API_KEY=<api_key> değerini ayarlayın (yerel ortamda .env.local, Vercel'de proje ortam değişkenleri).
3. Çağrılar planınızı kullandığından approval: always() her çağrıdan önce onay ister; isterseniz eve'nin onay kurallarıyla bu ayarı gevşetin.

Kurulumunuzu test edin

Bağlandıktan sonra istemcinizde şu istemi deneyin:

▎ "Hacker News'teki en iyi 5 makalenin başlıklarını kazı"

Birkaç saniye içinde yapılandırılmış bir liste almalısınız. Kimlik doğrulama hatası görürseniz dashboard'daki API anahtarınızı tekrar kontrol edin.

Yerel geliştirme

Yalnızca server kodunu değiştirmek istiyorsanız gereklidir.

git clone https://github.com/Decodo/mcp-server

cd mcp-server
npm install
npm run build

cd build/
pwd

/Users/your.user/projects/mcp-server/build/index.js

{
  "mcpServers": {
    "decodo-mcp": {
      "command": "node",
      "args": ["/Users/your.user/projects/mcp-server/build/index.js"],
      "env": {
        "SCRAPER_API_TOKEN": "<api_key>"
      }
    }
  }
}

Araç kümeleri

Araçlar, araç kümeleri halinde düzenlenmiştir. Kullanabileceğiniz kümeler bağlantı kurma şeklinize bağlıdır.

Claude (resmî bağlayıcı)

Claude'un bağlayıcı dizinindeki Decodo bağlayıcısı yalnızca Web Data API araçlarını içerir:

Herhangi bir MCP istemcisi

toolsets sorgu parametresi üzerinden virgülle ayrılmış bir liste ileterek belirli araç kümelerini seçerek etkinleştirebilirsiniz:

    "Decodo MCP Server": {
      "url": "https://mcp.decodo.com/mcp?toolsets=web,ai",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }

Hiçbir araç kümesi belirtilmediğinde tüm araçlar kaydedilir.

Araçlar

Server aşağıdaki araçları sunar:

Parametreler

Aşağıdaki parametreler kullanıcı istemlerinden çıkarılır:

Örnekler

Coğrafi kısıtlamalı içeriği tarama

Yapay zekâ aracınıza aşağıdaki istemi gönderin:

Scrape peacock.com from a German IP address and tell me the pricing.

Bu istem, peacock.com'un coğrafi olarak kısıtlandığını belirtir. Coğrafi kısıtlamayı aşmak için:

Scrape peacock.com from a US IP address and tell me the pricing.

Yanıt belirteci sayısını sınırlama

Aracınızın bağlam penceresi küçükse, bağlam taşmasını önlemek için tarama sonucunda döndürülen içerik otomatik olarak kısaltılır. İsteminizde döndürülecek belirteç sayısını artırabilirsiniz:

Scrape hacker news, return 50k tokens.

Aracınızın bağlam penceresi büyükse, ona full content döndürmesini söyleyin:

Scrape hacker news, return full content.

Decodo agent skills ile kullanma

Bu sunucu, aracınıza veri kazıma araçlarını sağlar. Decodo/agent-skills, araca bu araçlara ne zaman başvuracağını, hangi arayüzü kullanacağını ve nasıl çağıracağını öğretir; böylece araç, tahmin yürütmek yerine doğru aracı ve parametreleri kendi seçer.

Skills, decodo CLI, bu barındırılan MCP sunucusu ve ham HTTP API arasında yönlendirme yapar; kabuk kullanılamadığında otomatik olarak MCP sunucusuna geçer. İkisini birlikte kullanmak, aracınıza tek bir kurulumda hem yürütme katmanını (bu sunucu) hem de karar katmanını (skills) sağlar.

Hızlı başlangıç (Claude Code):

/plugin marketplace add Decodo/agent-skills
/plugin install decodo@decodo-skills

Elle kurulum ve diğer araçlar (Cursor, Codex, Gemini CLI, Windsurf) için agent-skills README dosyasına bakın.

İlgili depolar

Web Scraping API, Decodo agent skills, Decodo OpenClaw skill

Deneyin

Decodo MCP Server'ı yalnızca birkaç tıklamayla yapay zekâ iş akışınıza ekleyin ve yapay zekâ araçlarınıza tüm web sitelerinden gerçek zamanlı veriler sağlayın.

Ücretsiz başlayın | Belgeler | Discord

Lisans

Tüm kodlar MIT Lisansı kapsamında yayımlanmıştır.