对人友好
对 AI 更加友好

Node.js 20+，不依赖 uv

npm install -g @shdata-watch/cli

也可运行 curl -fsSL https://shdata.watch/install-cli.sh | sh。安装脚本只检查 Node.js 版本并调用 npm。

匿名即可查看核心指标预览

shdata metrics list "人口" --format table
shdata metrics get population --from-year 2020
shdata yearbooks list
shdata tables search "常住人口"

匿名和普通会员可以读取核心指标及对应历史窗口。完整指标、年鉴二维表和批量导出需要专业会员。

浏览器授权，不把密码交给 CLI

shdata login
shdata whoami
shdata logout

服务器或 CI 可使用 SHDATA_API_KEY。环境变量优先于本机登录，CLI 不提供会泄露到 shell 历史的密钥参数。

把上海数据交给 Agent，问一句就能查

将公开、可版本化的 SKILL.md 提供给 Codex 或其他支持 Skill 的 Agent。完成一次浏览器授权后，你可以直接提出数据问题，Agent 会调用 CLI 并返回稳定 JSON。

https://shdata.watch/agent-skills/shdata-cli/SKILL.md

1. 01
   提供 Skill 地址让 Agent 读取公开操作说明，不需要复制账号密码或 token。
2. 02
   本机完成一次授权运行 shdata login，在浏览器确认设备授权。
3. 03
   直接提出数据问题例如“查询 2020 年以来上海常住人口，并输出 JSON”。

Agent 通过 CLI 查询公开或已授权数据，不获得站内整理、运营与发布能力。