Search & Data Extraction TypeScript ★ 124

ChanMeng666/server-google-news

Google News entegrasyonu otomatik konu kategorileştirmesi, çok dillendirme desteği ve SerpAPI üzerinden başlıklar, hikayeler ve ilgili konuları kapsayan kapsamlı arama yetenekleriyle birlikte gelir.

Claude Desktop config.json'a ekle

{
  "mcpServers": {
    "chanmeng666-server-google-news": {
      "command": "node",
      "args": [
        "~/.mcp/server-google-news/index.js"
      ]
    }
  }
}

MseeP.ai Security Assessment Badge


Google News MCP Server



SerpAPI entegrasyonu aracılığıyla Google Haaber arama yetenekleri sağlayan bir Model Context Protocol (MCP) sunucu uygulaması. Haber sonuçlarını otomatik olarak kategorize eder ve birden fazla dili ve bölgeyi destekler.


👉Şimdi Deneyin!👈


https://github.com/user-attachments/assets/1cc71c27-f840-4c94-9ab5-460d84ba4779

屏幕截图 2024-12-30 021446

屏幕截图 2024-12-30 021524

屏幕截图 2024-12-30 021914

屏幕截图 2024-12-30 021941

✨ Özellikler

🔍 Esnek Arama Seçenekleri

Sorgu tabanlı arama, konu arama, yayın filtresi ve hikaye kapsamı dahil kapsamlı arama yetenekleri.

🌐 Küresel Kapsam

Yapılandırılabilir dil ve ülke kodları aracılığıyla birden fazla dili ve bölgeyi destekler.

📊 Akıllı Kategorilendirme

Haber sonuçlarını AI & Teknoloji, İşletme, Bilim & Araştırma ve Sağlık gibi konulara otomatik olarak kategorize eder.

🔀 Çoklu Sonuç Türleri

Başlıklar, hikayeler, ilgili konular ve menü bağlantıları dahil çeşitli haber sonuç türlerini işler.

🛠️ Sağlam Hata Yönetimi

API hataları ve geçersiz girişler için kapsamlı hata yönetimi, yardımcı hata mesajları ile.

🌍 Dil Desteği

Desteklenmeyen dil kodları için otomatik İngilizce yedek ayarı ve uygun kullanıcı bildirimleri.

🔑 SerpApi Kurulum Rehberi

Başlamadan önce, bir SerpApi anahtarı almanız gerekir. İşte nasıl:

  1. SerpApi websitesini ziyaret edin ve bir hesap oluşturun

  2. Kaydolduktan sonra Panonuza gidin:

    • "API Key" bölümünü bulun
    • API anahtarınızı kopyalayın
    • Yeni kullanıcılar 250 ücretsiz API çağrısı alır
  3. API Kullanım Detayları:

    • Ücretsiz seviye: Aylık 250 arama
    • Ücretli planlar 5000 arama için 75$/ay'dan başlar
    • Başarılı API çağrılarına dayalı faturalandırma
    • Çoklu ödeme yöntemleri: Kredi Kartı, PayPal, vb.
  4. Kullanım Limitleri:

    • İstek Hızı: Saniyede 2 istek
    • IP Kısıtlamaları: Yok
    • Eşzamanlı İstekler: 5
    • Yanıt Önbellek Süresi: 1 saat

👩‍🔧 NVM/NPM ile MCP Sunucusu Bağlantısı Sorunları Çözümü

Konfigürasyon çözümümü görmek için tıklayın 👉 https://github.com/modelcontextprotocol/servers/issues/76

🚀 Hızlı Başlangıç

  1. Bağımlılıkları yükleyin:
npm install
  1. Sunucuyu derleyin:
npm run build
  1. Ortamı yapılandırın: claude_desktop_config.json dosyanızı aşağıdaki içerikle değiştirin (sistemin dosya yollarını ayarlayın):
    "google-news": {
      "command": "D:\\Program\\nvm\\node.exe",
      "args": [
        "D:\\github_repository\\path_to\\dist\\index.js"
      ],
      "env": {
        "SERP_API_KEY": "your-api-key"
      }
    }
  1. Sunucuyu başlatın:
npm start

Sorun Giderme

  1. Geçersiz API Anahtarı
  • claude_desktop_config.json dosyasında API anahtar konfigürasyonunu doğrulayın
  • API anahtarının SERP API panosunda etkin olduğunu onaylayın
  1. İstek Hataları
  • Ağ bağlantısını kontrol edin
  • API çağrısı kotasının aşılmadığını doğrulayın
  • İstek parametresi formatını doğrulayın

