inquiry-read

by mouxiaming

Install this Skill

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

Download inquiry-read.zip

SKILL.md About

# inquiry-read

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

支持：

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

---

# Version

```text
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

安装依赖：

```bash
npm install
```

---

# Skill Structure

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

---

# Usage

## Example Input

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

支持以下字段：

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

---

# Dependency

本技能依赖：

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

说明：

- `language` 必须由 `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"
    }
  ]
}
```

---

## Failed

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

---

# 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` 支持自定义字段返回
- 建议通过 AI UI 自动选择参数

---

# Changelog

## 1.0.1

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

---

# License

```text
MIT
```

_meta.json Metadata

{
  "ownerId": "kn7a470vc27cn2e5vg6xh5r7698683z7",
  "publishedAt": 1778212811196,
  "slug": "inquiry-read",
  "version": "1.0.1"
}