# AGI Daily 公开 Agent Skill

供外部 Agent **只读**接入 AGI Daily：搜索已入库条目、浏览频道、阅读日报与公开会话。**无需登录**。

## Base URL

**`https://agidaily.cc`**

下文路径均相对于该站点根。例如 `GET /api/items` 即：

```http
GET https://agidaily.cc/api/items?q=transformer&limit=20&days=7&lng=zh
```

**本 Skill 文档（默认 Markdown，供 Agent 优先读取）：**

```http
GET /skill
GET /skill.md
```

响应为 `text/markdown`，无侧栏、无 HTML。浏览器预览可加 `?format=html`。

## 能力边界

| 能力 | 公开 Skill | 说明 |
|------|------------|------|
| 搜索 / 浏览条目 | 是 | `GET /api/items`、`GET /api/feed` |
| 频道列表 | 是 | `GET /api/channels` |
| 日报阅读 | 是 | `GET /api/daily/*` |
| 精选 / 公开会话 | 是 | `GET /api/agent-sessions/*` |
| RSS 订阅 | 是 | `GET /rss`、`GET /api/rss` |
| NewsClaw 对话 | 否 | 需用户登录 |
| 写入 / 投递数据 | 否 | 不在公开 Skill 范围内 |

## 1. 搜索条目

```http
GET /api/items?q=transformer&limit=20&days=7&lng=zh
```

常用 query 参数：

| 参数 | 说明 |
|------|------|
| `q` | 关键词（标题 / 摘要 / 正文） |
| `channel` | 频道 ID |
| `days` | 最近 N 天（1–365） |
| `limit` | 条数上限（最大 500） |
| `offset` | 分页偏移 |
| `lng` | 展示语言（如 `zh`） |
| `tags` | 逗号分隔标签 |
| `author` | 作者筛选 |

响应示例字段：`items[].id`、`title`、`summary`、`content`、`source_url`、`published_at`。

## 2. 信息流（含频道元数据）

```http
GET /api/feed?limit=50&channel=all&lng=zh
```

返回 `{ channels, items, hasMore }`。`channel` 可传具体信源 URL，或 `all`。

## 3. 频道

```http
GET /api/channels
GET /api/channels/{sourceKey}/feeds
```

## 4. 日报

```http
GET /api/daily/reports
GET /api/daily/dates?key={reportKey}
GET /api/daily/latest?key={reportKey}
GET /api/daily/latest?key={reportKey}&date=2026-05-21
GET /api/daily/latest?key={reportKey}&date=2026-05-21&format=md
```

- `reports`：可用日报主题列表
- `dates`：某主题已有日期
- `latest`：Markdown 正文（可带 `date`）
- `format=md` 或 `format=markdown`：返回 `text/markdown` 纯文本，而非 JSON

站内 Markdown 导出（浏览器友好路径）：

```http
GET /daily/{key}/{date}?format=md
GET /daily/{key}/{date}.md
GET /daily/{key}?format=md
```

## 5. 公开 Agent 会话

```http
GET /api/agent-sessions/featured?limit=20
GET /api/agent-sessions/{sessionId}
GET /api/agent-sessions/{sessionId}?format=md
```

Markdown 导出：`GET /session/{sessionId}.md`

## 6. RSS

```http
GET /rss
GET /api/rss?channel={channelId}&limit=50
```

查询式 RSS 支持 `search`、`author`、`tags` 等参数，详见 `/rss` 路由。

## 调用建议

1. **优先用 `/api/items`** 做语义搜索；需要频道概览时用 `/api/feed`。
2. **分页**：递增 `offset`，或配合 `since` / `until` / `days` 缩小范围。
3. **引用来源**：回答用户时附上条目 `id` 或原文链接（若有）。

## 示例：汇总近期 AI 论文动态

```bash
curl -s "https://agidaily.cc/api/items?q=agent&days=3&limit=10&lng=zh"
```

## 后续

完整 Skill（NewsClaw 对话、沙箱、个人频道）需用户在 [agidaily.cc](https://agidaily.cc) 登录后使用，将在后续版本补充。