# AGI Daily Public Content Skill

This guide documents unauthenticated read operations for AGI Daily public content. It does not grant access to administrative or mutation routes.

## Base URL

`https://agidaily.cc`

All paths below are relative to the site root.

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

This skill document is available at:

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

## Capability Boundary

| Capability | Public | Endpoint |
| --- | --- | --- |
| Search and browse items | Yes | `GET /api/items`, `GET /api/feed` |
| List channels and feeds | Yes | `GET /api/channels`, `GET /api/channels/{sourceKey}/feeds` |
| Read daily reports | Yes | `GET /api/daily/*` |
| RSS | Yes | `GET /rss`, `GET /rss.xml` |
| Write or submit data | No | Not part of this Skill |
| User account data | No | Login required on the main site |

## Search Items

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

Common query parameters:

| Parameter | Description |
| --- | --- |
| `q` | Keyword search over title, summary, and content |
| `channel` | Channel ID |
| `days` | Recent range in days |
| `limit` | Page size |
| `offset` | Pagination offset |
| `lng` | Display language, such as `zh` |
| `tags` | Comma-separated tags |
| `author` | Author filter |

The response includes item fields such as `id`, `title`, `summary`, `content`, `url`, `source_url`, `pub_date`, and `fetched_at`.

## Feed

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

Returns `{ channels, items, hasMore }`. `channel` can be a concrete source URL or `all`.

## Channels

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

## Daily Reports

```http
GET /api/daily/dates
GET /api/daily/latest
GET /api/daily/latest?date=2026-05-21
GET /api/daily/latest?date=2026-05-21&format=md
```

Markdown export:

```http
GET /daily/2026-05-21?format=md
GET /daily/2026-05-21.md
GET /daily?format=md
```

Use `format=md` or `format=markdown` to receive `text/markdown` instead of JSON.

## RSS

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

RSS queries support `search`, `author`, and `tags`.

## Usage Notes

1. Prefer `/api/items` for semantic search.
2. Use `offset`, `since`, `until`, or `days` to control result size.
3. Cite item `id` or source URLs when using AGI Daily results in downstream answers.