G-Search MCP

Google araması için güçlü bir MCP sunucusu, birden fazla anahtar kelimeyle eş zamanlı araştırma yapılmasını sağlar.

Bu proje google-search projesinden modifiye edilmiştir.

🌟 Önerilen: OllaMan - Güçlü Ollama AI Model Yöneticisi.

Avantajlar

• Paralel Arama: Google'da birden fazla anahtar kelimeyle eş zamanlı arama yapılmasını destekleyerek arama verimliliğini artırır
• Tarayıcı Optimizasyonu: Verimli paralel arama için tek bir tarayıcı örneğinde birden fazla sekme açar
• Otomatik Doğrulama İşleme: CAPTCHA'yı akıllıca algılar ve gerektiğinde kullanıcı doğrulaması için görünür tarayıcı modunu etkinleştirir
• Kullanıcı Davranışı Simülasyonu: Gerçek kullanıcı tarama desenlerini simüle ederek arama motorları tarafından algılanma olasılığını azaltır
• Yapılandırılmış Veriler: Arama sonuçlarını kolay işlenme ve analiz için JSON formatında döndürür
• Yapılandırılabilir Parametreler: Arama sonucu sınırları, zaman aşımı ayarları, dil ayarları vb. gibi çeşitli parametre konfigürasyonlarını destekler

Hızlı Başlangıç

npx ile doğrudan çalıştırın:

npx -y g-search-mcp

İlk kez kurulum - terminalde aşağıdaki komutu çalıştırarak gerekli tarayıcıyı yükleyin:

npx playwright install chromium

Debug Modu

Debug modunda çalıştırmak için --debug seçeneğini kullanın (tarayıcı penceresini gösterir):

npx -y g-search-mcp --debug

MCP Yapılandırması

Bu MCP sunucusunu Claude Desktop'ta yapılandırın:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "g-search": {
      "command": "npx",
      "args": ["-y", "g-search-mcp"]
    }
  }
}

Özellikler

• search - Birden fazla anahtar kelimeyle Google araması yapın ve sonuçları döndürün
  • Aramaları gerçekleştirmek için Playwright tarayıcısını kullanır
  • Aşağıdaki parametreleri destekler:
    • queries: Yürütülecek arama sorgularının dizisi (zorunlu parametre)
    • limit: Sorgu başına döndürülecek maksimum sonuç sayısı, varsayılan 10
    • timeout: Sayfa yükleme zaman aşımı milisaniye cinsinden, varsayılan 60000 (60 saniye)
    • noSaveState: Tarayıcı durumunu kaydetmekten kaçınılıp kaçınılmayacağı, varsayılan false
    • locale: Arama sonuçları için dil ayarı, varsayılan en-US
    • debug: Debug modunun etkinleştirilip etkinleştirilmeyeceği (tarayıcı penceresini gösterir), komut satırında --debug bayrağını geçersiz kılar

Örnek kullanım:

Google'da "machine learning" ve "artificial intelligence" aramak için search aracını kullanın

Örnek yanıt:

{
  "searches": [
    {
      "query": "machine learning",
      "results": [
        {
          "title": "What is Machine Learning? | IBM",
          "link": "https://www.ibm.com/topics/machine-learning",
          "snippet": "Machine learning is a branch of artificial intelligence (AI) and computer science which focuses on the use of data and algorithms to imitate the way that humans learn, gradually improving its accuracy."
        },
        ...
      ]
    },
    {
      "query": "artificial intelligence",
      "results": [
        {
          "title": "What is Artificial Intelligence (AI)? | IBM",
          "link": "https://www.ibm.com/topics/artificial-intelligence",
          "snippet": "Artificial intelligence leverages computers and machines to mimic the problem-solving and decision-making capabilities of the human mind."
        },
        ...
      ]
    }
  ]
}

Kullanım İpuçları

Özel Website Senaryolarını İşleme

Arama Parametrelerini Ayarlama

• Arama Sonuç Miktarı: Daha fazla arama sonucu için:

  Lütfen her anahtar kelime için ilk 20 arama sonucunu döndürün
  

  Bu, limit: 20 parametresini ayarlayacaktır.

• Zaman Aşımını Artırma: Yavaş yükleme durumlarında:

  Lütfen sayfa yükleme zaman aşımını 120 saniyeye ayarlayın
  

  Bu, timeout parametresini 120000 milisaniyeye ayarlayacaktır.

Dil Ayarları Ayarlanması

• Arama Bölgesini Değiştirme: Farklı bir dil ayarı belirtin:

  Lütfen arama için Çince dilini (zh-CN) kullanın
  

  Bu, locale: "zh-CN" parametresini ayarlayacaktır.

Hata Ayıklama ve Sorun Giderme

Debug Modunu Etkinleştirme

• Dinamik Debug Aktivasyonu: Belirli bir arama işlemi sırasında tarayıcı penceresini göstermek için:

  Lütfen bu arama işlemi için debug modunu etkinleştirin
  

  Bu, sunucu --debug bayrağı olmadan başlatılmış olsa bile debug: true ayarını yapar.

Kurulum

Ön Koşullar

• Node.js 18 veya daha yüksek
• NPM veya Yarn

Kaynaktan Yükle

1. Depoyu klonlayın:

git clone https://github.com/jae-jae/g-search-mcp.git
cd g-search-mcp

2. Bağımlılıkları yükleyin:

npm install

3. Playwright tarayıcısını yükleyin:

npm run install-browser

4. Sunucuyu derleyin:

npm run build

Geliştirme

Otomatik Yeniden Derleme (Geliştirme Modu)

npm run watch

Hata Ayıklama için MCP Inspector Kullanma

npm run inspector

İlişkili Projeler

• fetcher-mcp: Playwright headless tarayıcısını kullanarak web sayfası içeriği almak için güçlü bir MCP sunucusu. Akıllı içerik çıkarma, paralel işleme, kaynak optimizasyonu ve daha fazlasını sunarak web içeriği scraping için ideal bir araçtır.

Lisans

MIT Lisansı altında lisanslanmıştır