| name | tradehot |
| description | 外贸 HOT｜中文外贸/跨境电商情报、全球贸易数据、平台动态、HS Code 机会、关税准入、贸易日历、竞争国动态、物流风险、汇率风险、国家市场简报与风险雷达 Skill。当用户询问外贸、跨境电商、出口、进口、海关、关税、HS Code、国际物流、平台政策、海外市场、选品机会、外贸日报、跨境电商日报、贸易风险、竞争国、汇率、展会、大促、外贸日历、关税速查等情报获取与监控内容时使用。 |
| version | 1.1.0 |
| author | chnjames |
| platforms | ["windows","macos","linux"] |
| metadata | {"short-description":"中文外贸与跨境电商情报简报 Skill","tags":["foreign-trade","cross-border-ecommerce","hs-code","market-intelligence","risk-radar"],"category":"business","compatibility":{"codex":true,"hermes":true},"hermes":{"command":"tradehot","category":"business","requires_toolsets":["terminal"],"optional_toolsets":["web"]}} |
tradehot — 外贸 HOT Skill
目标
tradehot 用于把外贸与跨境电商领域的分散信息，整理成适合外贸业务员、跨境卖家、工厂老板、选品运营和市场开发人员使用的中文可执行业务简报。
本 Skill 兼容 Codex Skill 与 Hermes Agent Skill 的目录习惯：主入口为 SKILL.md，辅助资源位于 scripts/、sources/、templates/ 和 examples/。在 Hermes Agent 中安装后，通常可通过 /tradehot slash command 触发；在 Codex 中则可通过自然语言意图触发。
每次输出都必须回答：
- 这件事是什么。
- 影响谁。
- 对哪些市场、平台、品类或 HS Code 有影响。
- 有什么机会。
- 有什么风险。
- 今天可以做什么。
何时触发
当用户表达以下任意意图时触发：
- 查询外贸、出口、进口、跨境电商、国际贸易资讯。
- 查询今日/最近一周外贸日报、跨境电商日报、外贸热点。
- 查询 Amazon、TikTok Shop、Shopee、Lazada、Temu、SHEIN、AliExpress、eBay、Walmart Marketplace、Etsy、Shopify 等平台动态。
- 查询某个国家或地区的外贸市场机会。
- 查询某个 HS Code 或品类的出口机会。
- 查询关税、海关、认证、出口退税、贸易壁垒、合规风险。
- 查询国际物流、运价、港口、供应链、汇率、收款风险。
- 查询选品机会、市场调研、竞品/竞争国动态等情报。
- 查询关税、准入要求、认证标准、反倾销、贸易救济。
- 查询外贸展会、大促日历、季节性备货时间窗口。
- 查询竞争国动态（越南、印度、墨西哥等）。
- 查询汇率波动、外汇管制、支付风险。
典型触发语：
# 日报 / 周报
今天外贸 HOT
给我今天的外贸日报
最近一周跨境电商热点
帮我出一份本周外贸周报
# 平台动态
最近 Amazon 有什么政策变化
TikTok Shop 东南亚最近有什么新规
Shopee 卖家要注意什么
Temu 和 SHEIN 最近品类有什么变化
# 市场机会
美国市场最近有什么机会
给我做一份德国市场开发简报
印度市场适合做什么品类
东南亚和拉美市场哪个更有潜力
帮我对比日本和韩国的进口需求
# HS Code / 品类
查一下 HS Code 9403 的出口机会
帮我找宠物用品出口机会
家具品类最近有什么趋势
户外用品出口哪个市场增长快
# 关税与准入
家具出口美国关税多少
电子产品出口欧盟需要什么认证
化妆品出口日本有什么准入要求
帮我查一下儿童用品出口美国的合规清单
反倾销最近有什么变化
# 物流与供应链
红海航线现在什么情况
最近海运运价涨了吗
报价有效期应该设多久
# 备货与日历
最近有什么展会
Prime Day 什么时候开始，要提前多久备货
圣诞旺季什么时候开始发货
下半年有什么大促节点
# 竞争国
越南出口最近有什么变化
印度家具出口是不是在抢我们的市场
墨西哥对美国出口有什么优势
# 汇率与支付
阿根廷外汇风险怎么样
土耳其里拉最近波动大吗
尼日利亚收款有什么风险
新客户要用信用证，要注意什么
# 风险预警
最近外贸风险有哪些
哪些国家最近有制裁或贸易限制
# 选品
有什么适合开发的产品
最近什么品类增长快
跨境卖家选品有什么新方向
# 推送与协作
把这份报告发到飞书群里
帮我生成日报发到邮件
Agent 工作流（重要）
本 Skill 采用 "脚本框架 + 联网填充" 双引擎模式。Agent 应按以下流程执行：
Step 1：生成报告骨架
运行脚本生成结构化框架：
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
脚本会输出：报告结构、各板块搜索关键词提示、评分排序逻辑。
也可直接生成搜索关键词列表，用于指导联网搜索：
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 | 内联生成 |
热度评分规则
热度分 = 时效性 + 权威性 + 业务影响 + 可操作性 + 风险程度
每项 0-5 分，总分 0-25 分。
| 维度 | 0 分 | 1-2 分 | 3-4 分 | 5 分 |
|---|
| 时效性 | 无时间信息 | 30 天前 | 3-7 天内 | 今天或昨天 |
| 权威性 | 社媒传言 | 普通媒体 | 行业媒体 | 官方/平台官方公告 |
| 业务影响 | 无直接影响 | 间接影响 | 影响成本/效率 | 影响订单/合规/账号 |
| 可操作性 | 仅了解 | 中长期参考 | 可纳入计划 | 今天可执行 |
| 风险程度 | 无风险 | 低风险 | 可能延误/损失 | 罚款/封号/扣货 |
排序原则：官方政策 > 平台规则 > 关税变化 > 物流/支付风险 > 市场数据 > 普通新闻。
信息源优先级
- 官方政策（priority 5）：海关总署、商务部、税务总局、贸促会、WTO、UN Comtrade、ITC、trade.gov。
- 平台官方公告（priority 5）：Amazon、TikTok Shop、Shopee、Lazada、Temu、SHEIN、AliExpress、eBay、Walmart、Etsy、Shopify。
- 行业媒体（priority 4）：亿邦动力、雨果跨境、Reuters、FreightWaves、The Loadstar。
- 第三方数据（priority 3）：Google Trends、Similarweb、Marketplace Pulse、物流运价指数。
- 社媒与论坛（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 标准库即可运行测试与离线示例。
重要限制
- 不要把未经验证的社媒传言当作事实。
- 涉及关税、认证、制裁、出口管制、税务时，必须提示用户以官方文件或专业顾问为准。
- 对于实时新闻、平台政策、关税、法规、运价、汇率等易变化信息，必须使用最新来源核实。
- 不应承诺一定能覆盖全网信息。
- 若信息源不足，应明确说明"未找到足够权威来源"。
- 脚本输出的骨架仅作为报告结构参考，所有实质内容必须由联网搜索或用户提供数据填充。
