关于 AllNewsAPI
AllNewsAPI 是用于搜索近期和历史新闻、获取头条的 MCP 服务,面向需要新闻数据的 MCP 客户端。它支持关键词、日期、地区、类别、发布方及 AI 分析筛选,并可查询 API 用量。
主要功能
- 01搜索近期和历史文章
- 02获取经过筛选的头条
- 03按日期、主题和发布方筛选
- 04使用情感和实体筛选
- 05查询方案与剩余配额
适用场景
- 01查找指定日期范围内的主题报道
- 02获取某国家或类别的头条
- 03查看新闻的情感和实体信息
- 04请求前检查 API 限额
MCP 相关
该服务向 MCP 客户端提供新闻搜索、头条获取和用量查询工具。可连接托管的远程服务,也可通过 npx 本地运行;使用时需要 API 密钥。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.allnewsapi.com/mcpclaude mcp add --transport http allnewsapi https://mcp.allnewsapi.com/mcp{"mcpServers":{"allnewsapi":{"type":"http","url":"https://mcp.allnewsapi.com/mcp"}}}在 Cursor 中打开{"servers":{"allnewsapi":{"type":"http","url":"https://mcp.allnewsapi.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"allnewsapi":{"type":"http","url":"https://mcp.allnewsapi.com/mcp"}}}{"mcpServers":{"allnewsapi":{"serverUrl":"https://mcp.allnewsapi.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://mcp.allnewsapi.com/mcp需要授权工具
详细介绍
AllNewsAPI MCP
通过 AllNewsAPI,获取来自全球来源的实时和历史新闻数据,包括头条新闻。支持多种筛选选项,包括关键词搜索、类别、语言等。此 Model Context Protocol 服务允许 MCP 客户端(Claude、Cursor、VS Code、Windsurf 等)搜索新闻文章、获取头条新闻并查看 API 使用情况。
你需要一个 API 密钥,可前往 allnewsapi.com 获取。
快速开始
选择以下两种连接方式之一。
托管服务(无需安装)
将客户端指向托管服务,并在 X-API-Key 标头中传入 API 密钥:
{
"mcpServers": {
"allnewsapi": {
"type": "remote",
"url": "https://mcp.allnewsapi.com/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY_HERE"
}
}
}
}
更倾向于仅使用 URL 的配置?可使用 https://mcp.allnewsapi.com/mcp?apikey=YOUR_API_KEY_HERE 替代标头。
密钥可以通过以下三种方式提供,优先级依次递减:X-API-Key 标头、apikey 查询参数,或 Authorization: Bearer YOUR_API_KEY_HERE 标头(适用于仅支持 Bearer 令牌的客户端)。
本地(npx)
通过 npx 在你的计算机上运行服务——无需克隆或构建:
{
"mcpServers": {
"allnewsapi": {
"command": "npx",
"args": ["allnewsapi-mcp@latest", "--apikey", "YOUR_API_KEY_HERE"]
}
}
}
你也可以通过 ALLNEWSAPI_KEY 环境变量提供密钥,以替代 --apikey。
针对特定客户端的配置
Claude Desktop
编辑配置(Settings → Developer → Edit Config),并添加上方的本地或托管配置片段。完整指南:modelcontextprotocol.io/quickstart/user。
Cursor
Cursor Settings → MCP → Add new MCP Server。将其命名为 "AllNewsAPI",选择 command 类型,并输入:
npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE
VS Code
code --add-mcp '{"name":"allnewsapi","command":"npx","args":["allnewsapi-mcp@latest","--apikey","YOUR_API_KEY_HERE"]}'
随后,该服务即可供你的 GitHub Copilot Agent 使用。完整指南:VS Code MCP docs。
Windsurf
将上方的本地或托管配置片段添加到你的 MCP 配置中。完整指南:Windsurf MCP docs。
Claude Code
从终端添加——本地方式:
claude mcp add allnewsapi -- npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE
或使用托管服务:
claude mcp add --transport http allnewsapi https://mcp.allnewsapi.com/mcp --header "X-API-Key: YOUR_API_KEY_HERE"
Claude Cowork
Cowork 在 Claude Desktop 中运行。将托管服务添加为自定义连接器——Customize → Connectors → +——并输入包含密钥的 URL:
https://mcp.allnewsapi.com/mcp?apikey=YOUR_API_KEY_HERE
如需本地配置,请使用上方的 Claude Desktop 配置。
OpenWork
OpenWork 是一款支持 MCP 的开源 Cowork 替代品。按照 OpenWork 的 MCP 配置,使用本地命令(npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE)或上方的托管 URL 添加 AllNewsAPI。
**其他任何 MCP 客户端:**将其指向托管 URL(https://mcp.allnewsapi.com/mcp),或运行 npx allnewsapi-mcp@latest 命令并提供 API 密钥。
工具
search-news
按关键词、日期和筛选条件搜索文章。
| Parameter | Type | Description |
|---|---|---|
q | string | 要搜索的关键词 |
startDate / endDate | string | 日期范围(YYYY-MM-DD) |
content | boolean | 是否包含文章全文(默认值:false) |
lang | string | 语言代码,可指定多个,例如 en、fr |
country | string | 国家代码,可指定多个,例如 us、gb |
region | string | 地区,可指定多个,例如 americas、europe |
category | string | 类别,可指定多个,例如 business |
max | number | 文章数量,1–100(默认值:5) |
page | number | 页码(默认值:1) |
attributes | string | 匹配关键词的位置:title、description、content |
sortby | string | publishedAt 或 relevance |
publisher | string | 按出版方筛选,可指定多个 |
ai_sentiment | string | positive、negative 或 neutral |
ai_entity_name | string | 命名实体,例如 Apple |
ai_entity_type | string | 实体类型,例如 person、organization、location |
headlines
获取头条新闻,可选择应用筛选条件。
| Parameter | Type | Description |
|---|---|---|
country | string | 国家代码,可指定多个,例如 us、gb |
category | string | 类别,例如 technology |
lang | string | 语言代码,例如 en |
max | number | 文章数量,1–100(默认值:5) |
ai_sentiment | string | positive、negative 或 neutral |
ai_entity_name | string | 命名实体,例如 Apple |
ai_entity_type | string | 实体类型,例如 person、organization、location |
usage
查看你的套餐、请求限制和剩余配额。无需参数。
套餐说明: 高级筛选条件——
country、region、category、publisher、lang、attributes和sortby——需要付费套餐。免费套餐可使用search-news搭配q和max。请参阅定价。
AI 筛选
search-news 和 headlines 支持 AI 分析筛选条件:
ai_sentiment— 文章整体情感(positive、negative、neutral)ai_entity_name— 文章中的命名实体(例如United Nations)ai_entity_type— 实体类别(person、organization、location)
在可用时,返回的文章还可能包含 AI 情感评分、检测到的实体和简短的 AI 摘要。
示例提示词
- “获取美国最新的科技新闻”
- “查找欧洲来源的气候变化相关文章”
- “显示过去一周的商业头条”
- “查找关于可再生能源的正面新闻”
- “显示提及 Apple 且将其列为组织的文章”
- “查看我的 API 使用情况和剩余配额”
支持的值
AllNewsAPI 文档中列出了所有接受的值:
许可证
MIT © AllNewsAPI — 详情请参阅 LICENSE。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。