接入中心

Agent 接入

把星际流动接进你的 AI 工具——RSS、REST API、MCP 与私有情报档案共用同一个结构化事实源。

快速开始

选择你的工具,复制配置即可接入。

标准 MCP(streamable HTTP)接入 Claude Code:写入项目 .mcp.json,或用 CLI 一行添加;匿名即可用,带 token 解锁你的情报档案。

.mcp.json

{
  "mcpServers": {
    "astral-feed": {
      "type": "http",
      "url": "https://feed.astralor.com/mcp"
    }
  }
}

CLI 添加

claude mcp add --transport http astral-feed https://feed.astralor.com/mcp

# 档案入口:替换为你的 token
claude mcp add --transport http astral-feed https://feed.astralor.com/mcp/<YOUR_TOKEN>

示例里的 <YOUR_TOKEN> 是私有情报档案 token,登录后即可在情报档案里生成。去登录

在 Cursor 项目根目录创建 .cursor/mcp.json;匿名端点即可用,替换为 token 端点解锁私有档案。

.cursor/mcp.json

{
  "mcpServers": {
    "astral-feed": {
      "url": "https://feed.astralor.com/mcp"
    }
  }
}

示例里的 <YOUR_TOKEN> 是私有情报档案 token,登录后即可在情报档案里生成。去登录

JSON-RPC 2.0 over HTTP 的标准 MCP server:initialize / tools/list / tools/call,无状态、免 SSE;六个工具覆盖搜索、详情、热点、日报与频道。

端点

POST https://feed.astralor.com/mcp
POST https://feed.astralor.com/mcp/<YOUR_TOKEN>   # 档案入口:替换为你的 token

握手三连(curl)

curl -s -X POST https://feed.astralor.com/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}}}'

curl -s -X POST https://feed.astralor.com/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

curl -s -X POST https://feed.astralor.com/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_items","arguments":{"q":"OpenAI","take":5}}}'

search_items — 搜索/列出条目(q / mode / channel / tag / take)
get_item — 单条详情(摘要、关键点、点评与按权益的全文)
list_hot — 24 小时热点事件簇
get_daily — 频道日报(今天或指定日期)
list_channels — 公开频道清单
my_profile — 档案元数据与过滤规则(仅 token 入口)

示例里的 <YOUR_TOKEN> 是私有情报档案 token,登录后即可在情报档案里生成。去登录

公开只读 REST API,免鉴权;匿名按 IP 60 次/分钟,带 token 按计划日额并解锁权益内容。

curl 示例

# 精选条目(最近 30 条)
curl -s "https://feed.astralor.com/api/public/items?mode=selected&take=30&lang=zh-CN"

# 全频道热点与标签热度
curl -s "https://feed.astralor.com/api/public/hot-topics"

# 轮询预检探针(~100 字节)
curl -s "https://feed.astralor.com/api/public/fingerprint"

# 今日日报
curl -s "https://feed.astralor.com/api/public/daily?lang=zh-CN"

# 单篇 Markdown 导出
curl -s "https://feed.astralor.com/api/public/items/{id}/markdown"

# 关键词搜索
curl -s "https://feed.astralor.com/api/public/items?q=OpenAI&mode=all&lang=zh-CN"

给阅读器与自动化的订阅地址;精选流与档案流输出全文含图(content:encoded),其余轨保持摘要。

订阅地址

# 精选
https://feed.astralor.com/rss.xml

# 按分类过滤的精选
https://feed.astralor.com/rss.xml?topic=tech

# 全部条目
https://feed.astralor.com/feed/all.xml

# 日报
https://feed.astralor.com/feed/daily.xml

# 私有情报档案
https://feed.astralor.com/feed/profile/<YOUR_TOKEN>/rss.xml

示例里的 <YOUR_TOKEN> 是私有情报档案 token,登录后即可在情报档案里生成。去登录

把星际流动装成你的 Agent Skill:一份 SKILL.md 教会 Claude Code / Codex / Cursor / Gemini CLI 何时查情报、怎么引用。

Skill 关键约定

# 轮询礼仪:先 fingerprint 预检,有变化再拉取
GET https://feed.astralor.com/api/public/fingerprint

# 版本自检:每会话读 version,与 Skill 声明版本比对
GET https://feed.astralor.com/api/public/version

# 引用规范:给用户的引用一律用站内 permalink
https://feed.astralor.com/items/{id}

UA 规范:自定义 User-Agent 标识你的 agent 名(不强制,但记录在案)
匿名 60 次/分钟;fingerprint/version 豁免,放心轮询
token 免费:注册即可生成,解锁个性化档案与权益内容

Skill 即将在公开仓开源(astralor/feed-skill);发布前可先用 REST API 标签的端点自行接入。看 REST API

Live 示例

以下是 /api/public/items 此刻真实返回的字段节选,即取即用。

GET /api/public/items?take=1

{
  "id": "itm_63366f5f9044fc451f21041b",
  "title": "Qwen发布Qwen3.8-Flash-Next：多模态MoE模型，预览Qwen4架构",
  "score": 74,
  "scoreDetail": {
    "final": 74
  },
  "tags": [
    "MoE",
    "Qwen",
    "Qwen3.8-Flash-Next",
    "开源模型"
  ],
  "permalink": "https://feed.astralor.com/items/itm_63366f5f9044fc451f21041b"
}

能力总览

匿名请求按 IP 60 次/分钟;轮询请先打 fingerprint 预检,有变化再拉取;AI 助手接口另有每日限额。

公开端点

GET /api/public/items条目列表,支持 mode / topic / category / tag / lang / take / cursor
GET /api/public/events热点事件簇,多信源聚合
GET /api/public/daily当日双语日报
GET /api/public/dailies日报归档索引
GET /api/public/items?q=…关键词搜索(items 的 q 参数)
GET /api/public/hot-topics频道热点事件 + 时间窗标签计数,2 分钟缓存
GET /api/public/fingerprint有没有新内容,一次探针知道;先打它再拉取
GET /api/public/items/{id}/markdown条目转 Markdown(frontmatter + 正文),引用友好

MCP 工具

search_items — 搜索/列出条目(q / mode / channel / tag / take)
get_item — 单条详情(摘要、关键点、点评与按权益的全文)
list_hot — 24 小时热点事件簇
get_daily — 频道日报(今天或指定日期)
list_channels — 公开频道清单
my_profile — 档案元数据与过滤规则(仅 token 入口)

认证方式

公开端点免鉴权;匿名按 IP 60 次/分钟限流(fingerprint/version/health/status 豁免)。
token 可放 URL 路径(RSS / MCP),也可作 Bearer 头或 ?token= 用于公共 API;按 owner 计划计量日额。