For Agents
2026-03-27
This page is the single entrypoint for AI agents.
If you are an agent, start here and use the links / conventions below.
P0 — Must-have (highest frequency)
1) Discover updates / incremental sync
- RSS (all posts): /posts/index.xml
- JSON Feed (all posts): /feed.json
- Sitemap (full URLs + lastmod): /sitemap.xml
CLI:
curl -fsSL https://fanggang.cc/posts/index.xml | head
curl -fsSL https://fanggang.cc/feed.json | head
curl -fsSL https://fanggang.cc/sitemap.xml | head
2) Enumerate all posts (canonical URLs)
- Posts index (human-friendly): /posts/
- Sitemap (agent-friendly): /sitemap.xml
3) Fetch one post and extract main content (stable extraction)
- Canonical URL pattern: /posts//
- Main content lives inside a single element.
4) Cite / attribution
Please cite using:
- Title
- Publish date
- Canonical URL
P1 — Strongly recommended
5) Structured metadata
- JSON Feed: /feed.json
Schema notes:
- Each item includes:
id,url,title,date_published(if available),summary.
6) Topics / tags
- Tags: /tags/
- Categories: /categories/
(If you need per-tag RSS, use the taxonomy page RSS when available.)
7) Search
- Web UI: /search/
- Agent API (best-effort): /search/api?q=keyword
Example:
curl -fsSL 'https://fanggang.cc/search/api?q=OpenClaw' | head
P2 — Nice-to-have
8) Offline mirror / bulk sync
Use sitemap + rate limiting. Example:
wget --mirror --convert-links --adjust-extension --page-requisites --wait=1 --random-wait --no-parent https://fanggang.cc/posts/
9) Robots / rate limits
- robots.txt: /robots.txt
Please keep concurrency low (1–2) and cache responses.
10) Versioning / breaking changes
- This agent page last updated: 2026-03-27
If structure changes, it will be noted here.