功能描述

专业跨境电商管理工具，支持TikTok、Amazon、Shopee、Lazada多平台商品同步、订单管理、智能定价和库存同步。

使用说明 (SKILL.md)

crossborder-ecom-hub - 跨境电商多平台管理技能

Name: Crossborder Ecom Hub
Author: lvjunjie-byte

🌏 技能描述

CrossBorder Ecom Hub 是一个专业的跨境电商多平台管理技能，帮助卖家统一管理 TikTok、Amazon、Shopee、Lazada 等多个电商平台的商品、订单、库存和定价。

核心功能

多平台商品同步 - 一键将商品从一个平台同步到其他所有平台
统一订单管理 - 聚合所有平台订单，提供统一视图和分析
智能定价系统 - 根据各平台竞争情况自动调整价格
实时库存同步 - 确保多平台库存一致性，防止超卖
数据分析报表 - 销售、利润、库存等多维度分析
飞书多维表格集成 - 自动同步数据到飞书 Bitable

支持平台

🎵 TikTok Shop
📦 Amazon Seller Central
🛍️ Shopee
🏪 Lazada

📦 安装

# 使用 skillhub 安装（推荐）
skillhub install crossborder-ecom-hub

# 或使用 clawhub 安装
clawhub install crossborder-ecom-hub

⚡ 快速开始

1. 初始化配置

crossborder-ecom init

这会创建配置文件 ~/.crossborder-ecom/config.json

2. 配置 API 密钥

编辑配置文件，添加各平台 API 密钥：

{
  "platforms": {
    "tiktok": {
      "apiKey": "your_tiktok_api_key",
      "apiSecret": "your_tiktok_api_secret"
    },
    "amazon": {
      "accessKey": "your_amazon_access_key",
      "secretKey": "your_amazon_secret_key",
      "region": "us-east-1"
    },
    "shopee": {
      "partnerId": "your_shopee_partner_id",
      "apiKey": "your_shopee_api_key"
    },
    "lazada": {
      "apiKey": "your_lazada_api_key",
      "apiSecret": "your_lazada_api_secret"
    }
  },
  "feishu": {
    "appId": "your_feishu_app_id",
    "appSecret": "your_feishu_app_secret",
    "bitableToken": "your_bitable_token"
  }
}

3. 检查平台连接

crossborder-ecom platform --status

4. 开始同步商品

crossborder-ecom sync --all --feishu

📖 使用文档

商品同步

# 同步所有商品
crossborder-ecom sync --all

# 从 TikTok 同步到 Amazon
crossborder-ecom sync --from tiktok --to amazon

# 同步指定商品
crossborder-ecom sync --product-ids prod_1,prod_2,prod_3

# 同步并更新飞书多维表格
crossborder-ecom sync --all --feishu

订单管理

# 列出所有订单
crossborder-ecom order --list

# 按平台过滤
crossborder-ecom order --list --platform tiktok

# 按状态过滤
crossborder-ecom order --list --status pending

# 按日期范围
crossborder-ecom order --list --date-from 2024-01-01 --date-to 2024-01-31

# 导出订单
crossborder-ecom order --list --export

智能定价

# 分析竞争价格
crossborder-ecom pricing --analyze

# 生成定价建议
crossborder-ecom pricing --suggest

# 应用定价策略
crossborder-ecom pricing --apply --strategy competitive

# 指定利润率
crossborder-ecom pricing --apply --margin 35 --strategy aggressive

定价策略说明：

competitive - 竞争性定价（跟随市场均价）
aggressive - 激进定价（低价抢占市场）
conservative - 保守定价（保证高利润）

库存管理

# 同步多平台库存
crossborder-ecom inventory --sync

# 检查库存状态
crossborder-ecom inventory --check

# 设置低库存预警
crossborder-ecom inventory --check --alert 5

# 更新库存
crossborder-ecom inventory --update

数据报表

# 销售报表
crossborder-ecom report --sales

# 库存报表
crossborder-ecom report --inventory

# 利润分析
crossborder-ecom report --profit

# 平台对比
crossborder-ecom report --platform

# 指定周期
crossborder-ecom report --sales --period monthly

# 导出报表
crossborder-ecom report --sales --export ./reports/

平台管理

# 列出已配置平台
crossborder-ecom platform --list

# 添加平台
crossborder-ecom platform --add tiktok

# 移除平台
crossborder-ecom platform --remove shopee

# 检查平台状态
crossborder-ecom platform --status

🔧 配置说明

环境变量

