inquiry-read

从 Tradew 平台读取客户网站询盘信息。

支持：

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

Version

1.0.1

Features

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

Environment Variables

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

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

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