bee-inquiry-read
版本: 2.0.0
简介
通过小蜜蜂（Bee）建站开放 API，读取询盘数据并生成结构化分析报告。
支持全字段读取、按需选取字段（fields）、多语言筛选、分页查询。
输入参数
api_key (string, 必填)
API 身份认证密钥，用于调用方身份识别和接口权限控制。
- 获取地址: https://open.tradew.com
- 推荐配置方式: 通过
skills.entries.bee-inquiry-read.env.BEE_API_KEY或skills.entries.bee-inquiry-read.apiKey注入，避免每次调用明文传参。
language (string, 可选)
站点语言筛选。
⚠️ 约束： 如果提供此参数，必须通过
bee-languages-getskill 返回的列表人工选择，不允许 AI 系统推断。
fields (array of strings, 可选)
字段白名单。指定返回哪些询盘字段，不传则返回全部字段。
可选值：
| 字段 | 说明 |
|---|---|
inquiry_id | 询盘唯一编号 |
language | 语言 |
is_read | 是否已读 |
title | 询盘标题 |
content | 询盘内容 |
country_code | 国家代码 |
ip | IP 地址 |
contact | 联系人信息对象 |
source | 来源渠道 |
target_products | 关联产品列表 |
create_time | 创建时间 |
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 | 总记录数 |
data.list[] (array of objects)
每条询盘数据包含以下字段：
| 字段 | 类型 | 说明 |
|---|---|---|
| inquiry_id | integer | 询盘唯一编号 |
| language | string | 站点语言 |
| is_read | boolean | 是否已读 |
| title | string | 询盘标题 |
| content | string | 询盘内容（可能包含 HTML 表单） |
| country_code | string | 国家代码（ISO 3166-1） |
| ip | string | IPv4 或 IPv6 地址 |
| contact | object | 联系人信息 |
| source | string | 询盘来源渠道 |
| target_products | array of objects | 关联产品列表 |
| create_time | string (datetime) | 创建时间（ISO 8601 格式） |
contact 对象
| 字段 | 类型 | 说明 |
|---|---|---|
| name | string | 联系人姓名 |
| string | 邮箱地址 | |
| tel | string | 联系电话 |
| address | string | 联系地址 |
target_products[] 对象
| 字段 | 类型 | 说明 |
|---|---|---|
| products_id | integer | 产品 ID |
| product_name | string | 产品名称 |
| product_url | string | 产品链接 |
依赖
| 参数 | 依赖 skill | 关联字段 | 模式 |
|---|---|---|---|
| language | bee-languages-get | list[].language | select |
language 参数的值必须从 bee-languages-get 的返回列表中人工选择。
使用示例
基础查询（第一页，每页 10 条）
{
"api_key": "your-api-key",
"pagination": {
"current_page": 1,
"page_size": 10
}
}
带语言筛选 + 字段限制
{
"api_key": "your-api-key",
"language": "en",
"fields": ["inquiry_id", "country_code", "source", "contact", "create_time"],
"pagination": {
"current_page": 1,
"page_size": 50
}
}
注意事项
api_key必填，从 https://open.tradew.com 获取pagination必须符合范围限制（page_size 10~50，current_page ≥ 1）language必须人工从bee-languages-get选择，不得系统推断- 翻页规则：
data.pagination.has_next_page，是否存在下一页；data.pagination.next_page，下一页页码，没有下一页时为 null；是否继续由用户决定 fields可选，不传则返回全部字段；传了则只返回指定字段
适用场景
- 外贸询盘数据拉取
- 客户来源渠道统计
- 产品热门度/转化分析
- 客户画像与身份标签分析
- 分页导出与 CRM 数据同步