也可以通过环境变量配置：

# 平台 API 密钥
export TIKTOK_API_KEY=your_key
export AMAZON_ACCESS_KEY=your_key
export SHOPEE_API_KEY=your_key
export LAZADA_API_KEY=your_key

# 飞书配置
export FEISHU_APP_ID=your_app_id
export FEISHU_APP_SECRET=your_app_secret
export FEISHU_BITABLE_TOKEN=your_token

飞书多维表格配置

在飞书开放平台创建应用：https://open.feishu.cn/
获取 App ID 和 App Secret
创建多维表格，获取 Bitable Token
在配置文件中填写相关信息

飞书多维表格会自动创建以下数据表：

商品管理
订单管理
库存管理
定价建议
数据报表

💰 定价策略

Starter - $299/月

2 个平台集成
100 个商品同步
基础订单管理
飞书多维表格同步

Professional - $599/月 ⭐ 推荐

4 个平台集成
1000 个商品同步
智能定价系统
实时库存同步
数据分析报表

Enterprise - $999/月

无限平台集成
无限商品同步
AI 智能定价
优先技术支持
自定义 API 集成

📊 收益模型

目标：$30,000/月（100 用户）

假设用户分布：

30 个 Starter 用户：30 × $299 = $8,970/月
50 个 Professional 用户：50 × $599 = $29,950/月
20 个 Enterprise 用户：20 × $999 = $19,980/月

总计：$58,900/月

🛠️ 技术栈

Node.js 18+
TypeScript（可选）
各平台官方 API
飞书开放平台 API
Commander.js（CLI）
Axios（HTTP 请求）
Day.js（日期处理）
Chalk（终端美化）
Ora（加载动画）

📝 待开发功能

以下功能已预留接口，可根据需求扩展：

TikTok API 完整实现
Amazon SP-API 完整实现
Shopee API 完整实现
Lazada API 完整实现
平台间商品分类映射
自动化定时任务
Webhook 通知
多语言支持
更多报表类型
AI 销售预测

🤝 贡献

欢迎提交 Issue 和 Pull Request！

GitHub: https://github.com/openclaw/crossborder-ecom-hub

📄 许可证

Commercial License

📞 支持

文档：https://clawhub.com/skills/crossborder-ecom-hub/docs
问题反馈：https://github.com/openclaw/crossborder-ecom-hub/issues
邮件：[email protected]

🚀 开始您的跨境电商统一管理之旅！

安全使用建议

Things to check before installing or giving this skill credentials: 1) Metadata mismatch: the registry entry claims no required env vars, but SKILL.md and clawhub.json ask for TikTok/Amazon/Shopee/Lazada and Feishu credentials. Do not supply secrets until the publisher fixes the metadata and you confirm why the discrepancy exists. 2) Inspect network targets and code: review src/platforms/index.js and src/feishu.js to confirm the exact endpoints the skill calls and that credentials are only used to communicate with the official platform endpoints you expect. If you cannot review the code yourself, ask the publisher for an explicit list of endpoints and a security/privacy whitepaper. 3) Least privilege: create and provide read‑only or limited-scope API credentials where possible (for example, a token that can read product/order data but not perform payouts or change seller settings). For Feishu, create a workspace/app you control and use a token limited to the needed Bitable operations. 4) Secrets storage: the CLI writes config to ~/.crossborder-ecom/config.json. Verify file permissions (should be user-only) and consider using environment variables or a secrets manager if available. Delete or rotate keys after testing if you provided them to an environment you later distrust. 5) Verify implementation status: the DEVELOPMENT_SUMMARY and SKILL.md mention many platform APIs are 'to be implemented' or 'mock'. If adapters are still mocked, providing real credentials is premature and riskier — ask the author which integrations are production-ready. 6) Sandbox test: run the package in an isolated environment (throwaway account, limited-scope credentials, or sandbox accounts) first. Monitor outbound network traffic to ensure data goes only to the expected domains. 7) Trust & provenance: the source is marked 'unknown' and homepage is missing/ambiguous. Prefer skills from well-known publishers/repositories. Ask the maintainer for a verifiable GitHub repo and signed release artifacts. If any of the above raises unresolved questions, treat the skill as untrusted until the author addresses the mismatches and documents where credentials and data are sent.

功能分析

