newsintel

    _   __                 ____      __       __     ___    ____  ____
   / | / /__ _      _____|  _/___  / /____  / /    /   |  / __ \/  _/
  /  |/ / _ \ | /| / / __|/ // _ \/ __/ _ \/ /    / /| | / /_/ // /
 / /|  /  __/ |/ |/ /\__ \ // ___/ /_/  __/ /    / ___ |/ ____// /
/_/ |_/\___/|__/|__//___/___/\___/\__/\___/_/    /_/  |_/_/   /___/

为 AI Agent、MCP 集成和开发者工作流提供个性化新闻智能服务。
_{20+ 个来源。实时排名。适配 Agent 的摘要。自助式入门。}

试用门户  •  API 参考  •  MCP 服务  •  架构  •  参与贡献

---

为什么选择 NewsIntel？

大多数新闻 API 提供原始信息流。NewsIntel 提供的是智能信息——经过排名、去重并兼顾偏见的简报，可直接供 AI 使用。

• 面向 AI Agent：通过 MCP 或 REST，只需一次调用即可获取结构化简报
• 面向开发者：开箱即用的自助式 API 密钥、OpenAPI 架构和 Prometheus 指标
• 面向团队：多工作区隔离、由反馈驱动的排名和 Grafana 仪表板

# Get a personalized briefing in 10 seconds
curl -sS "https://newsintelapi.com/v1/briefing?format=digest&limit=6" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

功能

 INGEST           PROCESS              DELIVER             OBSERVE
 ------           -------              -------             -------
 RSS (20+)  -->  Dedup & Normalize    REST API            Prometheus
 GDELT       -->  Bias-aware ranking   Agent digests       Grafana
 Guardian    -->  Topic inference      MCP server          Sentry
 X signals   -->  Feedback loop        Self-serve portal   OpenTelemetry

	功能	详情
新闻	多来源聚合	RSS（20+ 个来源）、GDELT、Guardian API、X 关注信号
AI	适配 Agent 的输出	/briefing/agent 端点 + 独立 MCP 服务
排名	智能筛选	偏见多样性门槛、来源可靠性评分、时效性加权
身份验证	多工作区	每个工作区独立的 API 密钥、动态密钥配置、X OAuth 自助服务
反馈	学习闭环	点赞/跳过/收藏/不相关等信号会影响后续排名
运维	可用于生产环境	Prometheus 指标、Grafana 仪表板、Sentry、OpenTelemetry

快速开始

选项 A：使用托管 API（推荐）

1. 打开 newsintelapi.com/portal
2. 使用 X（OAuth）连接并获取 API 密钥
3. 开始发送请求

对于 AI Agent，可使用 MCP 服务进行原生工具集成。

选项 B：使用 Docker 自托管（安全基线）

git clone https://github.com/stabem/newsintel-api.git && cd newsintel-api
cp .env.example .env
# REQUIRED before first run: replace all CHANGE_ME_* placeholders in .env
# example internal DB URL: postgresql://newsintel:<strong-password>@postgres:5432/newsintel
# generate strong secrets, e.g.:
#   API_KEYS=$(openssl rand -hex 24)
#   OPS_ADMIN_KEY=$(openssl rand -hex 32)
#   TOKEN_ENCRYPTION_SECRET=$(openssl rand -hex 32)

docker compose up --build -d

# Verify
curl -sS http://localhost:8090/healthz

主 docker-compose.yml 默认安全：不包含内置的弱数据库/Grafana 凭据，也不会发布 Postgres/Redis 端口。在非临时本地测试环境中使用前，仍必须替换 .env 中的 CHANGE_ME_* 占位符。

选项 C：本地开发

npm ci && cp .env.example .env
# For local dev, replace the CHANGE_ME_* placeholders with local-only values first.
docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d postgres redis
npm run migrate:up && npm run dev

如需使用带有便捷默认值并发布开发端口的一体化本地堆栈：

docker compose -f docker-compose.yml -f docker-compose.dev.yml up --build -d

本地开发服务：API localhost:8090 | Postgres localhost:5436 | Redis localhost:6386

API 概览

