/install dao3-statistics
这个技能做什么
这个技能提供一个命令行接口,用于从官方 API 获取 DAO3(神岛)平台数据。
覆盖两类能力:
- 公开接口(无需认证)
- 认证接口(需要 token + user-agent)
所有命令都会向 stdout 输出一个 JSON 对象。
如何运行
在 scripts/ 目录下运行:
python3 -m dao3_statistics --help
命令
公开接口(无需认证)
user-profile --user-id \x3Cid>
用途:通过用户 ID 获取用户个人资料。
参数:
--user-id \x3Cid>:用户 ID。
map-info --map-id \x3Cid>
用途:通过地图/内容 ID 获取地图详情。
参数:
--map-id \x3Cid>:地图(content)ID。
map-comments --content-id \x3Cid> --limit \x3Cn> --offset \x3Cn> --order-by \x3Cn> --content-type \x3Cn>
用途:获取地图/模型的评论列表。
参数:
--content-id \x3Cid>:内容 ID(地图/模型 ID)。--limit \x3Cn>:返回数量(上游通常限制最大 100)。--offset \x3Cn>:偏移量(分页用)。--order-by \x3Cn>:排序方式(例如 1=创建时间倒序;4=热度等,具体以接口为准)。--content-type \x3Cn>:内容类型(例如 1=地图;2=模型)。
map-release --content-id \x3Cid> --limit \x3Cn> --offset \x3Cn>
用途:获取地图发布信息。
参数:
--content-id \x3Cid>:地图 ID。--limit \x3Cn>:返回数量。--offset \x3Cn>:偏移量。
user-maps --user-id \x3Cid> --limit \x3Cn> --offset \x3Cn>
用途:获取某个用户发布/关联的地图列表。
参数:
--user-id \x3Cid>:用户 ID。--limit \x3Cn>:返回数量。--offset \x3Cn>:偏移量。
user-models --user-id \x3Cid> --limit \x3Cn> --offset \x3Cn>
用途:获取某个用户的模型列表。
参数:
--user-id \x3Cid>:用户 ID。--limit \x3Cn>:返回数量。--offset \x3Cn>:偏移量。
user-favorites --user-id \x3Cid> --limit \x3Cn> --offset \x3Cn> --content-type \x3Cn>
用途:获取某个用户的收藏列表。
参数:
--user-id \x3Cid>:用户 ID。--limit \x3Cn>:返回数量。--offset \x3Cn>:偏移量。--content-type \x3Cn>:收藏内容类型(例如 1=地图;2=模型)。
user-recent --user-id \x3Cid> --limit \x3Cn> --offset \x3Cn>
用途:获取某个用户最近游玩列表。
参数:
--user-id \x3Cid>:用户 ID。--limit \x3Cn>:返回数量。--offset \x3Cn>:偏移量。
user-followers --user-id \x3Cid> --limit \x3Cn> --offset \x3Cn>
用途:获取某个用户的粉丝列表。
参数:
--user-id \x3Cid>:用户 ID。--limit \x3Cn>:返回数量。--offset \x3Cn>:偏移量。
user-friends --user-id \x3Cid> --limit \x3Cn> --offset \x3Cn>
用途:获取某个用户的好友列表。
参数:
--user-id \x3Cid>:用户 ID。--limit \x3Cn>:返回数量。--offset \x3Cn>:偏移量。
user-following --user-id \x3Cid> --limit \x3Cn> --offset \x3Cn>
用途:获取某个用户的关注列表。
参数:
--user-id \x3Cid>:用户 ID。--limit \x3Cn>:返回数量。--offset \x3Cn>:偏移量。
search --keyword \x3Ckw> --limit \x3Cn> --offset \x3Cn> --order-by \x3Cn>
用途:通过关键字搜索地图/模型列表。
参数:
--keyword \x3Ckw>:关键词。--limit \x3Cn>:返回数量。--offset \x3Cn>:偏移量。--order-by \x3Cn>:排序方式(例如 0=推荐/最热;1=最新;具体以接口为准)。
示例:
python3 -m dao3_statistics user-profile --user-id 83354
python3 -m dao3_statistics map-info --map-id 100131463
python3 -m dao3_statistics search --keyword "test" --limit 10 --offset 0 --order-by 0
认证接口(token + user-agent)
必须同时提供:
--token: DAO3 认证 token--user-agent: 类浏览器的 UA 字符串
命令:
msg-comments --offset \x3Cn> --limit \x3Cn> --token \x3Ct> --user-agent \x3Cua>
用途:获取“评论消息”列表(站内消息/通知类)。
参数:
--offset \x3Cn>:偏移量。--limit \x3Cn>:返回数量。--token \x3Ct>:认证 token。--user-agent \x3Cua>:UA 字符串(会同时用于user-agent和x-dao-ua请求头)。
msg-likes --offset \x3Cn> --limit \x3Cn> --token \x3Ct> --user-agent \x3Cua>
用途:获取“点赞消息”列表。
参数:同 msg-comments。
msg-sys --offset \x3Cn> --limit \x3Cn> --token \x3Ct> --user-agent \x3Cua>
用途:获取“系统消息”列表。
参数:同 msg-comments。
stats-maps --start-time \x3CYYYY-MM-DD> --end-time \x3CYYYY-MM-DD> --token \x3Ct> --user-agent \x3Cua>
用途:获取当前用户的地图统计列表(按日期范围)。
参数:
--start-time \x3CYYYY-MM-DD>:开始日期。--end-time \x3CYYYY-MM-DD>:结束日期。--token \x3Ct>:认证 token。--user-agent \x3Cua>:UA 字符串。
stats-player --start-time \x3CYYYY-MM-DD> --end-time \x3CYYYY-MM-DD> --map-id \x3Cid> --token \x3Ct> --user-agent \x3Cua>
用途:获取指定地图的玩家统计数据(按日期范围)。
参数:
--start-time \x3CYYYY-MM-DD>:开始日期。--end-time \x3CYYYY-MM-DD>:结束日期。--map-id \x3Cid>:地图 ID。--token \x3Ct>:认证 token。--user-agent \x3Cua>:UA 字符串。
stats-retention --start-time \x3CYYYY-MM-DD> --end-time \x3CYYYY-MM-DD> --map-id \x3Cid> --token \x3Ct> --user-agent \x3Cua>
用途:获取指定地图的玩家留存数据(按日期范围)。
参数:同 stats-player。
stats-behavior --start-time \x3CYYYY-MM-DD> --end-time \x3CYYYY-MM-DD> --map-id \x3Cid> --token \x3Ct> --user-agent \x3Cua>
用途:获取指定地图的玩家行为分析数据(按日期范围)。
参数:同 stats-player。
示例:
python3 -m dao3_statistics stats-player \
--start-time 2025-03-29 \
--end-time 2025-04-04 \
--map-id 100131463 \
--token "YOUR_TOKEN" \
--user-agent "Mozilla/5.0 ..."
Raw 端点逃生口
如果你需要调用尚未映射为专用命令的端点:
raw --endpoint \x3Cpath-or-query> [--token \x3Ct> --user-agent \x3Cua>]
用途:直接请求任意上游 API 端点(适合临时验证/调试/未映射的新端点)。
参数:
--endpoint \x3Cpath-or-query>:以/开头的端点路径(可带 querystring)。--token \x3Ct>与--user-agent \x3Cua>:可选;如果该端点需要认证则必须同时提供。
示例:
python3 -m dao3_statistics raw --endpoint "/user/profile/83354"
输出
- 成功:输出 API 的 JSON 响应
- 失败:输出包含
error、endpoint的 JSON;并可能包含status_code、response
备注 / 边界情况
--limit的取值最大为100。- 网络失败/超时会以错误 JSON 形式返回。
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install dao3-statistics - 安装完成后,直接呼叫该 Skill 的名称或使用
/dao3-statistics触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Dao3 Statistics 是什么?
当用户想按 userId 或 mapId 查询神岛平台数据时使用此技能,例如用户资料、地图详情、地图评论、粉丝/好友/关注列表、收藏/最近游玩、关键词搜索等。当用户需要“需要认证”的消息/统计数据(评论/点赞/系统消息、地图统计、玩家统计、留存、行为等)并且能够提供 神岛token 和 user-agent 时,... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 261 次。
如何安装 Dao3 Statistics?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install dao3-statistics」即可一键安装,无需额外配置。
Dao3 Statistics 是免费的吗?
是的,Dao3 Statistics 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Dao3 Statistics 支持哪些平台?
Dao3 Statistics 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(darwin, linux)。
谁开发了 Dao3 Statistics?
由 冷鱼闲风(@ifishcool)开发并维护,当前版本 v0.1.0。