不抓 HTML，走 JSON。

整体是怎么接的

内容在仓库里是 markdown / JSON，build 时落成静态文件。端点是唯一的事实源， CLI 只是它的一层薄包装 —— 所以下面四条路拿到的数据完全一样，区别只在你手上有什么。

选哪一条

拿不定就用 curl —— 端点永远在，CLI 只是方便。

30 秒上手

curl -s https://zhanglu.net/api/index.json | jq

curl -s https://zhanglu.net/api/skills.json \
  | jq '.items[] | select(.featured) | .name'

curl -s https://zhanglu.net/api/skills/boss.json \
  | jq -r .body_md

npx zhanglu-net endpoints
npx zhanglu-net list skills --featured
npx zhanglu-net get skill boss --md
npx zhanglu-net search "品牌判断" --type skill

# 英文数据
npx zhanglu-net --lang en about --json

端点

所有端点 build 时静态生成，Content-Type 是 application/json，带 Access-Control-Allow-Origin: *。 不存在的路径返回真 404，状态码可直接用来判断。

中英双语：下面是中文数据。要英文，把路径前面加 /en —— 例如 /en/api/projects.json。 每个响应都带 lang 字段（"zh" / "en"）可自查。 英文指南见 /en/agents。

{ "counts": { "skills": 42 }, "endpoints": { … }, "languages": { … } }

{ "count": 14, "items": [{ "slug", "title", "tech": [], "year", "loc", "persona", … }] }

{ …list 字段, "body_md": "## 是什么\n…" }

{ "count": 12, "items": [{ "title", "source", "url", "date", "summary" }] }

{ "count": 4, "items": [{ "slug", "title", "tagline", "url", "kind", "year" }] }

{ "count": 42, "items": [{ "slug", "name", "description", "source", "featured" }] }

{ …list 字段, "body_md": "本 skill 来源于…" }

{ "count": 3, "items": [{ "slug", "title", "week", "date_range", "summary" }] }

{ …list 字段, "body_md": "## 三个产品…" }

{ "name": "张路", "tagline", "bio", "tags": [], "permalink" }

{ "links": [{ "label", "url", "handle", "icon" }] }

{ "items": [{ "type", "slug", "title", "text", "url" }] }

CLI

端点的薄包装。零运行时依赖，Node 18+，单文件 542 行。 更完整的 npm / npx 使用方式见 npm / CLI 专页。

npm view zhanglu-net repository.url   # → github.com/zhanglunet/zhanglu.net
npm view zhanglu-net dependencies     # → 空（零依赖）
npm view zhanglu-net version          # → 应与本页一致

三种跑法，选一个

三种跑法的命令、flags、行为完全一致 —— 下面的命令表对三者都适用。

命令

通用 flags

环境变量

Claude Code 集成

有个 /zhanglu skill，触发词包括「查张路的 skill」「zhanglu 上的 X」「张路在做什么项目」。Skill 会自动调 npx zhanglu-net。

其他 agent 接入

准入与授权

不用申请、不用 token。下面是这个站对爬虫和 agent 的明确立场 —— 写在 /robots.txt 里，机器可读。

引用时请指回原页（每条数据都带 permalink）。 速率没有硬限制 —— 端点是静态文件，但请别拿它跑压测。