完整参考文档：docs/api-reference.md | OpenAPI 架构：GET /openapi.json

方法	端点	身份验证	描述
GET	/healthz	-	存活检查
GET	/readyz	-	就绪状态（DB/Redis/队列）
GET	/metrics	-	Prometheus 指标
GET	/v1/briefing	Bearer	个性化简报
GET	/v1/briefing/agent	Bearer	针对 Agent 优化的摘要
GET	/v1/news/search	Bearer	搜索并汇总新闻
POST	/v1/profile/sync	Bearer	同步个人资料（manual/x-browser/x-api）
POST	/v1/keys	Bearer	配置动态 API 密钥
GET	/v1/ops/status	Admin	运维健康仪表板

AI 集成

MCP 服务（适用于 Claude Desktop、Cursor、Windsurf 等）

提供独立的 MCP 服务，可接入任何兼容 MCP 的客户端：

cd integrations/newsintel-mcp && npm install

或添加到 .mcp.json：

{
  "mcpServers": {
    "newsintel": {
      "command": "node",
      "args": ["integrations/newsintel-mcp/server.mjs"],
      "env": { "NEWSINTEL_API_BASE": "https://newsintelapi.com" }
    }
  }
}

工具：sync_profile | get_profile | get_news_briefing

完整文档请参阅 integrations/newsintel-mcp/README.md。

Anthropic SDK（工具调用 + Agent）

构建将 NewsIntel 用作工具的 AI Agent，示例涵盖 TypeScript 和 Python：

# TypeScript — agentic loop
cd examples/agent-sdk-typescript && npm install
ANTHROPIC_API_KEY=sk-... NEWSINTEL_API_KEY=ni_live_... npx tsx agent.ts

# Python — agentic loop
cd examples/agent-sdk-python && pip install -r requirements.txt
ANTHROPIC_API_KEY=sk-... NEWSINTEL_API_KEY=ni_live_... python agent.py

工具调用和 Agent 模式请参阅 examples/。

架构

                     +------------------+
                     |   Self-serve     |
                     |   Portal (HTML)  |
                     +--------+---------+
                              |
  AI Agents (MCP) --+        |        +-- Prometheus
                    |        v        |
                    +-> [ Fastify ] <--+-- Grafana
                    |   [ API    ]    |
                    +-> [ Server ] <--+-- Sentry
                        +---+---+
                            |
            +-------+-------+-------+-------+
            |       |       |       |       |
          RSS    GDELT  Guardian  X API   pg-boss
         (20+)                           (queue)
            |       |       |       |       |
            +-------+-------+---+---+-------+
                                |
                    +-----------+-----------+
                    |                       |
                PostgreSQL              Redis
              (profiles, news,       (briefing cache,
               feedback, jobs)        enrichment cache)

文档

文档	描述
docs/architecture.md	系统概览和数据流
docs/api-reference.md	端点、参数和示例
docs/configuration.md	环境变量
docs/observability.md	指标、日志和追踪
docs/operations.md	Docker、加固和故障排查
SECURITY.md	漏洞报告、凭据轮换
SUPPORT.md	社区支持渠道

开发

npm run lint         # Biome linter
npm run typecheck    # TypeScript type checking
npm test             # Full test suite (127 tests)
npm run build        # Compile to dist/

OpenAPI 契约快照：架构变更时运行 npm run test:openapi-snapshot:update。

贡献

完整指南请参阅 CONTRIBUTING.md。

1. Fork 并创建功能分支
2. 进行范围明确且包含测试的更改
3. 运行：npm run lint && npm run typecheck && npm test && npm run build
4. 提交 PR 并关联相关 issue

路线图

完整路线图请参阅 docs/OPEN_SOURCE_ROADMAP.md。

• 源注册表：基于文件 -> 由 DB 管理
• 新闻持久化：优化批量插入
• API 分页和更丰富的查询语义
• 用于自定义新闻提供方的插件系统

Star 历史

许可证

ISC - 随你使用。

---

_{基于 Fastify、TypeScript、PostgreSQL、Redis 和 pg-boss 构建。
如果 NewsIntel 有助于你的工作流，请给仓库点个 Star。}