← 返回 Skills 市场
bee-visitor-recent
作者
mouxiaming
· GitHub ↗
· v2.0.1
· MIT-0
32
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install bee-visitor-recent
功能描述
基于"小蜜蜂（Bee）建站"开放 API 的最新访客数据读取技能，用于获取最新访客列表并生成结构化分析数据。
使用说明 (SKILL.md)
bee-visitor-recent
版本: 2.0.1
简介
通过小蜜蜂（Bee）建站开放 API，读取取最新访客数据并生成结构化分析报告。
支持分页查询。
输入参数
api_key (string, 必填)
API 身份认证密钥，用于调用方身份识别和接口权限控制。
- 获取地址: https://open.tradew.com
- 推荐配置方式: 通过
skills.entries.env.BEE_API_KEY注入，避免每次调用明文传参。
pagination (object, 必填)
分页设置。
current_page (integer)
- 默认值: 1
- 翻页规则:
data.pagination.has_next_page，是否存在下一页；data.pagination.next_page，下一页页码，没有下一页时为 null； -
⚠️ 约束： 是否继续读取下一页应由用户决定，智能体不得自动翻页抓取全部数据。
page_size (integer)
- 默认值: 10
- 范围: 10 ~ 50
输出结构
顶层字段
| 字段 | 类型 | 说明 |
|---|---|---|
| status | boolean | 请求状态，true 成功 / false 失败 |
| msg | string | 返回消息 |
| data | object | null | 返回结果数据，失败时为 null |
data.pagination
| 字段 | 类型 | 说明 |
|---|---|---|
| current_page | integer | 当前页码 |
| page_size | integer | 每页数量 |
| total_page | integer | 总页数 |
| total_count | integer | 总记录数 |
| has_next_page | boolean | 是否存在下一页 |
| next_page | integer | null | 下一页页码（无则为 null） |
data.list[]（访客数据列表）
| 字段 | 类型 | 说明 |
|---|---|---|
| ip | string | 访客 IP（IPv4 / IPv6） |
| country_code | string | 国家代码（ISO 3166-1） |
| page_views | integer | 页面浏览次数 |
| first_visit | object | 首次访问记录 |
| recent_visits | array | 最近访问记录（最多 50 条） |
| first_visit_time | string | 首次访问时间（ISO 8601） |
| last_visit_time | string | 最后访问时间（ISO 8601） |
first_visit 对象
| 字段 | 类型 | 说明 |
|---|---|---|
| page | object | 首次访问页面信息 |
| screen | object | 屏幕分辨率 |
| visit_time | string | 首次访问时间 |
| referer | string | 来源 URL |
| current_url | string | 当前访问 URL |
| user_agent | string | 浏览器 User-Agent |
first_visit.page
| 字段 | 类型 | 说明 |
|---|---|---|
| id | integer | 页面 ID |
| name | string | 页面名称 |
| code | string | 页面标识 |
first_visit.screen
| 字段 | 类型 | 说明 |
|---|---|---|
| width | integer | 屏幕宽度 |
| height | integer | 屏幕高度 |
recent_visits[] 对象
| 字段 | 类型 | 说明 |
|---|---|---|
| page | object | 页面信息 |
| screen | object | 屏幕分辨率 |
| visit_time | string | 访问时间 |
| referer | string | 来源 URL |
| current_url | string | 当前 URL |
| user_agent | string | 浏览器 User-Agent |
recent_visits.page
| 字段 | 类型 | 说明 |
|---|---|---|
| id | integer | 页面 ID |
| name | string | 页面名称 |
| code | string | 页面标识 |
recent_visits.screen
| 字段 | 类型 | 说明 |
|---|---|---|
| width | integer | 宽度 |
| height | integer | 高度 |
注意事项
- data 可能为 null（失败时）
- recent_visits 最多 50 条
- 所有时间字段均为 ISO 8601
- next_page 仅在 has_next_page=true 时有效
- 是否继续分页由调用方决定
安全使用建议
This appears safe for its stated purpose if you intend to let the agent read Bee visitor analytics. Before installing, confirm the API key is scoped appropriately, do not share the key in plain chat if environment injection is available, and handle visitor data as potentially sensitive personal information.
功能分析
Type: OpenClaw Skill
Name: bee-visitor-recent
Version: 2.0.1
The skill is a standard API wrapper for fetching visitor data from the 'Bee' website builder platform (tradew.com). The code in index.js performs a straightforward POST request to the official API endpoint using the provided API key, with no evidence of data exfiltration, unauthorized execution, or malicious prompt injection. It even includes safety constraints in SKILL.md and README.md advising the agent against automatic pagination to prevent unintended resource consumption.
能力标签
能力评估
Purpose & Capability
The capability matches the stated purpose: it retrieves recent website visitor analytics. The returned data includes potentially sensitive visitor details such as IP address, referrer URL, current URL, and user agent, so users should handle outputs carefully.
Instruction Scope
The documentation limits page size and explicitly says pagination should be user-directed, not automatically looped. One minor reliability note: the schema documents a nested pagination object, while index.js reads current_page and page_size at the top level.
Install Mechanism
There is no install script, package install, shell command, or dependency chain shown. The included code is a small API wrapper.
Credentials
The skill requires a Bee API key and makes a POST request to the disclosed Tradew/Bee API endpoint, which is proportionate to its visitor-analytics purpose.
Persistence & Privilege
No persistence, background worker, local file writes, account mutation, or long-running behavior is shown. The code performs a single read-style API request and returns the provider response.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install bee-visitor-recent - 安装完成后，直接呼叫该 Skill 的名称或使用
/bee-visitor-recent触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v2.0.1
- 增加了分页查询功能，支持按页获取访客数据并返回分页元信息。
- 明确了输入参数结构，api_key 和 pagination 为必填项，分页规则更严格。
- 输出结构全面细化，详细列出 data、pagination、访客列表及各嵌套对象的字段和说明。
- 新增注意事项，强调 recent_visits 条目上限、时间标准格式及分页由调用方控制。
- 技能描述文本更加规范和结构化，更便于开发者集成与使用。
元数据
常见问题
bee-visitor-recent 是什么？
基于"小蜜蜂（Bee）建站"开放 API 的最新访客数据读取技能，用于获取最新访客列表并生成结构化分析数据。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 32 次。
如何安装 bee-visitor-recent？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install bee-visitor-recent」即可一键安装，无需额外配置。
bee-visitor-recent 是免费的吗？
是的，bee-visitor-recent 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
bee-visitor-recent 支持哪些平台？
bee-visitor-recent 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 bee-visitor-recent？
由 mouxiaming（@mouxiaming）开发并维护，当前版本 v2.0.1。
推荐 Skills