内容
<p align="center"><img src="icon-400.png" width="96" alt="新闻快讯" /></p>
# 新闻快讯
[](https://www.npmjs.com/package/newsflash)
[](https://smithery.ai/servers/newsflash/newsflash)
**五年来的新闻事件，由智能代理查询**
[newsflash.sh](https://newsflash.sh) 监控超过260个新闻来源，跨越多个地域和语言，将噪音压缩成 **去重事件图** —— 一个事件，多个来源证实，一个置信度评分 —— 实时更新，**回溯五年**，让智能代理可以历史回测并实时行动。服务通过 **MCP**、**CLI**、**实时SSE流** 和普通的 **HTTP API** 提供。
人类阅读；智能代理查询。无需账户即可开始。
```bash
# 无密钥测试 - 每天50次请求，直接从shell开始
npx newsflash events -q "etf" -c crypto -n 5
npx newsflash stream -c crypto --min-sources 2 # 实时新闻流，仅限证实
curl "https://newsflash.sh/api/events?q=fed&category=tradfi&limit=5"
```
## MCP（主要 - 面向智能代理）
事件图通过MCP的Streamable HTTP传输协议在 `https://newsflash.sh/mcp` 提供 - 在官方MCP注册表中列为 `sh.newsflash/newsflash`。任何MCP主机都可以指向它：
```jsonc
// Claude Code / Claude Desktop - 远程MCP服务器
{
"mcpServers": {
"newsflash": {
"type": "http",
"url": "https://newsflash.sh/mcp",
"headers": { "Authorization": "Bearer nf_your_key" } // 可选 - 提高限制
}
}
}
```
Claude Code插件安装：
/plugin marketplace add zatmonkey/newsflash
/plugin install newsflash@newsflash
该端点是无状态的（每个请求独立）。工具：`get_events`、`get_event`、`search_articles`、`list_sources`、`corpus_stats`。Claude、Cursor、ChatGPT等主机设置指南：[newsflash.sh/docs](https://newsflash.sh/docs)。
## OpenClaw
一个现成的技能在此仓库中（[`skills/newsflash/`](skills/newsflash/)）- 个性化每日简报 + 实时突发新闻提醒：
```
openclaw skills install git:zatmonkey/newsflash --as newsflash
```
然后告诉你的智能代理“设置我的新闻简报”。它会询问你的兴趣，安排每日简报，并（如果你启用提醒）监控实时流，当新闻达到你的证实阈值时提醒你。
## CLI
一个独立的、**零依赖**的npm包（[`./cli`](cli/)，发布为 [`newsflash`](https://www.npmjs.com/package/newsflash)）：
```bash
npm i -g newsflash
newsflash events -q "etf" -c crypto --from 2026-07-10 -n 5
newsflash events --json -q fed | jq '.[0].sources' # --json for agents
newsflash sources
newsflash stats
newsflash login you@example.com # 通过电子邮件一次性代码获取免费API密钥
newsflash me # 层级 + 今日用量
```
## HTTP API
基准URL `https://newsflash.sh`:
| 方法 | 路由 | 目的 |
| --- | --- | --- |
| GET | `/api/events?q=&source=&category=&from=&to=&limit=` | 去重事件 |
| GET | `/api/events/:id` | 一个事件 + 证实文章 |
| GET | `/api/articles?…` | 原始文章搜索 |
| GET | `/api/sources` | 跟踪来源 + 计数 |
| GET | `/api/stats` · `/api/health` | 语料库大小和新鲜度 |
| GET | `/api/stream` | **实时SSE推送** - `event.new` / `event.corroborated` 当聚类提交 |
| POST | `/mcp` | MCP服务器（Streamable HTTP）- 面向智能代理的接口 |
分类：`crypto` `tradfi` `business` `tech` `politics` `world` `science` `health` `energy` `sports`。
## 层级
| 层级 | 认证 | 限制 | 方式 |
| --- | --- | --- | --- |
| **测试** | 无 | 50请求/天（每个IP）· 24小时回溯 · 1个流 | 直接调用API或MCP端点 |
| **免费** | API密钥 | 1,000请求/天 · 30天回溯 · 2个流 | `newsflash login` - 电子邮件 + 一次性代码 |
| **高级** | 订阅 | 50,000请求/天 · **完整5年存档** · 10个流 | `newsflash upgrade` - $29/月 |
将密钥作为 `Authorization: Bearer nf_…` （或 `x-api-key`）传递 - REST和 `/mcp` 的同一网关。每个响应都带有 `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-Newsflash-Tier`；限制在UTC凌晨重置。密钥仅显示一次，并存储为哈希。
## 事件图工作原理
新文章通过三元组相似度与近期事件进行标准化和匹配 - **跨类别**，因此加密货币和传统金融的新闻来源报告同一事件时会证实一个事件。在相似度阈值之上 → 文章会附加到事件并提高其证实度；否则，它会引发一个新事件。`confidence = min(1, distinct_sources / 3)` - 一个事件由3个或更多独立新闻来源证实，置信度最高。
这使得图成为一个 **信号** 仪器：智能代理可以区分单个新闻来源的谣言（`confidence 0.33`）和整个新闻界都在报道的新闻（`confidence 1.0`，来源列出），并查询完整存档以历史回测。
## 关于此仓库
此仓库包含Newsflash的开源（MIT）客户端界面：零依赖 **CLI**（[`cli/`](cli/)），**Claude Code插件** 清单（[`.claude-plugin/`](.claude-plugin/)），以及 **MCP注册表清单**（[`server.json`](server.json)）。Newsflash后端是一个托管服务，在 [newsflash.sh](https://newsflash.sh) 运行，不属于此仓库。
CLI开发：`cd cli && npm install && npm run build && node dist/index.js stats`。无运行时依赖 - 仅需Node ≥ 20内置模块。
---
[文档](https://newsflash.sh/docs) · [来源](https://newsflash.sh/sources) · [隐私](https://newsflash.sh/privacy) · [条款](https://newsflash.sh/terms) · 联系邮箱：contact@newsflash.sh
