跳到正文

把 Gangway 接进你的 Agent

AGENT 接入

复制下面这段话，发给你的 Agent（Claude、Codex、Cursor、ChatGPT 等都行），它会自己接好并查一次给你看。匿名只读，不用注册，也不用 API Key。

服务正常版本 6.0.0

一键接入：复制发给 Agent

请帮我接入 Gangway（gangway.news，匿名只读，不需要 API Key）：如果你能添加远程 MCP，就把 https://gangway.news/api/mcp 添加为名叫 gangway 的 MCP 服务器（Streamable HTTP，无需认证）；如果不能，就按 https://gangway.news/api/v1/agent 的说明直接用 HTTP 读取。接好后调用一次 gangway_get_latest，告诉我过去 24 小时最重要的 5 条跨境投资资讯，并附 Gangway 链接。

手动接入

想自己配置，按用的工具选一种：MCP、RSS、API，读的是同一份数据。

MCP填一个地址，多出 7 个工具RSS复制地址，用阅读器订阅REST API匿名 GET，自己写程序取数
REST API · 6.0.0

匿名 GET，拿来就能用

不用 token；浏览器跨域、curl 和各语言默认的 HTTP 客户端都能直接调。路径是 /api/v1，字段和错误码以 OpenAPI 为准。

第一个请求
curl --compressed 'https://gangway.news/api/v1/items?mode=selected&window=24h&limit=20'

按分类筛选

在资讯请求中加上 category，只取对应分类；不传则包含全部分类。返回条目的 category 也使用下表中的值。

分类请求参数
监管category=regulation
公司category=company
市场category=market
银行category=banking
券商category=brokerage
交易所category=exchange
Web3category=web3
观点category=opinion
其他category=industry

用得省，也更快

  1. 01
    开压缩

    curl 加 --compressed，其他客户端打开 gzip 或 br。JSON 压缩后只有原来的 1/4 到 1/8。

  2. 02
    带上 ETag

    保存响应里的 ETag，下次带 If-None-Match；内容没变时返回 304，不传正文。

  3. 03
    按节奏取

    资讯和热点最快一分钟一次；日报每天 08:00 后取一次，周报、月报出刊后取一次；往回翻页翻到已有的那条就停。

内容多久变一次：新资讯全天陆续进来，精选每天变几次到几十次，日报每天 08:00、周报每周一 10:00、月报每月 1 日 10:30（北京时间）各一期。

接口一览

路径用来做什么多久取一次
资讯
/api/v1/items精选或最近 7 天全部动态，可按分类、时间窗、关键词筛最快 1 分钟一次
热点与事件
/api/v1/hot-topics当前热点榜 Top 10最快 1 分钟一次
/api/v1/stories/{publicId}一个事件的报道时间线、AI 综述和关联事件需要时
日报
/api/v1/dailies/latest最新一期日报每天 08:00 后一次
/api/v1/dailies/{date}指定日期日报；撤稿会移除引用缓存过期后使用前验证 ETag
/api/v1/dailies日报日期索引每天一次
周报与月报
/api/v1/weeklies/latest最新一期周报：头条、总述和一周重点，按栏目分好每周一 10:00 后一次
/api/v1/weeklies/{week}指定一周，ISO 周如 2026-W39；撤稿会移除引用缓存过期后使用前验证 ETag
/api/v1/weeklies周报索引每周一次
/api/v1/monthlies/latest最新一期月报每月 1 日 10:30 后一次
/api/v1/monthlies/{month}指定月份，如 2026-09缓存过期后使用前验证 ETag
/api/v1/monthlies月报索引每月一次
给 AI 助手
/api/v1/agent给 Agent 的使用说明，列出的地址返回整理好的中文 Markdown需要时
完整精选同步
/api/v1/selected/snapshot当前全部精选，分页一次拿全只在第一次
/api/v1/selected/changes之后的新增、修改和撤选几分钟一次

常见用法

bash
# 第一次：保存响应头里的 ETag
curl --compressed -i 'https://gangway.news/api/v1/items?mode=selected&window=24h&limit=20'
# 之后最快每分钟一次，带上 ETag；返回 304 就是没变化
curl --compressed -i -H 'If-None-Match: <上次的 ETag>' 'https://gangway.news/api/v1/items?mode=selected&window=24h&limit=20'

需要往回翻页时，把 page.nextCursor 作为 cursor 传回去，翻到已经有的那条就停，不要每次把 7 天重翻一遍。

出错了怎么办

400
参数不对：按 OpenAPI 和返回的 code 修正，不要自动换成更宽的查询。cursor 无效或滑出时间窗返回 invalid_cursor，从第一页重来。
409
snapshot_required：增量没法安全续上，重新取一次完整快照。
429
请求太密：按 Retry-After 等待，不要并发重试。
5xx
指数退避，先用上次成功的结果；公开服务不承诺 SLA。

能匿名调用不等于所有用途都获许可，见使用规则。