bee-products-read — 读取蜂产品信息

bee-products-read 版本：2.0.0 简介 通过小蜜蜂（Bee）建站开放 API 获取产品/商品列表数据。支持按语言筛选、产品分组筛选（叶子节点）、分页查询，并返回完整产品结构数据，可用于商品展示、SEO 优化、数据分析与内容生成。

输入参数 api_key (string, 必填) API 身份认证密钥，用于标识调用方身份并控制接口访问权限。获取地址：https://open.tradew.com 用于 API 权限校验 language (string, 必填) 站点语言筛选参数。 必须从 bee-languages-get 返回列表中人工选择，不允许 AI 推断或自动生成。 productsgroup_id (integer, 可选) 产品分组 ID。 仅允许选择 is_leaf === true 的叶子节点分组 非叶子节点必须过滤，不可使用 pagination (object, 必填) 分页配置参数。 current_page (integer) 默认值：1 最小值：1 分页规则：必须依赖 data.pagination.has_next_page 使用 data.pagination.next_page 作为下一页页码 禁止基于 total_page 或手动递增推算 has_next_page=false 时必须停止请求 page_size (integer) 默认值：10 范围：10 - 50

输出结构 顶层结构 字段 类型 说明 status boolean 请求状态 msg string 返回消息 data object/null 返回数据

data.pagination 字段 类型 说明 current_page integer 当前页码 page_size integer 每页数量 total_page integer 总页数 total_count integer 总记录数 has_next_page boolean 是否存在下一页 next_page integer/null 下一页页码

data.list[] 产品数据列表。 字段 类型 说明 products_id integer 产品ID language string 站点语言 group object 产品分组 product_name string 产品名称 model string 产品型号 images array 产品图片URL列表 tags array 关键词 attributes array 属性列表 brief_description string 简要描述 description string 详情描述（HTML） tdk object SEO信息 view_count integer 访问量 inquiry_count integer 询盘量 product_url string 详情页URL create_time string(datetime) 创建时间 update_time string(datetime) 更新时间

group 字段 类型 说明 productsgroup_id string 分组ID group_name string 分组名称

attributes[] 字段 类型 说明 name string 属性名 value string 属性值

tdk 字段 类型 说明 title string SEO标题（≤70字符） description string SEO描述（25-160字符） keywords string SEO关键词（≤100字符）

依赖关系 参数 依赖技能 字段来源 模式 language bee-languages-get list[].language select productsgroup_id bee-productsgroup-read list[].productsgroup_id select（filter: is_leaf=true）

使用示例 基础查询 { "api_key": "your-api-key", "language": "en", "pagination": { "current_page": 1, "page_size": 10 } }