inquiry-read
从 Tradew 平台读取客户网站询盘信息。
支持：
- 分页读取询盘
- 自定义返回字段
- 多语言读取
- AI Agent 调用
- OpenClaw Skill 集成
Version
1.0.1
Features
- 从 Tradew OpenAPI 获取询盘数据
- 支持分页查询
- 支持自定义返回字段
- 支持 language 参数联动
- 支持 AI 自动生成参数 UI
- 支持 Skill Dependencies
Environment Variables
运行前必须配置以下环境变量：
| Name | Required | Description |
|---|---|---|
| TRADEW_API_KEY | Yes | Tradew 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