tradehot - 外贸 HOT Skill

把外贸、跨境电商、平台政策、HS Code、市场机会与风险信号，整理成可执行的中文业务简报。

English · Examples · Hermes Agent

tradehot 是一个面向外贸、跨境电商、出口企业和市场开发人员的中文情报 Skill。它把分散的信息源标准化、去重、排序，并输出适合业务决策的 Markdown 简报。

Important

本 Skill 不替代法律、税务、海关、认证或贸易合规专业意见。涉及关税、出口管制、平台处罚、认证要求等高风险事项时，请以官方文件和专业顾问意见为准。

它解决什么问题

外贸信息通常分散在新闻、平台公告、行业媒体、海关政策和市场报告里，手工整理容易漏掉来源、时间和风险信号。tradehot 的目标是把这些输入转成稳定结构，再生成可复用的业务简报。

适合用于：

场景	输出
今日外贸热点追踪	外贸 HOT 日报
平台政策监控	Amazon / TikTok Shop / Shopee 等平台动态
国家市场研究	国家 / 区域市场简报
品类与 HS Code 分析	机会、风险、贸易信号
关税与准入速查	税率、认证、FTA、贸易救济参考
贸易日历与备货规划	展会、大促、节假日、旺季节点
竞争国动态监控	越南/印度/墨西哥等出口变化
物流中断与运价追踪	港口/运河状态、运价指数
汇率与支付风险	高波动货币、收款风险、外汇管制
风险预警	关税、制裁、物流、合规、平台规则变化
选品研究	品类机会雷达

快速开始

Codex

在 Codex 中，直接发送下面这句话即可安装：

帮我安装这个 skill：chnjames/tradehot-skill

也可以使用完整 GitHub 地址：

帮我安装这个 skill：https://github.com/chnjames/tradehot-skill

如果需要手动安装，可克隆到 Codex 用户 Skill 目录：

git clone https://github.com/chnjames/tradehot-skill.git "$HOME\.codex\skills\tradehot"

安装后刷新或重启 Codex 会话，然后用自然语言触发：

今天外贸 HOT
最近 TikTok Shop 有什么新规？
查一下 HS Code 9403 的出口机会
家具出口美国关税多少
最近有什么展会
红海航线现在什么情况
越南出口最近有什么变化
阿根廷外汇风险怎么样
最近外贸风险有哪些？
给我做一份德国市场开发简报

Hermes Agent

如果你的 Hermes 版本支持 GitHub Skill 安装，优先使用：

hermes skills install chnjames/tradehot-skill

也可以手动同步到 Hermes Skill 目录：

