API

接口

登录后自助创建 API 密钥,用 HTTP 或 MCP 读取你有权限访问的资讯。

一键连接 Claude 和 Codex

复制一行,粘贴,登录授权。不需要先创建密钥,复制的内容里也不含密钥。

Claude

连接 Claude

Claude Code:在终端粘贴这一行,回车。

claude mcp add --transport http koegen https://koegen.ai/v1/mcp

然后在 Claude Code 里输入 /mcp,选 koegen 登录授权。

Claude 网页版 / 桌面版:复制地址,到「连接器」里添加自定义连接器。

https://koegen.ai/v1/mcp

名称填 Koegen;OAuth 客户端选「Register automatically」,随后登录 Koegen 并允许只读访问。

Codex

连接 Codex

Codex CLI / IDE 扩展:在终端粘贴这一行,回车,浏览器会打开 Koegen 授权页。

codex mcp add koegen --url https://koegen.ai/v1/mcp && codex mcp login koegen

Codex CLI 和 IDE 扩展共用这份配置,授权一次两边都能用。

ChatGPT 网页版:在「Plugins → + → Add custom MCP server」填入同一地址,认证选 OAuth、客户端注册选 DCR。

https://koegen.ai/v1/mcp

ChatGPT 的入口受账号和工作区权限控制;授权 30 天后可能需要重新登录。

拿 key

注册并登录后,在API 密钥页面直接创建。 密钥绑定你的账号与网页 consumer,可读取和确认投递;创建时只显示一次完整密钥,也可随时撤销。

从这几个接口开始

GET /v1/whoami

这把 key 是谁、能读哪些 consumer、什么时候过期,以及服务端正在跑的构建版本。先调它确认接通。

POST /v1/digest_since

拿「上次之后的新内容」。返回一张回执和按主题分组的投递。带上 ack 表示上一批确认收到,位置就往前推。

POST /v1/get_batch

凭回执重新取同一批 —— 内容是冻结的,重取几次都一样。用来做重试和分页,不会因为期间来了新消息而错位。

资讯接口还包括 GET /v1/feed/topics、GET /v1/topic_briefs、GET /v1/feed/search、GET /v1/discover 和 GET /v1/usage。X 实时发现使用共享日/月额度;返回结果会标明实时与已收录覆盖范围。

一次调用长什么样

curl -sS https://${YOUR_HOST}/v1/digest_since \
  -H "authorization: Bearer ${KOEGEN_API_KEY}" \
  -H "content-type: application/json" \
  -d '{"consumer_id":"your-team/main","requestId":"2026-09-14T00:00:00Z#1"}'

requestId 是你自己给这次请求起的名字。同一个 requestId 重发会拿回同一张回执,而不是又切一批新的 —— 网络重试因此是安全的。

MCP

MCP 只读,地址 https://koegen.ai/v1/mcp(Streamable HTTP):可发现 X 内容与作者、搜索已收录资讯、读取信源、列出主题、读取主题简报及查看 X 用量。关注信源和管理主题仍通过网页或 HTTP 接口。连接方式见本页顶部。

curl -sS https://koegen.ai/v1/mcp   -H "authorization: Bearer ${KOEGEN_API_KEY}"   -H "content-type: application/json"   -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

密钥只读取本账号获授权的内容。X 实时搜索可能因额度耗尽而返回已收录结果;Substack 的全站文章发现暂不支持。