tradehot

# tradehot — 外贸 HOT Skill ## 目标 `tradehot` 用于把外贸与跨境电商领域的分散信息，整理成适合外贸业务员、跨境卖家、工厂老板、选品运营和市场开发人员使用的**中文可执行业务简报**。 本 Skill 兼容 Codex Skill 与 Hermes Agent Skill 的目录习惯：主入口为 `SKILL.md`，辅助资源位于 `scripts/`、`sources/`、`templates/` 和 `examples/`。在 Hermes Agent 中安装后，通常可通过 `/tradehot` slash command 触发；在 Codex 中则可通过自然语言意图触发。 每次输出都必须回答： 1. 这件事是什么。 2. 影响谁。 3. 对哪些市场、平台、品类或 HS Code 有影响。 4. 有什么机会。 5. 有什么风险。 6. 今天可以做什么。 ## 何时触发 当用户表达以下任意意图时触发： - 查询外贸、出口、进口、跨境电商、国际贸易资讯。 - 查询今日/最近一周外贸日报、跨境电商日报、外贸热点。 - 查询 Amazon、TikTok Shop、Shopee、Lazada、Temu、SHEIN、AliExpress、eBay、Walmart Marketplace、Etsy、Shopify 等平台动态。 - 查询某个国家或地区的外贸市场机会。 - 查询某个 HS Code 或品类的出口机会。 - 查询关税、海关、认证、出口退税、贸易壁垒、合规风险。 - 查询国际物流、运价、港口、供应链、汇率、收款风险。 - 查询选品机会、市场调研、竞品/竞争国动态等情报。 - 查询关税、准入要求、认证标准、反倾销、贸易救济。 - 查询外贸展会、大促日历、季节性备货时间窗口。 - 查询竞争国动态（越南、印度、墨西哥等）。 - 查询汇率波动、外汇管制、支付风险。 典型触发语： ```text # 日报 / 周报 今天外贸 HOT 给我今天的外贸日报 最近一周跨境电商热点 帮我出一份本周外贸周报 # 平台动态 最近 Amazon 有什么政策变化 TikTok Shop 东南亚最近有什么新规 Shopee 卖家要注意什么 Temu 和 SHEIN 最近品类有什么变化 # 市场机会 美国市场最近有什么机会 给我做一份德国市场开发简报 印度市场适合做什么品类 东南亚和拉美市场哪个更有潜力 帮我对比日本和韩国的进口需求 # HS Code / 品类 查一下 HS Code 9403 的出口机会 帮我找宠物用品出口机会 家具品类最近有什么趋势 户外用品出口哪个市场增长快 # 关税与准入 家具出口美国关税多少 电子产品出口欧盟需要什么认证 化妆品出口日本有什么准入要求 帮我查一下儿童用品出口美国的合规清单 反倾销最近有什么变化 # 物流与供应链 红海航线现在什么情况 最近海运运价涨了吗 报价有效期应该设多久 # 备货与日历 最近有什么展会 Prime Day 什么时候开始，要提前多久备货 圣诞旺季什么时候开始发货 下半年有什么大促节点 # 竞争国 越南出口最近有什么变化 印度家具出口是不是在抢我们的市场 墨西哥对美国出口有什么优势 # 汇率与支付 阿根廷外汇风险怎么样 土耳其里拉最近波动大吗 尼日利亚收款有什么风险 新客户要用信用证，要注意什么 # 风险预警 最近外贸风险有哪些 哪些国家最近有制裁或贸易限制 # 选品 有什么适合开发的产品 最近什么品类增长快 跨境卖家选品有什么新方向 # 推送与协作 把这份报告发到飞书群里 帮我生成日报发到邮件 ``` ## Agent 工作流（重要） 本 Skill 采用 **"脚本框架 + 联网填充"** 双引擎模式。Agent 应按以下流程执行： ### Step 1：生成报告骨架 运行脚本生成结构化框架： ```bash python scripts/generate_report.py --type daily --days 1 python scripts/generate_report.py --type weekly --days 7 python scripts/generate_report.py --type platform --platform amazon python scripts/generate_report.py --type market --market "United States" python scripts/generate_report.py --type hs --hs-code 9403 python scripts/generate_report.py --type risk --days 7 python scripts/generate_report.py --type opportunity --days 7 python scripts/generate_report.py --type tariff --hs-code 9403 --market "United States" python scripts/generate_report.py --type tariff --category furniture --market EU python scripts/generate_report.py --type calendar --days 30 ``` 脚本会输出：报告结构、各板块搜索关键词提示、评分排序逻辑。 也可直接生成搜索关键词列表，用于指导联网搜索： ```bash python scripts/generate_report.py --search-queries --type daily python scripts/generate_report.py --search-queries --type hs --hs-code 9403 python scripts/generate_report.py --search-queries --type tariff --hs-code 9403 --market US python scripts/generate_report.py --search-queries --type calendar ``` ### Step 2：联网搜索填充真实数据 针对脚本骨架中的每个板块，使用当前 Agent 环境可用的联网检索能力获取最新内容，例如 Codex 的 web 搜索/浏览能力，或 Hermes Agent 中启用的 web/search toolset。优先从 `sources/*.json` 配置的信息源核实： | 板块 | 搜索方向 | 优先源 | |---|---|---| | 政策与监管 | 海关总署、商务部、税务总局最新公告 | sources.zh.json 中 priority=5 的源 | | 平台动态 | 各平台 Seller Center 公告、行业媒体报道 | platforms.json 中对应平台 | | 数据与市场 | UN Comtrade、ITC Trade Map、WTO 统计 | sources.en.json 中 official_data 类型 | | 物流与供应链 | FreightWaves、The Loadstar、运价指数 | sources.en.json 中 logistics_media 类型 | | 关税与合规 | ITC Market Access Map、目标国官方税则 | tariff_reference.json + sources.en.json 中 official_data_tool 类型 | | 选品机会 | Google Trends、平台热搜、行业报告 | 综合多源交叉验证 | | 竞争国动态 | 越南/印度/墨西哥/孟加拉出口数据 | competitors.json + 行业媒体 | | 物流中断 | 港口/运河/航线状态、运价指数 | logistics_hotspots.json + FreightWaves | | 汇率与支付 | 高波动货币、外汇管制国家 | fx_risk.json + 央行/IMF 数据 | | 风险预警 | 制裁清单、贸易救济、汇率波动 | 官方源优先 | ### Step 3：分析与判断 用真实数据替换脚本占位内容，按以下要求补充每条情报的元数据： - **类型**：政策 / 平台 / 数据 / 物流 / 关税 / 合规 / 选品 / 风险 / 宏观 - **影响对象**：工厂、贸易公司、跨境卖家、独立站、平台卖家、海外仓、物流商 - **影响市场**：国家或地区 - **影响品类**：行业词、产品词或 HS Code - **热度分**：0-25（见评分规则） - **风险等级**：低 / 中 / 高 - **行动建议**：今天或本周可执行的动作 ### Step 4：输出最终报告 按 `templates/*.md` 中对应模板的结构输出最终报告。输出要求： - 用中文，英文信息源需翻译并归纳。 - 不要只罗列新闻标题，必须转化为业务判断。 - 每条重要情报按以下句式展开：这件事是什么 → 影响谁 → 影响哪些品类/市场/平台 → 风险 → 机会 → 今天可以做什么。 ### Step 5（可选）：推送报告 报告生成后，可根据用户需求推送到飞书或其他渠道： - **飞书文档**：调用 `lark-doc` Skill 创建文档，将报告内容写入。 - **飞书群聊**：调用 `lark-im` Skill 发送报告摘要到指定群。 - **飞书邮件**：调用 `lark-mail` Skill 发送报告给指定收件人。 - **定时推送**：建议通过 Agent 环境的定时任务功能，每日自动触发日报并推送。 ## 核心能力（9 种报告类型） | # | 能力 | 触发场景 | 脚本参数 | 模板文件 | |---|---|---|---|---| | 1 | 今日外贸 HOT 日报 | "今天外贸圈发生了什么" | `--type daily` | templates/daily_report.md | | 2 | 本周外贸周报 | "最近一周外贸热点" | `--type weekly --days 7` | templates/daily_report.md | | 3 | 平台动态查询 | "Amazon 有什么新政策" | `--type platform --platform <name>` | templates/platform_report.md | | 4 | 国家/市场简报 | "德国市场有什么机会" | `--type market --market <name>` | templates/market_report.md | | 5 | HS Code / 品类机会 | "查一下 HS Code 9403" | `--type hs --hs-code <code>` | templates/hs_code_report.md | | 6 | 风险雷达 | "最近外贸风险有哪些" | `--type risk --days 7` | templates/risk_report.md | | 7 | 选品机会雷达 | "有什么适合开发的产品" | `--type opportunity --days 7` | templates/product_opportunity.md | | 8 | 关税与准入 | "家具出口美国关税多少" | `--type tariff --hs-code <code> --market <name>` 或 `--category <name>` | templates/tariff_report.md | | 9 | 外贸日历 | "最近有什么展会" | `--type calendar --days 30` | 内联生成 | ## 热度评分规则 ```text 热度分 = 时效性 + 权威性 + 业务影响 + 可操作性 + 风险程度 ``` 每项 0-5 分，总分 0-25 分。 | 维度 | 0 分 | 1-2 分 | 3-4 分 | 5 分 | |---|---|---|---|---| | 时效性 | 无时间信息 | 30 天前 | 3-7 天内 | 今天或昨天 | | 权威性 | 社媒传言 | 普通媒体 | 行业媒体 | 官方/平台官方公告 | | 业务影响 | 无直接影响 | 间接影响 | 影响成本/效率 | 影响订单/合规/账号 | | 可操作性 | 仅了解 | 中长期参考 | 可纳入计划 | 今天可执行 | | 风险程度 | 无风险 | 低风险 | 可能延误/损失 | 罚款/封号/扣货 | 排序原则：官方政策 > 平台规则 > 关税变化 > 物流/支付风险 > 市场数据 > 普通新闻。 ## 信息源优先级 1. **官方政策**（priority 5）：海关总署、商务部、税务总局、贸促会、WTO、UN Comtrade、ITC、trade.gov。 2. **平台官方公告**（priority 5）：Amazon、TikTok Shop、Shopee、Lazada、Temu、SHEIN、AliExpress、eBay、Walmart、Etsy、Shopify。 3. **行业媒体**（priority 4）：亿邦动力、雨果跨境、Reuters、FreightWaves、The Loadstar。 4. **第三方数据**（priority 3）：Google Trends、Similarweb、Marketplace Pulse、物流运价指数。 5. **社媒与论坛**（priority 1-2）：仅作线索，不作为事实依据，必须明确标注来源不确定。 完整信息源配置见 `sources/*.json` 和 `platforms.json`。 ## 知识库文件 | 文件 | 内容 | |---|---| | `sources/tariff_reference.json` | 9 大品类 × 主要市场的 MFN 税率、FTA 优惠、认证要求、贸易救济参考 | | `sources/trade_calendar.json` | 展会、大促、旺季、假日日历 + 品类季节性需求曲线 | | `sources/competitors.json` | 10 个竞争国画像：优势品类、关注信号、竞争关系 | | `sources/logistics_hotspots.json` | 8 个物流关键节点（港口/运河）+ 运价指数源 | | `sources/fx_risk.json` | 14 个高波动货币 + 10 个高支付风险国家 + 跨境支付注意事项 | ## 数据可信原则 - `sources/*.json` 中的静态知识库用于生成查询线索、风险提示和报告骨架，不应被当作最终官方结论。 - 涉及关税、贸易救济、制裁、出口管制、认证、召回、税务和平台处罚时，必须优先核验官方来源。 - 关税类输出必须提示用户复核 HS Code 的 6/8/10 位编码、原产地、目标国税则版本和贸易救济措施。 - 外贸日历中的展会、大促、旺季和假日节点应标注为 planning reference；具体日期需以主办方或平台公告为准。 - 飞书推送和定时推送属于分发层能力：本 Skill 可生成内容和建议调用方式，但不内置长期后台调度器。 ## 支持平台 Amazon、TikTok Shop、Shopee、Lazada、Temu、SHEIN、AliExpress、eBay、Walmart Marketplace、Etsy、Shopify（共 11 个，详见 `sources/platforms.json`）。 ## Hermes Agent 使用说明 - 推荐安装到 `~/.hermes/skills/business/tradehot`，或使用 Hermes 支持的 GitHub Skill 安装方式。 - 运行时至少启用 terminal/tool execution 能力，以便调用 `scripts/*.py`。 - 如需生成包含最新资讯的日报、周报、平台动态或风险雷达，应同时启用 web/search 能力。 - 若 Hermes 运行环境的当前工作目录不是 Skill 根目录，应先切换到本 Skill 目录，或使用脚本的绝对路径调用。 - 本 Skill 不依赖第三方 Python 包，Python 标准库即可运行测试与离线示例。 ## 重要限制 - 不要把未经验证的社媒传言当作事实。 - 涉及关税、认证、制裁、出口管制、税务时，必须提示用户以官方文件或专业顾问为准。 - 对于实时新闻、平台政策、关税、法规、运价、汇率等易变化信息，必须使用最新来源核实。 - 不应承诺一定能覆盖全网信息。 - 若信息源不足，应明确说明"未找到足够权威来源"。 - 脚本输出的骨架仅作为报告结构参考，所有实质内容必须由联网搜索或用户提供数据填充。