NewsMCP — World news for AI agents
newsmcp.io • integrations • REST API
______________________________________________________________________
实时新闻事件，由人工智能从数百个来源聚类，按主题和地理位置分类，按重要性排序。
免费。没有API密钥。一个安装命令。
覆盖
12主题 — politics economy technology science health environment sports culture crime military education society
30个地区 --6大洲24个国家。筛选依据 europe, asia, united-states, germany, japan, ukraine以及更多。
数百个来源 --文章按来源数量和影响评分实时分组到事件中。
集成
| 平台 | 软件包 | 安装 |
|---|---|---|
| 克劳德桌面版 | @newsmcp/server | MCP配置 |
| Claude代码插件 | newsmcp | /plugin install |
| 克劳德代码MCP | @newsmcp/server | claude mcp add |
| 光标 | @newsmcp/server | MCP配置 |
| 帆板运动 | @newsmcp/server | MCP配置 |
| OpenAI Codex | @newsmcp/server | codex mcp add |
| 双子星命令行工具 | @newsmcp/server | settings.json |
| 开源代码 | @newsmcp/server | opencode mcp add |
| 铁匠铺 | @newsmcp/server | npx @smithery/cli |
| OpenClaw插件 | @newsmcp/openclaw | openclaw plugins install |
| 开爪技能 | newsmcp-skill | clawhub install |
| REST API | — | curl https://newsmcp.io/v1/news/ |
克劳德桌面版
添加 claude_desktop_config.json:
{
"mcpServers": {
"newsmcp": {
"command": "npx",
"args": ["-y", "@newsmcp/server"]
}
}
}Claude代码插件
/plugin marketplace add pranciskus/newsmcp
/plugin install newsmcp克劳德代码MCP
claude mcp add newsmcp -- npx -y @newsmcp/server光标
添加 .cursor/mcp.json:
{
"mcpServers": {
"newsmcp": {
"command": "npx",
"args": ["-y", "@newsmcp/server"]
}
}
}帆板运动
添加到MCP配置：
{
"mcpServers": {
"newsmcp": {
"command": "npx",
"args": ["-y", "@newsmcp/server"]
}
}
}OpenAI Codex
codex mcp add newsmcp -- npx -y @newsmcp/server或添加到 ~/.codex/config.toml:
[mcp_servers.newsmcp]
command = "npx"
args = ["-y", "@newsmcp/server"]双子星命令行工具
添加 ~/.gemini/settings.json （或项目本地 .gemini/settings.json):
{
"mcpServers": {
"newsmcp": {
"command": "npx",
"args": ["-y", "@newsmcp/server"]
}
}
}开源代码
opencode mcp add或添加到 ~/.config/opencode/opencode.json （或项目本地 .opencode/opencode.json):
{
"mcp": {
"newsmcp": {
"type": "local",
"enabled": true,
"command": ["npx", "-y", "@newsmcp/server"]
}
}
}铁匠铺
npx -y @smithery/cli install @newsmcp/server --client claudeOpenClaw插件
openclaw plugins install @newsmcp/openclaw无需配置——开箱即用。看 @newsmcp/openclaw 选择。
开放式法律技能
clawhub install newsmcp-skillMCP工具
四个工具。这就是界面。
get_news
目前正在发生的重大事件。按主题、地区、时间窗口过滤。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
topics | string | -- | 逗号分隔的主题段： politics,technology |
geo | string | -- | 逗号分隔的区域块： europe,lithuania |
hours | number | 24 | 时间窗口（小时）（1–168） |
page | number | 1 | 页码 |
per_page | number | 20 | 每页结果（最多50个） |
order_by | 字符串 | -sources_count | 排序字段（见下文） |
排序选项: -sources_count, -impact_score, -last_seen_at, -entries_count （前缀 - 下降）
get_news_detail
单个事件的全部细节——所有源文章、人工智能生成的上下文、影响分析、实体标签。
| 参数 | 类型 | 说明 |
|---|---|---|
event_id | string | 事件UUID来自 get_news 结果 |
get_topics
列出可用于筛选的每个主题类别。无参数。
crime culture economy education environment health military politics science society sports technology
get_regions
列出可用于过滤的每个地理区域（6大洲和24个国家）。无参数。
代理商如何使用它
| 提示 | 发生了什么 |
|---|---|
| “世界上发生了什么？” | get_news 默认情况下--按源覆盖率列出的前20个事件 |
| “今天欧洲有什么科技新闻吗？” | get_news 随着 topics=technology, geo=europe, hours=24 |
| “告诉我更多关于那次地震的信息” | get_news_detail 带有事件UUID |
| “我可以根据哪些主题进行筛选？” | get_topics --返回完整列表 |
| “本周给我看亚洲新闻” | get_news 随着 geo=asia, hours=168 |
REST API
不需要MCP？直接点击端点。相同的数据，相同的过滤器。
基础URL: https://newsmcp.io/v1
| 方法 | 端点 | 描述 |
|---|---|---|
GET | /news/ | 使用可选过滤功能列出新闻事件 |
GET | /news/{id}/ | 单次活动，包含完整文章列表 |
GET | /news/topics/ | 所有主题类别 |
GET | /news/regions/ | 所有地理区域 |
查询参数
所有参数都是可选的。自由组合。
# Latest events
curl -s https://newsmcp.io/v1/news/ | jq
# Filter by topic
curl -s "https://newsmcp.io/v1/news/?topics=technology" | jq
# Filter by region
curl -s "https://newsmcp.io/v1/news/?geo=europe" | jq
# Last 12 hours, sorted by impact
curl -s "https://newsmcp.io/v1/news/?hours=12&order_by=-impact_score" | jq
# Combine everything
curl -s "https://newsmcp.io/v1/news/?topics=politics&geo=united+states&hours=48&per_page=5" | jq响应格式
{
"events": [
{
"id": "cc3428ab-2ada-41bb-86ab-833fd39ffd8d",
"summary": "Event description with AI-generated context...",
"topics": ["technology", "politics"],
"geo": ["united states"],
"entries_count": 86,
"sources_count": 45,
"first_seen_at": "2026-02-15T04:06:41.728Z",
"last_seen_at": "2026-03-03T05:00:30Z",
"impact_score": 8,
"entries": [
{
"title": "Article headline",
"url": "https://source.com/article",
"domain": "source.com",
"published_at": "2026-03-03T05:00:30Z"
}
]
}
],
"total": 142,
"page": 1,
"per_page": 20
}运作原理
- 收集 --数百条新闻来源不断被抓取
- 簇 --关于同一事件的文章使用向量嵌入进行分组
- 分类 --每个事件都标记了主题和地理实体
- 排名 --事件按来源计数、影响和近期程度评分
- 服务 -通过REST API和MCP服务器清理JSON
随着新文章的出现，事件会实时更新。聚类AI会自动合并重复的覆盖范围。
配置
指向不同的API后端：
{
"mcpServers": {
"newsmcp": {
"command": "npx",
"args": ["-y", "@newsmcp/server"],
"env": {
"NEWS_API_BASE_URL": "https://your-api.example.com/v1"
}
}
}
}发布（GitHub操作+OIDC）
发布是通过标签驱动的 :
- 触发器：推标签
v*.*.* - 出版
@newsmcp/server和@newsmcp/openclaw通过可信发布（OIDC）访问npm - 发布MCP元数据
mcp-publisher login github-oidc - 使用生成的笔记创建GitHub版本
一次性设置
- npm包设置：
对于 @newsmcp/server 和 @newsmcp/openclaw，添加一个受信任的发布者，指向： - 业主： pranciskus - 存储库： newsmcp - 工作流文件： .github/workflows/release.yml - 环境：留空（除非您有意使用）
- MCP注册表：
确保回购/包已授权在MCP注册表中发布GitHub OIDC。
释放流量
- 凹凸版本：
- packages/mcp-server/package.json - packages/openclaw-plugin/package.json - packages/mcp-server/server.json - package-lock.json
- 承诺并推动
main - 创建并推送标签：
git tag -a vX.Y.Z -m "vX.Y.Z"
git push origin vX.Y.Z工作流会自动执行发布和GitHub发布。
存储库结构
newsmcp/
├── .github/workflows/ # CI/CD workflows (release automation)
├── .claude-plugin/ # Marketplace manifest
├── packages/
│ ├── mcp-server/ # @newsmcp/server — MCP server (npm)
│ ├── claude-code-plugin/ # newsmcp — Claude Code plugin
│ ├── openclaw-plugin/ # @newsmcp/openclaw — OpenClaw plugin (npm)
│ └── skill/ # newsmcp-skill — OpenClaw skill (ClawHub)
├── publish.sh # Build, test, publish workflow
├── README.md
└── LICENSE许可证
麻省理工学院