环球地缘新闻 API

多语言地缘政治新闻接口，专为 AI 智能体（豆包 / DeepSeek 等）、深度研究与自动化场景设计。 按时间窗口拉取最近新闻，每条含外媒原文 + 中文翻译 + 摘要 + 来源 + 链接，最新在前，后台每 5 分钟更新。

1. 快速开始

第一步 · 获取令牌（Token）

1. 浏览器登录 news.ruilisi.com
2. 进入「我的订阅」→「API 令牌」区域
3. 填写名称（如 doubao-deep-research）→「新建令牌」
4. 复制弹窗里 nrk_ 开头的令牌 —— 只显示这一次，关闭后无法再查看

第二步 · 发起请求

curl -H "Authorization: Bearer nrk_你的令牌"   "https://news.ruilisi.com/api/v1/news?window=6h&theme=iran-me&limit=50"

返回最近 6 小时、伊朗·中东主题的新闻列表（JSON）。

2. 认证

所有请求通过 HTTP 头携带 Bearer 令牌：

Authorization: Bearer <你的令牌>

• 令牌与你的账号订阅绑定：试用期内或已订阅方可调用。
• 令牌可在「我的订阅」页随时撤销，撤销后立即失效。
• 请将令牌视作密码，不要写进前端代码或公开仓库。

3. 接口：获取新闻

GET https://news.ruilisi.com/api/v1/news

查询参数

时间窗口 window 取值

主题 theme

返回字段

返回示例

{
  "window": "6h",
  "window_label": "最近 6 小时",
  "since": "2026-06-20T00:00:00.000Z",
  "until": "2026-06-20T06:00:00.000Z",
  "total": 128,
  "count": 50,
  "limit": 50,
  "offset": 0,
  "items": [
    {
      "title": "Le Hezbollah félicite l'Iran",
      "title_translated": "真主党祝贺伊朗",
      "summary": "...",
      "summary_translated": "...",
      "author": "Agence France-Presse",
      "source": "Noovo Info",
      "theme": "iran-me",
      "lang": "fr",
      "link": "https://example.com/article",
      "published": "2026-06-20T05:12:00.000Z"
    }
  ]
}

错误码

4. 为 AI 智能体接入（重点）

本接口与 OpenAI 兼容的 Function Calling / 工具调用 范式天然契合（豆包、DeepSeek 等均支持）。把它注册为一个「联网新闻检索工具」即可。

工具定义（Function Calling Schema）

{
  "type": "function",
  "function": {
    "name": "get_geopolitics_news",
    "description": "获取指定时间窗口内的多语言地缘政治新闻（伊朗·中东 / 俄乌 / 南海·中日韩 / 半导体），含外媒原文与中文翻译。当任务涉及近期国际局势、冲突、能源、航运、制裁等时效性话题时调用。",
    "parameters": {
      "type": "object",
      "properties": {
        "window": {
          "type": "string",
          "enum": ["10m","1h","3h","6h","1d","2d","3d","7d","14d","30d"],
          "description": "时间窗口，默认 1h"
        },
        "theme": {
          "type": "string",
          "enum": ["iran-me","russia-ukraine","china-scs","cjkt-semi"],
          "description": "主题，可省略"
        },
        "q": { "type": "string", "description": "关键词，可省略" },
        "limit": { "type": "integer", "description": "返回条数，1-200，默认 50" }
      }
    }
  }
}

工具被调用后，由你的后端用上面的参数请求 GET /api/v1/news（带令牌），把 items 回填给模型即可。

给模型的工具描述模板（System / Tool 提示词）

当研究任务涉及近期国际局势、地缘冲突、能源/航运/制裁等时效性话题时，先调用 get_geopolitics_news 拉取最近 1h–7d 的一手新闻，再据此分析。优先使用 title_translated 与 summary_translated，并在结论中以 source 与 link 标注来源。

代码示例

Python

import requests

resp = requests.get(
    "https://news.ruilisi.com/api/v1/news",
    headers={"Authorization": "Bearer nrk_你的令牌"},
    params={"window": "1d", "theme": "russia-ukraine", "limit": 100},
    timeout=20,
)
resp.raise_for_status()
for it in resp.json()["items"]:
    print(it["published"], it["title_translated"] or it["title"], "—", it["source"])

JavaScript (fetch)

const r = await fetch(
  "https://news.ruilisi.com/api/v1/news?window=3h&theme=iran-me&limit=50",
  { headers: { Authorization: "Bearer nrk_你的令牌" } }
);
const data = await r.json();
console.log(data.total, data.items.map(i => i.title_translated));

最佳实践

• 窗口要贴合任务：实时盯盘用 10m–1h；当日综述用 1d；专题回溯用 7d–30d。
• 翻页：用 total 与 limit/offset 分页，单次最多 200 条。
• 去重：以 link 作为唯一键，跨多次调用去重。
• 缓存：后台每 5 分钟更新，客户端缓存 1–2 分钟即可，避免高频空轮询。
• 保护令牌：放服务端环境变量，切勿暴露在浏览器或客户端。

5. 配额与说明

• 单账号最多保留 20 个有效令牌（可撤销旧令牌后再建）。
• 数据为公开新闻聚合，仅供研究与信息用途；转载请遵循各来源媒体版权。
• 接口与字段如有调整，将在本页更新。

有问题或需要更高配额？请联系灵缇团队。