English Français العربية

GNews

السجل الرسمي البحث والويب

Official GNews API server: search news articles and top headlines from 80,000+ sources.

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع GNews؟

  • search: Search for news articles through a combination of keywords.
  • top_headlines: Get top headlines by category and country.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http gnews 'https://mcp.gnews.io/' --header 'X-Api-Key: <Your GNews API key. Get a free key at https://gnews.io/register>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "gnews": {
            "type": "http",
            "url": "https://mcp.gnews.io/",
            "headers": {
                "X-Api-Key": "<Your GNews API key. Get a free key at https://gnews.io/register>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. 📡 GNews API MCP Server
  2. 🔑 GNews API Key
  3. 🔗 MCP Integration
  4. 🛠️ Available Tools
  5. 📄 Usage Examples
  6. 🔒 Security
  7. 📋 Client Prerequisites

📡 GNews API MCP Server

This document describes a Model Context Protocol (MCP) server that exposes the GNews API.

This server is already deployed and publicly accessible, so you don't need to install anything. You just need to connect it to your compatible MCP client (Claude Code, Gemini CLI, etc.).

🔑 GNews API Key

To use this server, you need a valid GNews API key.

👉 Get your API key here

The API key must be provided in the following way:

  • Via an HTTP header X-Api-Key

🔗 MCP Integration

This server is listed in the official MCP Registry as io.github.gnews-io/gnews.

With Claude Code

Add the server to your Claude Code configuration with the following command:

claude mcp add --transport http gnews_api https://mcp.gnews.io/ --header "X-Api-Key: YOUR_API_KEY"

🛠️ Available Tools

Once the server is connected, the following two tools are available:

  • search: Search for news articles through a combination of keywords.
  • top_headlines: Get top headlines by category and country.

📄 Usage Examples

Search for articles

This example searches for the 5 latest English articles on climate change:

{
  "tool": "search",
  "args": {
    "q": "climate change",
    "lang": "en",
    "max": 5
  }
}
Get latest headlines

This example retrieves the 5 top headlines from the "technology" category in the United States:

{
  "tool": "top_headlines",
  "args": {
    "category": "technology",
    "country": "us",
    "max": 5
  }
}

🔒 Security

  • Never share your API key. Treat it like a password.
  • This server acts as a proxy: it does not store any API keys. Your key is transmitted directly to GNews API with each request.
  • Always use an HTTPS connection to communicate with the server to ensure your key is encrypted in transit.
  • The hosted server records anonymous usage statistics for each tool call: tool name, MCP client name and version, success or error, duration, and the lang, country, category, max, page and sortby parameters. Your API key is only recorded as a one-way hash, and your search queries are never recorded.

📋 Client Prerequisites

  • A compatible MCP client (e.g., Claude Code).
  • The latest version of Gemini CLI is recommended for optimal compatibility.

الأسئلة الشائعة

ما هو GNews؟

Official GNews API server: search news articles and top headlines from 80,000+ sources.

كيف أثبّت GNews؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http gnews 'https://mcp.gnews.io/' --header 'X-Api-Key: <Your GNews API key. Get a free key at https://gnews.io/register>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج GNews إلى مفتاح API؟

نعم. يتطلب X-Api-Key، وتضبطها في إعداداته.

هل GNews مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون GNews؟

ينشره gnews-io. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.