World News Api Mcp

World News API MCP 服务

一个可访问 World News API 的模型上下文协议（MCP）服务。该服务可让 AI 助手通过 MCP 协议搜索新闻、获取头条新闻、提取文章、检索报纸头版等。

功能特性

• 新闻搜索：按文本、日期、地点、类别、语言等搜索和筛选新闻
• 头条新闻：获取任意国家、任意语言的头条新闻
• 报纸头版：检索世界各地报纸的头版
• 文章提取：从新闻 URL 提取完整文章
• 新闻链接发现：从网站提取新闻链接
• 来源搜索：查找受监测的新闻来源
• 地点坐标：获取基于地点筛选所需的地理坐标
• 内容分析：提取实体、检测情感等

快速开始

安装

npm install -g world-news-api-mcp

设置

1. 获取 World News API 密钥（可在 https://worldnewsapi.com/register 免费注册）

2. 将 API 密钥设置为环境变量：

   # Windows (PowerShell)
   $env:WORLD_NEWS_API_KEY="your_api_key_here"
   
   # macOS/Linux
   export WORLD_NEWS_API_KEY="your_api_key_here"
   

与 MCP 客户端搭配使用

将此配置添加到 MCP 客户端（Claude Desktop 等）：

{
  "servers": {
    "world-news-api": {
      "command": "world-news-api-mcp",
      "env": {
        "WORLD_NEWS_API_KEY": "your_api_key_here"
      }
    }
  }
}

测试安装

# Set your API key
export WORLD_NEWS_API_KEY="your_key_here"

# Test the server
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | world-news-api-mcp

可用工具

search_news

按文本、日期、地点、类别、语言等搜索和筛选新闻。

参数：

• text（字符串，可选）：要在新闻内容中匹配的文本（至少 3 个字符）
• source-country（字符串，可选）：ISO 3166 国家/地区代码（例如，“us”“gb”）
• language（字符串，可选）：ISO 6391 语言代码（例如，“en”“es”）
• min-sentiment / max-sentiment（数字，可选）：情感范围 [-1,1]
• earliest-publish-date / latest-publish-date（字符串，可选）：日期范围（YYYY-MM-DD HH:MM:SS）
• news-sources（字符串，可选）：以逗号分隔的来源列表
• authors（字符串，可选）：以逗号分隔的作者列表
• categories（字符串，可选）：类别（政治、体育、商业、科技等）
• entities（字符串，可选）：按实体筛选（ORG:Tesla,PER:Elon Musk）
• location-filter（字符串，可选）："latitude,longitude,radius_km"
• sort（字符串，可选）：排序条件（publish-time）
• sort-direction（字符串，可选）：ASC 或 DESC
• offset（数字，可选）：要跳过的结果数量
• number（数字，可选）：要返回的结果数量（1-100，默认：10）

get_top_news

获取指定日期某个国家和语言的头条新闻。

参数：

• source-country（字符串，必需）：ISO 3166 国家/地区代码
• language（字符串，必需）：ISO 6391 语言代码
• date（字符串，可选）：日期（YYYY-MM-DD），默认为当天
• headlines-only（布尔值，可选）：仅返回基本信息（默认：false）

retrieve_newspaper_front_page

获取世界各地报纸的头版。

参数：

• source-country（字符串，可选）：ISO 3166 国家/地区代码
• source-name（字符串，可选）：出版物标识符（例如，“herald-sun”）
• date（字符串，可选）：日期（YYYY-MM-DD），最早为：2024-07-09

retrieve_news_articles

通过新闻文章 ID 检索指定文章的详细信息。

参数：

• ids（字符串，必需）：以逗号分隔的新闻 ID 列表

extract_news

从网站提取新闻文章，并整理为结构良好的 JSON 对象。

参数：

• url（字符串，必需）：新闻文章的 URL
• analyze（布尔值，可选）：分析内容（实体、情感等）

extract_news_links

从新闻网站提取新闻链接。

参数：

• url（字符串，必填）：新闻网站的 URL
• analyze（布尔值，可选）：分析提取的内容

search_news_sources

搜索 World News API 是否监控某个新闻来源。

参数：

• name（字符串，必填）：来源名称（或部分名称）

get_geo_coordinates

获取地点的纬度和经度，用于位置筛选。

参数：

• location（字符串，必填）：地址或地点名称

使用示例

搜索近期 AI 新闻

{
  "name": "search_news",
  "arguments": {
    "text": "artificial intelligence",
    "language": "en",
    "categories": "technology",
    "number": 5
  }
}

获取美国热门新闻

{
  "name": "get_top_news",
  "arguments": {
    "source-country": "us",
    "language": "en"
  }
}

从 URL 提取文章

{
  "name": "extract_news",
  "arguments": {
    "url": "https://www.bbc.com/news/world-us-canada-59340789",
    "analyze": true
  }
}

搜索某个地点附近的新闻

{
  "name": "search_news",
  "arguments": {
    "text": "earthquake",
    "location-filter": "35.6762,139.6503,50",
    "language": "en"
  }
}

开发

以开发模式运行：

npm run dev

构建：

npm run build

测试：

npm test

API 速率限制

World News API 根据订阅方案设有不同的速率限制：

• 免费方案：每天 150 次请求
• 付费方案：可享受更高的限额

详情请查看 World News API 定价。

错误处理

该服务会处理常见的 API 错误：

• 401 Unauthorized：API 密钥无效
• 402 Payment Required：API 配额已用尽
• 429 Too Many Requests：已超出速率限制

许可证

ISC

贡献

欢迎贡献！欢迎提交 Pull Request。

相关资源

• World News API 文档
• Model Context Protocol
• MCP SDK