Type: OpenClaw Skill Name: crossborder-ecom-hub Version: 1.0.1 The crossborder-ecom-hub skill is a legitimate multi-platform e-commerce management tool designed to synchronize products, orders, and inventory across TikTok, Amazon, Shopee, and Lazada, with integration for Feishu Bitable. The codebase (bin/cli.js, src/feishu.js, and src/platforms/index.js) follows standard CLI patterns for configuration storage in the user's home directory and uses official API endpoints for data synchronization. While several platform adapters currently contain mock data and 'TODO' stubs, there is no evidence of malicious intent, data exfiltration to unauthorized domains, or prompt injection attacks.

能力评估

ℹ Purpose & Capability

The code, README and SKILL.md implement a multi‑platform ecommerce CLI with Feishu (Bitable) sync which is coherent with the skill description. However the registry metadata presented to the platform claims no required env vars or credentials while both SKILL.md and clawhub.json (in the package) list multiple platform API keys and Feishu credentials. That mismatch between declared registry requirements and the skill's own docs/code is an incoherence: the skill will legitimately need external API credentials, but the registry entry did not advertise them.

⚠ Instruction Scope

Runtime instructions and the CLI create and read a config file at ~/.crossborder-ecom/config.json and support syncing full product/order/inventory data to external services (platform APIs and Feishu). The SKILL.md and code explicitly direct the agent to collect API keys and to synchronize potentially sensitive business data to Feishu Bitable or platform APIs. That behavior is within the skill's claimed scope but it means the skill will transmit business data to external endpoints — make sure you trust those endpoints and the implementation. Also the docs and DEVELOPMENT_SUMMARY indicate many platform API implementations are still 'mock' or 'to be implemented', so the skill may request credentials even when the adapters are not fully functional.

⚠ Install Mechanism

The skill is labeled 'instruction-only' (no install spec) in the registry metadata, but the bundle contains a full CLI project (bin/, src/, commands/, package.json, etc.). That is an inconsistency: there is code that will be installed/executed but no explicit install mechanism described. This raises questions about how and where the files will be placed and executed by the platform. The package's dependencies are normal (axios, commander, etc.) and there are no obviously suspicious download URLs in the provided files, but the lack of explicit install packaging metadata is a discrepancy to resolve.

⚠ Credentials

The skill requires multiple high‑sensitivity credentials (TikTok, Amazon access/secret, Shopee partner/api keys, Lazada keys, and Feishu appSecret/bitableToken) to perform its features. That is expected for a multi‑platform integrator, but the registry metadata originally reported 'none' for required env vars — a clear mismatch. Additional concerns: the CLI writes credentials to ~/.crossborder-ecom/config.json by default; local file storage of secrets may be acceptable but you should verify file permissions and prefer least-privilege/read-only credentials where possible. Because Feishu sync will push order/product data to an external workspace, you should confirm whether that workspace is controlled by you or by a third party.

ℹ Persistence & Privilege

The skill does not request 'always: true' and does not appear to change other skills' configurations. It will create a per‑user config directory (~/.crossborder-ecom) and store API credentials there — this is typical but persistent. The platform-default autonomous invocation is enabled; combined with multiple external credentials and the ability to push data to external services, that increases blast radius if the skill behaves unexpectedly. No direct evidence of modifications to other skills or system-wide settings was found.

版本历史

v1.0.1

v1.0.1 - 跨境电商多平台管理，统一 TikTok/Amazon/Shopee/Lazada 商品、订单、库存、定价管理

v1.0.0

Initial release of crossborder-ecom-hub. - Unified management for TikTok, Amazon, Shopee, and Lazada platforms. - Features include multi-platform product sync, centralized order management, smart pricing, real-time inventory, and analytics reports. - Integrates with Feishu Bitable for automatic data sync. - Provides CLI commands for product, order, inventory, pricing, and reporting tasks. - Flexible configuration via file or environment variables. - Multiple pricing plans and revenue model outlined.

元数据

Slug crossborder-ecom-hub

版本 1.0.1

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 2

常见问题

Crossborder Ecom Hub 是什么？

专业跨境电商管理工具，支持TikTok、Amazon、Shopee、Lazada多平台商品同步、订单管理、智能定价和库存同步。它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 324 次。

如何安装 Crossborder Ecom Hub？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install crossborder-ecom-hub」即可一键安装，无需额外配置。

Crossborder Ecom Hub 是免费的吗？

是的，Crossborder Ecom Hub 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Crossborder Ecom Hub 支持哪些平台？

Crossborder Ecom Hub 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Crossborder Ecom Hub？

由 lvjunjie-byte（@lvjunjie-byte）开发并维护，当前版本 v1.0.1。

Crossborder Ecom Hub