美国关税开放数据集使用教程：Excel / Python / Google Sheets 三种姿势
Invoice × Tariff 编辑部
适用对象想要原始税率数据的分析师、开发者与研究者——用 Excel、pandas、Google Sheets 或自己的管道。
从关税数据页下载逐码 CSV（或 clone GitHub 数据仓），Excel 直接打开、pandas 用 read_csv 读、Google Sheets 用 IMPORTDATA 直连。每个文件都带 ruleset_version，CC BY 4.0 发布（引用请注明 InvoiceTariff.com、版本号与 data-as-of 日期），与站点计算器同源同步。
什么活用什么数据集
所有开放数据都来自驱动计算器的同一份版本化规则快照，数字在各处互通。按需取用：
| 数据集 | 适合 | 获取 |
|---|---|---|
| 逐码税率 CSV | 一行一个高频 HTS 8 位码：品名、MFN 普通税率、对华 301 清单/税率、232 章节命中、ruleset_version |
关税数据页下载 |
| 经济体档位 CSV | 2026 全球 301 计划：各原产经济体档位、Chapter 99 对应、生效日期 | 关税数据页下载 |
| Section 232 税层 CSV | 每项行业措施：HTS 章节范围、税率、生效日期、来源 URL | 关税数据页下载 |
| us-tariff-rates-2026 | 叠加税层的单文件数据集，可 clone 或 vendor 进工程 | GitHub |
| hs-codes-database | 全量 HTS 8 位码表（5,689 码）——不止高频集 | GitHub |
npm 包里的 rulesetSeed |
同一份数据的强类型 JSON 形态，适合"要计算"而不是"要关联"的代码 | npm install us-tariff-lookup |
Excel / Google Sheets
CSV 在 Excel 里直接打开（本地编码出问题时用 数据 → 自文本/CSV）。Google Sheets 连下载都省了：
=IMPORTDATA("https://invoicetariff.com/data/us-tariff-ruleset-hts-codes.csv")
筛对华 301 列即可看自家哪些码带加征；按章节透视 MFN 税率即可比较品类。ruleset_version 列随每行走，你表格的截图永远能证明数字出自哪一版快照。
Python（pandas）
import pandas as pd
codes = pd.read_csv("https://invoicetariff.com/data/us-tariff-ruleset-hts-codes.csv")
# 我的目录里哪些高频码带对华 301？
my_codes = ["61091000", "84713001", "73181500"]
hits = codes[codes["hts8"].astype(str).str.zfill(8).isin(my_codes)]
# 在 MFN 之上叠加对华 301（两者都按申报值百分比）
# —— 但要含 232 范围、规费与落地成本的完整叠加，请直接用引擎。
做关联和报表，CSV 够用；要做按日期感知的叠加计算（申报日期、运输方式、规费、邮政档位），请用 us-tariff-lookup 引擎，别自己重实现叠加顺序——规则里有 232 互斥组、规费封顶这类反直觉细节。
许可与引用格式
数据以 CC BY 4.0 发布：商用、修改、再分发都可以，唯一条件是署名。合格引用写明发布方、数据集版本与 as-of 日期：
InvoiceTariff.com, U.S. Tariff Ruleset v<版本>, data as of <asOf 日期>, CC BY 4.0.
两个值都印在每个 CSV 里，npx us-tariff meta 也能查。发布派生数据时把版本戳一起带上——税率月月在变，不带版本的关税表会很快过期。
保持最新
税率调整持续落地——这正是关税雷达存在的意义：带新旧值与来源的 changelog，附 RSS。GitHub 各仓与站点快照同步更新；watch 税率数据仓即可收到通知，版本一动就重新下载（或重新固定 npm 版本）。
诚实读取质量标记
尚未逐行对照 Federal Register 原文核实的行带 sample / unverified 标——用于规划、报价与演示没问题，不能作为正式报关依据。已核实的行都链官方来源（USITC / Federal Register / CBP），让你的下游用户也能核对。
常见问题
- 数据集可以商用吗？
- 可以。数据按 CC BY 4.0 发布——署名即可商用、修改、再分发，引用格式：InvoiceTariff.com + 规则集版本号 + data-as-of 日期。代码（引擎、站点、应用）单独按 MIT 许可。
- 数据集多久更新一次？
- 规则快照随关税动作生效持续重建——至少每月一次——CSV、GitHub 仓与 npm 包与站点同批重建。watch 税率数据仓或订阅关税雷达 RSS 即可抓住版本更新。
- 两个 GitHub 仓有什么区别？
- us-tariff-rates-2026 是叠加税层的单文件数据集（MFN、对华 301、全球 301、232），与引擎规则集同源；hs-codes-database 是全量 5,689 码 HTS 8 位码表，覆盖高频集之外的范围。要计算用前者，要查码用后者。
- 为什么有些行标 sample 或 unverified？
- 这些行还没有逐行对照 Federal Register 原文核实。用于规划与演示没问题，但被明确标记，以免误当成核定报关数据——已核实的行会链接官方来源。
- 可以把筛选后的 CSV 再分发进我自己的项目吗？
- 可以，按 CC BY 4.0 署名即可。把 ruleset_version 与 as-of 戳随数据保留（放列里或 README 一行），下游用户才知道数字出自哪一版快照。
逐码税率、经济体档位与 Section 232 税层 CSV，CC BY 4.0，随站点规则快照版本化。