Futa Tracker: FUTA Express 包裹查询 - Openclaw Skills

作者:互联网

2026-03-27

AI教程

什么是 Futa Tracker?

Futa Tracker 技能为您的 AI 环境提供了监控 FUTA Express (Ph??ng Trang) 包裹递送的无缝集成。通过利用 Openclaw Skills,开发人员和用户可以立即获取实时物流数据,包括发件人和收件人详情、支付状态和细化的跟踪历史。此技能通过将递送智能直接引入您的自动化工作流程,消除了手动检查网站的需求。

该技能在设计时考虑了技术准确性,确保所有状态更新和部门名称均保留其原始越南语。这可以防止翻译错误,并确保用户收到由 FUTA Express 内部系统提供的准确数据。对于任何需要可靠、程序化访问越南物流数据的人来说,这是一个必不可少的工具。

下载入口:https://github.com/openclaw/skills/tree/main/skills/tongtanhieu/futa-tracker

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install futa-tracker

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 futa-tracker。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

Futa Tracker 应用场景

  • 实时监控通过 FUTA Express 发送的货运状态。
  • 验证递送详情,如收件人身份和到达时间,用于物流审计。
  • 在个人或商业效率仪表板中自动更新包裹状态。
  • 无需离开终端或 AI 代理界面即可跟踪多个运单(m? v?n ??n)。
Futa Tracker 工作原理
  1. AI 代理从用户的自然语言请求中提取快递单号(m? v?n ??n)。
  2. 它向官方 FUTA Express 公开 API 端点发起 web_fetch 调用。
  3. 该技能解析返回的 JSON 负载,捕获全面的货运元数据。
  4. 它将数据格式化为结构化报告,并保留原始越南语术语以确保准确性。
  5. 最终状态(包括运输历史、费用明细和收件人详情)将呈现给用户。

Futa Tracker 配置指南

要将其集成到您的环境中,请确保您的 AI 代理具有访问 web_fetch 工具的权限。由于它利用公开查询端点,因此不需要特定的 API 密钥。这使其成为物流跟踪中最易于访问的 Openclaw Skills 之一。

# 通过您的 AI 代理界面标准用法
查询包裹:[运单号]

Futa Tracker 数据架构与分类体系

该技能处理具有以下核心结构的 JSON 响应以确保数据完整性:

字段 描述
data.barcode 唯一运单号 (M? v?n ??n)
data.status_bill 越南语的当前递送状态
data.totalcost 总运费及子费用明细
data.packages 包含包裹描述和时间戳的数组
data.trackings 详细的物流历史和变动日志
data.from_department_name 发货网点名称
name: futa-tracker
description: Track FUTA Express (Ph??ng Trang) package delivery status using their public API. Use when the user wants to track/tra c?u ??n hàng, ki?n hàng from FUTA Express, FUTA Express, or Ph??ng Trang Express. Requires a tracking code (m? v?n ??n) to query.

Futa Tracker

Overview

This skill enables tracking of FUTA Express (Ph??ng Trang) package delivery status via their public API.

API Endpoint

https://api.futaexpress.vn/bo-operation/f1/full-bill-by-code-public/

Tracking Workflow

  1. Extract tracking code from user input
  2. Use web_fetch to call the API
  3. Parse the JSON response
  4. Present detailed tracking information
  5. CRITICAL: Keep all values in original Vietnamese - DO NOT translate

Response Structure

Key fields in the response:

  • data.barcode - M? v?n ??n
  • data.from_fullname / data.from_phone - Ng??i g?i
  • data.to_fullname / data.to_phone - Ng??i nh?n
  • data.from_department_name - ?i?m g?i
  • data.to_department_name - ?i?m ??n
  • data.service_type_name - Lo?i d?ch v?
  • data.pay_type - Hình th?c thanh toán
  • data.package_total - S? ki?n
  • data.totalcost - T?ng chi phí
  • data.addcost - Ph? phí
  • data.status_bill - Tr?ng thái ??n hàng
  • data.note - Ghi chú
  • data.packages[] - Chi ti?t t?ng ki?n hàng
    • package_description - M? t? hàng
    • receive_fullname / receive_phone / receive_identity - Ng??i nh?n th?c t?
    • receive_time - Th?i gian nh?n hàng
    • arrival_time - Th?i gian ??n n?i
    • go_time - Th?i gian xu?t phát
    • arrival_note - Ghi chú ??n n?i
  • data.services[] - D?ch v? thêm
    • add_service_name - Tên d?ch v?
    • value - Giá d?ch v?
  • data.trackings[] - L?ch s? (th??ng trùng v?i packages data)

Output Format

Present information in this order:

?? FUTA Express - Tra c?u v?n ??n: 

?? Ng??i g?i: 
   ?? 
   ?? ?i?m g?i: 

?? Ng??i nh?n: 
   ?? 
   ?? ?i?m ??n: 

?? Th?ng tin ??n hàng:
   ? Lo?i d?ch v?: 
   ? Hình th?c thanh toán: 
   ? S? ki?n: 
   ? T?ng chi phí: ? (c??c chính: ? + ph?: ?)
   ? Tr?ng thái: 

?? Chi ti?t hàng hóa:
   ? 
   Ghi chú v?n chuy?n: 

?? Ng??i nh?n th?c t? (n?u ?? giao):
   ? Tên: 
   ? S?T: 
   ? CMND/CCCD: 
   ? Th?i gian nh?n: 

?? Ghi chú ??n hàng: 

?? L?ch s? v?n chuy?n:
| Th?i gian | Tr?ng thái | Chi ti?t |
|-----------|------------|----------|
| 
| ??? D?ch v? thêm: ? : ?

Important Rules

  • NEVER translate Vietnamese values - status names, department names, everything stays in Vietnamese
  • Format currency with periods (e.g., 350.000?)
  • Hide partial phone/ID info if present (masked with X or shown as is from API)
  • Show timestamps in readable format (YYYY-MM-DD HH:MM)
  • Display all meaningful data from the response

Error Handling

  • If data.bill_id is 0: Tracking code not found
  • If data.packages is empty: No package details available
  • Always show the full response data even if some fields are empty

相关推荐