bee-inquiry-read

by mouxiaming

Install this Skill

curl -fsSL -o bee-inquiry-read.zip https://skill.seembox.com/api/v1/skills/bee-inquiry-read/download && unzip bee-inquiry-read.zip

Download bee-inquiry-read.zip

SKILL.md About

# bee-inquiry-read

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

支持：

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

---

# Features

- 从小蜜蜂（Bee）获取询盘数据
- 支持分页查询
- 支持自定义返回字段
- 支持 language 参数联动
- 支持 Skill Dependencies

---

# Usage

## Example Input

```json
{
  "api_key": "eyJhbGciOiJIU...", 
  "language": "en",
  "pagination": {
    "current_page":1,
    "page_size":10
  },
  "fields": [
    "inquiry_id",
    "language",
    "is_read",
    "title",
    "content",
    "country_code",
    "ip",
    "contact",
    "source",
    "target_products",
    "create_time"
  ]
}
```

---

# Input Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | API_KEY 是用于 API 身份认证的安全凭证，用于标识调用方身份并控制接口访问权限。请前往 https://open.tradew.com 开发者平台获取后再使用。 |
| language | string | No | 语言参数。必须从 `languages-get` 中选择 |
| current_page | number | No | 当前页码，默认 1 |
| page_size | number | No | 每页数量，范围 10-50 |
| fields | array[string] | No | 返回字段列表 |

---

# Supported Fields

支持以下字段：

```text
inquiry_id
language
is_read
title
content
country_code
ip
contact
source
target_products
create_time
```

---

# Dependency

本技能依赖：

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

说明：

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

---

# Response Example

## Success

```json
{
  "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"
    }
  ]
}
```

---

# Validation Rules

## page_size

范围：

```text
10 - 50
```

超出范围时返回：

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

---

# API Endpoint

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

---

# Notes

- Skill 使用 `Bearer Token` 鉴权
- 所有请求使用 `application/json`
- 默认返回常用询盘字段
- `fields` 支持自定义字段返回

---

# Changelog

## 1.0.2

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

---

# License

```text
MIT
```

_meta.json Metadata

{
  "ownerId": "kn7a470vc27cn2e5vg6xh5r7698683z7",
  "publishedAt": 1778233211780,
  "slug": "bee-inquiry-read",
  "version": "1.0.3"
}