跨境电商日报报告 是做什么的？
可配置的Codex技能，用于跨境电商产品智能分析，默认使用EchoTik及经过验证的平台适配器，生成每日GMV前20名及七日趋势的XLSX报告。
概述
本技能通过自动化的跨境电商数据采集和报告生成，帮助用户快速掌握市场动态。它支持配置化的平台适配器，可灵活切换数据源。
功能特点
- 每日Top-20 GMV报告：自动生成各电商平台当日GMV最高的20个产品列表，包含关键指标如销售额、销量、价格等。
- 七日趋势报告：展示过去七天内各产品的销售趋势，支持XLSX格式输出，便于进一步分析和分享。
- 平台适配器机制：默认使用EchoTik，但可通过配置文件或环境变量切换至其他已验证的平台（如Amazon、Shopify等）。
- 配置化驱动：所有参数（如API密钥、报告时间范围、输出路径）均通过环境变量或配置文件设置，无需修改代码。
支持的平台
| 平台名称 | 适配器状态 | 说明 |
|---|---|---|
| EchoTik | ✅ 默认 | 集成开箱即用，需配置API密钥 |
| Amazon | ✅ 已验证 | 通过对接Amazon Product Advertising API |
| Shopify | ✅ 已验证 | 通过对接Shopify Admin API |
| 其他平台 | 🚧 可扩展 | 遵循适配器接口即可添加 |
安装与配置
前提条件
- 具有Python 3.10+运行环境
- 有效的Codex或CLI工具
- 目标平台的API访问权限
安装步骤
- 配置环境变量：
# 设置EchoTik API密钥（或替换为其他平台）
export ECHO_TIK_API_KEY="your_api_key_here"
export REPORT_OUTPUT_DIR="./reports"
- 运行技能：
codex run huynhledang219-spec/cross-border-ecommerce-daily-report
配置文件高级选项
你可以创建config.yaml来自定义行为：
platform: "EchoTik"
top_n: 20
trend_days: 7
output_format: "xlsx"
include_charts: true
使用示例
生成默认报告
codex run huynhledang219-spec/cross-border-ecommerce-daily-report
输出文件：./reports/daily_top_20_2025-04-10.xlsx
生成指定平台报告
PLATFORM="Amazon" codex run huynhledang219-spec/cross-border-ecommerce-daily-report
输出格式
生成的XLSX文件包含两个工作表：
- Top-20 Product List：按GMV降序排列的产品信息。
- 7-Day Trend：每个产品过去七天的日销售趋势，附带变化百分比。
故障排除
问题：报告为空
- 确认API密钥有效且未过期。
- 检查所选平台是否支持当前地区。
问题：适配器错误
- 确保平台名称拼写正确（区分大小写）。
- 查看日志输出以获取更多调试信息。
许可
MIT License - 请参阅项目许可证文件获取更多信息。