newsflash

Newsflash

五年来经过多方佐证的新闻事件，可供 Agent 查询。 newsflash.sh 监测不同地区和语言的 260 多家媒体，并将海量信息整合为去重后的事件图谱——一件事、所有佐证来源以及置信度评分——实时更新，并且回溯覆盖五年历史，让 Agent 能够基于历史数据进行回测，并对实时信息采取行动。通过 MCP、CLI、实时 SSE 流和普通 HTTP API 提供服务。

人类阅读，Agent 查询。无需账号即可开始使用。

面向 Agent： Newsflash 是一项托管服务——newsflash.sh 是一个 域名，不是 shell 脚本。无需安装本地二进制文件或服务： 直接调用 https://newsflash.sh/api/*（REST）或 https://newsflash.sh/mcp（MCP）。 可使用 curl "https://newsflash.sh/api/events?limit=1" 验证。

# keyless test drive — 50 requests/day, straight from your shell
npx newsflash events -q "etf" -c crypto -n 5
npx newsflash stream -c crypto --min-sources 2   # the live wire, corroborated only
curl "https://newsflash.sh/api/events?q=fed&category=tradfi&limit=5"

MCP（主要方式——面向 Agent）

事件图谱通过 MCP 的 Streamable HTTP 传输协议在 https://newsflash.sh/mcp 上提供——已列入官方 MCP 注册表，名称为 sh.newsflash/newsflash，并收录于 Claude 的连接器目录（在 claude.ai 或 Claude Desktop 中：Settings → Connectors → Browse connectors → 搜索 "Newsflash" → Connect）。对于其他 MCP 主机，将其指向此 URL：

// Claude Code / Claude Desktop — remote MCP server
{
  "mcpServers": {
    "newsflash": {
      "type": "http",
      "url": "https://newsflash.sh/mcp",
      "headers": { "Authorization": "Bearer nf_your_key" }   // optional — raises limits
    }
  }
}

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。

OpenClaw

此仓库附带一个现成的技能（skills/newsflash/）—— 个性化每日简报 + 实时突发新闻提醒：

clawhub install newsflash        # or: openclaw skills install git:zatmonkey/newsflash

然后告诉你的 Agent“设置我的新闻简报”。它会询问你的兴趣， 安排每日简报，并且（如果你启用了提醒）监控实时信息流， 在某条新闻达到你的佐证阈值时向你发送通知。

CLI

一个独立的、零依赖 npm 包（./cli，发布为 newsflash）：

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 [email protected]    # free API key via emailed one-time code
newsflash me                       # tier + today's usage

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）——面向 Agent 的接口

类别：crypto tradfi business tech politics world science health energy sports。

OpenAPI

完整的 REST 接口详见 openapi.yaml——这是一份 OpenAPI 3.1 规范，包含上述每个端点的精确请求/响应架构 （包括 SSE 流和身份验证流程），由实时 API 生成。将其导入 Pipedream、RapidAPI、Postman 或自定义 GPT Action，即可通过你自己的工具使用 Newsflash， 也可以使用任意 OpenAPI 生成器生成类型化客户端。

套餐

套餐	身份验证	限额	方式
test	无	每天 50 次请求（按 IP 计算）· 回溯 24 小时 · 1 个数据流	直接调用 API 或 MCP 端点
free	API 密钥	每天 1,000 次请求 · 回溯 30 天 · 2 个数据流	newsflash login — 电子邮件 + 一次性验证码
premium	订阅	每天 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 家或更多独立媒体佐证的事件，其置信度达到上限。

这使图谱成为一种信号工具：Agent 可以区分单一媒体的传闻（confidence 0.33）与整个新闻界都在报道的事件（confidence 1.0，并列出来源），还可以查询完整档案，利用历史数据进行回测。

关于此代码库

此代码库包含 Newsflash 的开源（MIT）客户端部分：零依赖的 CLI（cli/）、Claude Code 插件清单（.claude-plugin/）以及 MCP 注册表清单（server.json）。Newsflash 后端是由 newsflash.sh 运营的托管服务，不属于此代码库。

CLI 开发：cd cli && npm install && npm run build && node dist/index.js stats。 无运行时依赖——仅使用 Node ≥ 20 内置功能。

---

文档 · 来源 · 隐私 · 条款 · [email protected]