bee-visitor-recent

A latest visitor data retrieval skill based on the "Bee Website Builder" Open API. It is used to obtain the latest visitor list and generate structured analysis data.

Version: 2.0.3

Overview

Use the Bee Website Builder Open API to retrieve the latest visitor data and generate a structured analysis report.

Supports paginated queries.

---

Input Parameters

api_key (string, Required)

API authentication key used for caller identity verification and interface access control.

• Get it from: https://open.tradew.com
• Recommended configuration: Inject it via skills.entries.env.BEE_API_KEY to avoid passing it in plaintext on every call.

---

pagination (object, Required)

Pagination configuration parameters.

current_page (integer)

• Default: 1
• Minimum: 1
• Pagination rules:
  • Must rely on data.pagination.has_next_page
  • Use data.pagination.next_page as the next page number
  • Do not infer pages based on total_page or manual increments
  • Requests must stop when has_next_page=false

page_size (integer)

• Default: 10
• Range: 10 ~ 50

---

Output Structure

Top-Level Fields

Field	Type	Description
status	boolean	Request status, true for success / false for failure
msg	string	Response message
data	object | null	Response data, null on failure

---

data.pagination

Field	Type	Description
current_page	integer	Current page number
page_size	integer	Items per page
total_page	integer	Total pages
total_count	integer	Total records
has_next_page	boolean	Whether a next page exists
next_page	integer/null	Next page number

---

data.list[] (visitor data list)

Field	Type	Description
ip	string	Visitor IP (IPv4 / IPv6)
country_code	string	Country code (ISO 3166-1)
page_views	integer	Page view count
first_visit	object	First visit record
recent_visits	array	Recent visit records (up to 50)
first_visit_time	string	First visit time (ISO 8601)
last_visit_time	string	Last visit time (ISO 8601)

---

first_visit Object

Field	Type	Description
page	object	First visited page info
screen	object	Screen resolution
visit_time	string	First visit time
referer	string	Referrer URL
current_url	string	Current visit URL
user_agent	string	Browser User-Agent

first_visit.page

Field	Type	Description
id	integer	Page ID
name	string	Page name
code	string	Page identifier

first_visit.screen

Field	Type	Description
width	integer	Screen width
height	integer	Screen height

---

recent_visits[] Object

Field	Type	Description
page	object	Page information
screen	object	Screen resolution
visit_time	string	Visit time
referer	string	Referrer URL
current_url	string	Current URL
user_agent	string	Browser User-Agent

recent_visits.page

Field	Type	Description
id	integer	Page ID
name	string	Page name
code	string	Page identifier

recent_visits.screen

Field	Type	Description
width	integer	Width
height	integer	Height

---

Notes

1. data may be null on failure
2. recent_visits contains at most 50 entries
3. All time fields use ISO 8601
4. next_page is valid only when has_next_page=true
5. Whether to continue pagination is decided by the caller