Webz.io News Search

官方

使用自然語言搜尋全球新聞。Webz.io News Search API 回傳最相關的文章與內容,並提供來源、國家、語言、日期、情緒及類別篩選功能。

你可以用 Webz Io News Search MCP 做什麼?

  • 按主題搜尋全球新聞 — 讓您的 AI 以自然語言查詢(例如「EU AI regulation」)呼叫 news_search_by_webz,即可取得包含標題、URL 和摘要的最新文章。

  • 依網域、語言或國家/地區篩選結果 — 使用 domainlanguagecountrysentimentcategory 等參數縮小搜尋範圍,以鎖定特定來源或地區。

  • 控制結果數量與時間範圍 — 指定 k(1–50 篇文章)和 days(往回搜尋的天數),或設定 allow_all_dates 以搜尋完整的涵蓋時間範圍。

  • 排除不想要的來源 — 使用 exclude_domain 跳過特定網域,但請注意,同一網域不能同時出現在 domainexclude_domain 中。

  • 取得結構化的文章摘要 — 每筆結果都會回傳文章標題、URL、發布日期及相符的文字摘要,讓您的 AI 能附上來源來總結報導內容。

文件

Connect your AI client - Cursor, Claude, or ChatGPT - to Webz.io News Search. The client gets a news_search_by_webz tool and can search global news by itself.

https://news-search-mcp.webz.io/mcp

Every tool call runs a regular News Search request with your token - the same credits and rate limits apply. See Errors, Rate Limits & Credits.

Step 1: Get your API token

Log in at webz.io and copy the API token from your dashboard. It is the same token you use for the News Search API.

Step 2: Connect your client

Replace YOUR_WEBZ_TOKEN with your token.

Cursor

Add this to ~/.cursor/mcp.json (%USERPROFILE%\.cursor\mcp.json on Windows) and restart Cursor:

{
  "mcpServers": {
    "webz-news-search": {
      "url": "https://news-search-mcp.webz.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_WEBZ_TOKEN"
      }
    }
  }
}

Claude Desktop

Merge the same webz-news-search entry into your Claude Desktop config file - do not replace the whole file - then restart Claude Desktop:

OSConfig file
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json

Claude Code

Run in your project root:

claude mcp add --transport http webz-news-search https://news-search-mcp.webz.io/mcp --header "Authorization: Bearer YOUR_WEBZ_TOKEN"

Claude.ai and ChatGPT (web)

Add https://news-search-mcp.webz.io/mcp as a custom connector (Claude.ai: Settings > Connectors; ChatGPT: Settings > Apps & Connectors with Developer mode on). Both use OAuth: leave Client ID and Secret empty, then paste your Webz token on the authorize page. Full step-by-step walkthroughs: news-search-mcp.webz.io.

Opening the /mcp endpoint in a browser returns 401 Unauthorized by design - browsers do not send your token. Use an MCP client.

Step 3: Try it

Ask your AI client naturally - mentioning "news" or "Webz" helps it pick the tool:

  • "Search Webz news for recent developments on EU AI regulation and summarize with sources."
  • "Use the Webz news tool to find coverage of trade agreements between Israel and Greece from the past week."
  • "Call news_search_by_webz for 'renewable energy investments' with k=10 and days=30, then summarize."

Tool reference

news_search_by_webz

ParameterDefaultDescription
queryrequiredNatural-language topic or question
k10Articles to return (1-50)
days7How many days back to search
allow_all_datesfalseSearch the full coverage window instead of days
domain-Only these source domains, e.g. cnn.com, yahoo.com
exclude_domain-Skip these source domains; a domain cannot be in both lists
language, country, sentiment, category-Same values as Filters; country codes are ISO-2 uppercase (US, GB)

Each result returns the article title, URL, publish date, and the matching text excerpt.

Keep your token safe

Never commit your token to git or put it in a URL.

Set it once as an environment variable and reference it from the config:

"Authorization": "Bearer ${env:WEBZ_API_TOKEN}"

Next steps

  • Add the Agent Skill so your agent knows when and how to search
  • Review Filters for all filter values