inquiry-read

基于“小蜜蜂（Bee）建站”的询盘数据进行统计分析，并生成结构化分析报告。。

支持：

• 分页读取询盘
• 自定义返回字段
• 多语言读取
• AI Agent 调用
• OpenClaw Skill 集成

---

Version

1.0.1

---

Features

• 从 Bee OpenAPI 获取询盘数据
• 支持分页查询
• 支持自定义返回字段
• 支持 language 参数联动
• 支持 AI 自动生成参数 UI
• 支持 Skill Dependencies

---

Environment Variables

运行前必须配置以下环境变量：

| Name | Required | Description | |---|---|---| | TRADEW_API_KEY | Yes | Bee OpenAPI Access Token |

---

Install

安装依赖：

npm install

---

Skill Structure

inquiry-read/
├── index.js
├── package.json
├── skill.json
└── README.md

---

Usage

Example Input

{
  "language": "en",
  "pagination": {
    "current_page":1,
    "page_size":10
  },
  "fields": [
    "inquiry_id",
    "title",
    "content",
    "contact",
    "create_time"
  ]
}

---

Input Parameters

| Parameter | Type | Required | Description | |---|---|---|---| | language | string | No | 语言参数。必须从 languages-get 中选择 | | current_page | number | No | 当前页码，默认 1 | | page_size | number | No | 每页数量，范围 10-50 | | fields | array[string] | No | 返回字段列表 |

---

Supported Fields

支持以下字段：

inquiry_id
language
is_read
title
content
country_code
ip
contact
source
target_products
create_time

---

Dependency

本技能依赖：

{
  "language": {
    "skill": "languages-get",
    "field": "list[].language",
    "mode": "select"
  }
}

说明：

• language 必须由 languages-get 返回结果中选择
• 不允许 AI 自动推断
• 不允许系统默认选择

---

Response Example

Success

{
  "status": true,
  "msg": "success",
  "pagination": {
    "current_page": 1,
    "page_size": 10,
    "total": 120
  },
  "list": [
    {
      "inquiry_id": "10001",
      "title": "Need quotation",
      "content": "Please send price",
      "contact": "Tom",
      "create_time": "2026-05-07 10:00:00"
    }
  ]
}

---

Failed

{
  "status": false,
  "msg": "缺少环境变量：TRADEW_API_KEY"
}

---

Validation Rules

page_size

范围：

10 - 50

超出范围时返回：

{
  "status": false,
  "msg": "page_size 必须在 10 到 50 之间"
}

---

API Endpoint

POST https://platform.tradew.com/openapis/inquiry/read

---

Notes

• Skill 使用 Bearer Token 鉴权
• 所有请求使用 application/json
• 默认返回常用询盘字段
• fields 支持自定义字段返回
• 建议通过 AI UI 自动选择参数

---

Changelog

1.0.1

• 增加 fields 支持
• 增加分页参数校验
• 增加 dependency 配置
• 优化返回结构

---

License

MIT