$src = "$env:TEMP\tradehot-skill"
if (Test-Path $src) { git -C $src pull } else { git clone https://github.com/chnjames/tradehot-skill.git $src }
New-Item -ItemType Directory -Force "$HOME\.hermes\skills\business\tradehot"
robocopy $src "$HOME\.hermes\skills\business\tradehot" /MIR /XD .git __pycache__ _cache /XF generated_* pipeline_* test_* *.pyc

运行示例：

hermes chat --toolsets skills,terminal,web -q "/tradehot 今天外贸 HOT"

更多说明见 Hermes Agent Compatibility。

本地验证

本项目只依赖 Python 标准库，不需要安装第三方包。

cd scripts
python test_all.py

期望结果：

ALL TESTS PASSED

一键生成简报

默认读取 sources/rss_sources.json 中启用的 RSS/Atom 源，生成标准化 item JSON 和 Markdown 报告。

cd scripts

python run_pipeline.py `
  --type daily `
  --config ..\sources\rss_sources.json `
  --items-output ..\examples\test_items.json `
  --report-output ..\examples\test_daily_report.md

支持的报告类型：

类型	用途
daily	今日外贸 HOT 日报
weekly	外贸周报
platform	平台动态
market	国家 / 市场简报
hs	HS Code / 品类机会
risk	风险雷达
opportunity	选品机会
tariff	关税与市场准入速查
calendar	外贸日历 / 展会 / 大促 / 旺季节点

常用示例：

python run_pipeline.py --type platform --platform "TikTok Shop"
python run_pipeline.py --type market --market EU
python run_pipeline.py --type hs --hs-code 9403
python run_pipeline.py --type risk
python run_pipeline.py --type opportunity
python run_pipeline.py --type tariff --category furniture --market US
python run_pipeline.py --type calendar --days 365

工作流

flowchart LR
  A["RSS / 外部 JSON / 搜索结果"] --> B["标准化 item schema"]
  B --> C["实体识别"]
  C --> D["校验"]
  D --> E["去重聚类"]
  E --> F["热度评分"]
  F --> G["用户偏好排序"]
  G --> H["动态报告分组"]
  H --> I["Markdown 报告输出"]

Loading

输入来源

RSS / Atom

python scripts\fetch_news.py `
  --mode rss-batch `
  --config sources\rss_sources.json `
  --output examples\rss_items.json

RSS 配置位于：

sources/rss_sources.json

示例：

{
  "sources": [
    {
      "id": "tradehot_sample",
      "name": "Tradehot Sample Feed",
      "url": "../examples/rss_feed_sample.xml",
      "source_tier": "industry_media",
      "enabled": true
    }
  ]
}

部署时把 url 换成真实 RSS/Atom URL 即可。

外部 JSON / 搜索结果

支持普通数组：

[
  {
    "title": "Example",
    "summary": "Example summary",
    "url": "https://example.com",
    "source": "news",
    "published_date": "2026-06-16"
  }
]

也支持常见搜索结果结构：

{
  "results": [
    {
      "name": "Search result title",
      "snippet": "Search result snippet",
      "link": "https://example.com"
    }
  ]
}

归一化：

python scripts\fetch_news.py --mode normalize --input examples\external_items_sample.json

生成报告：

python scripts\generate_report.py `
  --type daily `
  --input examples\external_items_sample.json `
  --output examples\external_daily_report.md

用户偏好

偏好配置位于：

sources/user_config.json

可配置：

• 关注市场
• 关注平台
• 关注品类
• 关注 HS Code
• 默认报告窗口
• 高风险提醒偏好

情报知识库

文件	用途
sources/tariff_reference.json	品类级关税、FTA、认证、标签、贸易救济参考
sources/trade_calendar.json	展会、大促、节假日、旺季和备货窗口
sources/competitors.json	竞争国动态监控线索
sources/logistics_hotspots.json	港口、运河、航线和运价指数观察
sources/fx_risk.json	高波动货币、支付风险国家和跨境收款提示

这些文件用于生成查询线索、报告骨架和风险提示，不替代官方数据。关税、认证、召回、制裁、出口管制等高风险事项必须复核官方来源。详见 Data Quality and Source Policy。

当前实现状态

模块	状态
日报 / 周报 / 平台 / 市场 / HS Code / 风险 / 机会报告	已闭环
关税与市场准入速查	已有静态参考 + 官方源提示，需人工复核官方税则
外贸日历	已有规划型日历，具体日期需复核主办方/平台公告
竞争国、物流热点、汇率风险	已接入日报/市场/风险报告作为情报维度
飞书推送 / 定时推送	当前为 Agent 调用建议，不内置长期后台调度器
制裁、召回、出口管制独立监控	已有官方来源预设方向，尚未形成独立报告闭环

项目结构

tradehot-skill/
├── SKILL.md
├── README.md
├── README.en.md
├── docs/
├── sources/
│   ├── sources.zh.json
│   ├── sources.en.json
│   ├── platforms.json
│   ├── markets.json
│   ├── rss_sources.json
│   ├── user_config.json
│   ├── tariff_reference.json
│   ├── trade_calendar.json
│   ├── competitors.json
│   ├── logistics_hotspots.json
│   └── fx_risk.json
├── templates/
│   ├── daily_report.md
│   ├── platform_report.md
│   ├── market_report.md
│   ├── hs_code_report.md
│   ├── risk_report.md
│   ├── product_opportunity.md
│   └── tariff_report.md
├── scripts/
│   ├── fetch_news.py
│   ├── fetch_sources.py
│   ├── source_connectors.py
│   ├── item_schema.py
│   ├── entity_extractor.py
│   ├── item_cluster.py
│   ├── normalize_items.py
│   ├── report_sections.py
│   ├── rank_items.py
│   ├── generate_report.py
│   ├── run_pipeline.py
│   └── test_all.py
└── examples/

边界与限制

• 实时信息必须使用最新来源核实。
• RSS、搜索结果和外部 JSON 只是输入来源，最终报告仍应保留来源、时间和置信度。
• 对关税、认证、制裁、出口管制、税务等事项，应以官方文件或专业意见为准。
• 本 Skill 主要用于情报整理、线索发现和业务简报，不用于自动下结论或替代人工审核。

Roadmap

• 增加更多官方来源预设。
• 增加英文 README。
• 增加示例报告截图或演示页面。
• 增加更多平台和市场维度的报告模板。