← Back to Skills Marketplace
bee-visitor-recent
by
mouxiaming
· GitHub ↗
· v2.0.1
· MIT-0
32
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install bee-visitor-recent
Description
基于"小蜜蜂（Bee）建站"开放 API 的最新访客数据读取技能，用于获取最新访客列表并生成结构化分析数据。
README (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 时有效
- 是否继续分页由调用方决定
Usage Guidance
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.
Capability Analysis
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.
Capability Tags
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install bee-visitor-recent - After installation, invoke the skill by name or use
/bee-visitor-recent - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.1
- 增加了分页查询功能，支持按页获取访客数据并返回分页元信息。
- 明确了输入参数结构，api_key 和 pagination 为必填项，分页规则更严格。
- 输出结构全面细化，详细列出 data、pagination、访客列表及各嵌套对象的字段和说明。
- 新增注意事项，强调 recent_visits 条目上限、时间标准格式及分页由调用方控制。
- 技能描述文本更加规范和结构化，更便于开发者集成与使用。
Metadata
Frequently Asked Questions
What is bee-visitor-recent?
基于"小蜜蜂（Bee）建站"开放 API 的最新访客数据读取技能，用于获取最新访客列表并生成结构化分析数据。 It is an AI Agent Skill for Claude Code / OpenClaw, with 32 downloads so far.
How do I install bee-visitor-recent?
Run "/install bee-visitor-recent" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is bee-visitor-recent free?
Yes, bee-visitor-recent is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does bee-visitor-recent support?
bee-visitor-recent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created bee-visitor-recent?
It is built and maintained by mouxiaming (@mouxiaming); the current version is v2.0.1.
More Skills