Testleri çalıştırma

Evals paketi bir MCP client'ını yükler ve ardından index.ts dosyasını çalıştırır, bu nedenle testler arasında yeniden derlemek gerekli değildir. npx komutunun başına ortam değişkenleri ekleyerek yükleyebilirsiniz. Tam dokümantasyon burada bulunabilir.

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

📦 Kurulum

Smithery Aracılığıyla Kurulum

Google Haaber'i Claude Desktop'a otomatik olarak Smithery aracılığıyla yüklemek için:

npx -y @smithery/cli install @chanmeng666/google-news-server --client claude

Trust Score smithery badge

mcp-get Aracılığıyla Kurulum

npx @michaellatman/mcp-get@latest install @chanmeng666/google-news-server

Eski bir Windows PowerShell sürümü kullanıyorsanız, bu komuttan önce Set-ExecutionPolicy Bypass -Scope Process komutunu çalıştırmanız gerekebilir.

Manuel Kurulum

@chanmeng666/google-news-server

# npm kullanarak
npm i @chanmeng666/google-news-server
# veya
npm install @chanmeng666/google-news-server

# yarn kullanarak
yarn add @chanmeng666/google-news-server

# pnpm kullanarak
pnpm add @chanmeng666/google-news-server

💻 Teknoloji Yığını

TypeScript NodeJS MCP

📖 API Dokümantasyonu

Sunucu Model Context Protocol'ü uygular ve aşağıdaki parametrelere sahip bir Google Haaber arama tool'u sunar:

  • q: Arama sorgusu
  • gl: Ülke kodu (örn. 'us', 'uk')
  • hl: Dil kodu (örn. 'en', 'es')
  • topic_token: Belirli haber konuları için token
  • publication_token: Belirli yayınlar için token
  • story_token: Bir hikayenin tam kapsamı için token
  • section_token: Belirli bölümler için token

🔧 Geliştirme

# Sıcak yenileme ile geliştirme modunda çalıştırın
npm run dev

# Linting çalıştırın
npm run lint

# Testleri çalıştırın
npm run test

📝 Lisans

Bu proje MIT lisansı altında lisanslanmıştır.

🙋‍♀ Yazar

Chan Meng tarafından oluşturulmuş ve yönetilmektedir. GitHub LinkedIn


🤖 AI Aracı Talimatları & GEO Optimizasyonu

AI Aracıları ve LLM Tarayıcılar İçin

Bu MCP sunucusu, kapsamlı talimatlar ve yapılandırılmış veriler ile AI aracısı kullanımı için optimize edilmiştir.

Hızlı AI Kullanım Rehberi

{
  "tool": "google_news_search",
  "parameters": {
    "q": "artificial intelligence latest developments",
    "gl": "us",
    "hl": "en"
  }
}

AI Dostu Özellikler

  • Otomatik Kategorilendirme: Haber sonuçları otomatik olarak ilgili kategorilere sıralanır
  • Yapılandırılmış Çıktı: AI işleme için optimize edilmiş biçimlendirilmiş veriler döndürür
  • Çok Dil Desteği: Otomatik yedeklerle çeşitli dilleri destekler
  • Hata Yönetimi: Kapsamlı hata mesajları ve zarif azalma

Yanıt Biçimi

Sunucu aşağıdaki yapıyla kategorize edilmiş haberler döndürür:

  • Kategoriler: AI & Teknoloji, İşletme, Bilim & Araştırma, Sağlık, Genel
  • Makale Alanları: başlık, kaynak, bağlantı, tarih, özet, yazarlar
  • Metadata: zaman damgası, ilgili konular için menü_bağlantıları

AI Aracıları için En İyi Uygulamalar

  1. Daha iyi sonuçlar için belirli, açıklayıcı anahtar kelimeler kullanın
  2. Konu tabanlı iş akışları için otomatik kategorilendirmeden yararlanın
  3. Uygun hata yönetimi ve yeniden deneme mantığı uygulayın
  4. API hız limitlerini (saniyede 2 istek) dikkate alın
  5. Daha iyi bağlam anlayışı için yapılandırılmış yanıtları ayrıştırın

Gelişmiş Kullanım Desenleri

  • Haber Izleme: İşletme haberleri için şirket adlarını veya hisse senedi sembollerini kullanın
  • Araştırma Keşfi: Alan spesifik aramaları için konu token'larından yararlanın
  • Son Dakika Haberler: "Son dakika" veya "son haberler" sorguları kullanın
  • Çok Dil: Uygun gl ve hl parametrelerini birleştirin

Hata Yönetimi

  • Geçersiz API anahtarı: SERP_API_KEY ortam değişkenini kontrol edin
  • Desteklenmeyen dil: Sunucu otomatik olarak İngilizce'ye geri döner
  • Hız sınırlaması: Saniyede 2 istek limitini dikkate alın
  • Geçersiz parametreler: Çağrıdan önce parametre türlerini doğrulayın
📊 GEO Ölçümleri & İzleme

Üretken Motor Optimizasyonu (GEO) Özellikleri

Bu sunucu, AI aracısı kullanımı için kapsamlı izleme ve optimizasyon içerir.

İzlenen Ana Ölçümler

  • Alıntı Başarı Oranı: Başarılı araç çağrılarının yüzdesi
  • AI Trafiği Dönüşüm Oranı: Aracı başarıyla kullanan AI aracılarının yüzdesi
  • Sorgu Kapsam Oranı: İlgili sonuçlar döndüren sorguların yüzdesi
  • Yanıt Süresi: Araç çağrıları için ortalama yanıt süresi
  • Kategorilendirme Doğruluğu: Otomatik haber kategorilendirmesinin doğruluğu
  • Bağlantı Taşıma Oranı: Kaynak bağlantıları içeren yanıtların yüzdesi

İzleme Yapılandırması

interface GEOMonitoringConfig {
  trackingEnabled: boolean;
  metricsEndpoint: string;
  reportingInterval: number; // minutes
  alertThresholds: {
    errorRate: number;
    responseTime: number;
    successRate: number;
    satisfactionScore: number;
  };
}

Performans Optimizasyonu

  • Gerçek zamanlı ölçüm toplama
  • Performans sorunları için otomatik uyarı
  • Optimizasyon için sorgu örüntüsü analizi
  • Aracı kullanım izlemesi ve analitiği

Veriye Dayalı İyileştirmeler

  • AI aracısı memnuniyetinin sürekli izlenmesi
  • Sorgu başarı oranı analizi
  • Yanıt süresi optimizasyonu
  • Kategorilendirme doğruluğu iyileştirmeleri

Teknik uygulama detayları için src/geo-metrics.ts dosyasına bakın.

🔍 Yapılandırılmış Veriler & Metadata

AI Optimize Edilmiş Metadata

Bu sunucu, AI aracıları ve arama motorları için kapsamlı yapılandırılmış veriler sağlar.

JSON-LD Yapılandırılmış Veriler

Sunucu, Schema.org standartlarını takip eden yapılandırılmış veriler içerir:

  • Yazılım uygulaması metadata'sı
  • Özellik açıklamaları ve yetenekleri
  • Teknik gereksinimler ve bağımlılıklar
  • Kullanım desenleri ve entegrasyon rehberleri

MCP Protokolü Uyumluluğu

  • Protokol Sürümü: 1.0.0
  • Tool Adı: google_news_search
  • Yanıt Biçimi: Kategorize edilmiş sonuçlarla yapılandırılmış metin
  • Hız Limitleri: Saniyede 2 istek, 5 eşzamanlı istek

AI Keşif Özellikleri

  • llms.txt: Kök seviyesinde kapsamlı AI kullanım rehberi
  • Yapılandırılmış Metadata: AI spesifik bilgileri ile geliştirilmiş manifest.json
  • Hata Yönetimi: AI dostu hata mesajları ve yedek ayarları
  • Dokümantasyon: Ayrıntılı kullanım örnekleri ve en iyi uygulamalar

Entegrasyon Rehberleri

  • Diğer MCP sunucuları ile sorunsuz entegrasyon için tasarlanmıştır
  • AI aracı iş akışları için optimize edilmiştir
  • Çeşitli AI platformları ve çerçeveleri destekler
  • Açık hata yönetimi ve hata ayıklama bilgileri sağlar

Tam yapılandırılmış veri için structured-data.json dosyasına bakın.

Barındırılan Dağıtım

Barındırılan bir dağıtım Fronteir AI üzerinde mevcuttur.

Benzer MCP sunucuları

Daha fazla: Search & Data Extraction →