关于 taxlocus
taxlocus 发布美国销售税和工资税的开放参考数据集,面向处理税务数据的开发者和分析人员。数据表提供 CSV 和 JSON 格式,工资税记录附有来源引用;它不提供地址级查询或税额计算。
主要功能
- 01州及地方销售税税率
- 02各州经济关联门槛
- 03按产品类别划分的应税规则
- 04工资税税率和工资基数
- 05CSV 和 JSON 数据表
适用场景
- 01查询指定辖区的税率
- 02比较各州经济关联门槛
- 03核对产品类别的州级应税情况
- 04根据引用来源核实工资税参考值
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.taxlocus.com/mcpclaude mcp add --transport http com-taxlocus-taxlocus https://api.taxlocus.com/mcp{"mcpServers":{"com-taxlocus-taxlocus":{"type":"http","url":"https://api.taxlocus.com/mcp"}}}在 Cursor 中打开{"servers":{"com-taxlocus-taxlocus":{"type":"http","url":"https://api.taxlocus.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-taxlocus-taxlocus":{"type":"http","url":"https://api.taxlocus.com/mcp"}}}{"mcpServers":{"com-taxlocus-taxlocus":{"serverUrl":"https://api.taxlocus.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
TaxLocus 开放销售税数据集
免费的美国销售税税率表,每周更新——这是 TaxLocus 背后的扁平化数据,作为开放数据集发布,供社区使用。
数据截至:2026-05-19 · 基于 TaxLocus 实时数据集每周刷新。
这是什么
美国销售税税率和规则的整洁扁平化快照:
- 所有征收销售税的州的州基础税率。
- 地方辖区税率——约 14,000 个县、市、教区、自治市镇、交通和特别辖区。
- 经济关联门槛——各州针对远程卖家的注册触发条件。
- 应税性矩阵——州 × 产品类别的应税/免税处理方式。
每张表都提供 CSV 和 JSON 格式。
这不是什么
这里只包含税率数据。地址级查询 API、用于确定地址所属辖区组合的多边形几何数据,以及关联追踪工具,均为付费产品,详见 taxlocus.com。此数据集可以告诉你某个指定辖区的税率,但无法告诉你某个街道地址属于哪些辖区。
文件与架构
所有文件都位于 data/。
state_rates — 全州基础税率
| column | description |
|---|---|
state | 2 位州代码 |
rate | 全州基础销售税税率(小数,例如 0.0625) |
jurisdiction_rates — 地方辖区税率
| column | description |
|---|---|
state | 2 位州代码 |
jurisdiction_type | county、city、parish、borough、transit 或 special_district |
name | 辖区名称 |
fips_code | 可用时提供的人口普查 FIPS 代码(可能为空) |
rate | 该辖区的地方税率(小数) |
nexus_thresholds — 经济关联门槛
| column | description |
|---|---|
state | 2 位州代码 |
sales_threshold | 销售额门槛(USD,可能为空) |
transaction_threshold | 交易笔数门槛(可能为空) |
logic | sales_only、transactions_only、sales_or_count 或 sales_and_count |
measurement_period | prior_calendar_year、current_or_prior_cy、rolling_12_month 或 prior_4_quarters |
taxability — 州 × 类别应税性矩阵
| column | description |
|---|---|
state | 2 位州代码 |
category | 产品类别代码(例如 food.grocery、clothing.general) |
taxable | True/False |
treatment | taxable、exempt、reduced_rate、exempt_with_cert 或 partial |
manifest.json
当前快照的生成日期和各文件行数。
工资税开放数据(新增 — Plan 14)
美国工资税参考表——联邦 FICA/FUTA、州个人所得税(PIT)和 SUTA 工资基数,以及适用地区的地方所得税(宾夕法尼亚州、俄亥俄州、马里兰州、印第安纳州、纽约市等)。结构相同,采用 CC-BY-4.0 许可;每行都附有指向权威来源(IRS、州税务局、州失业保险机构)的 citation_url,方便对照来源核验或更新数据。这里只提供税率/参考数据,不是预扣税计算引擎,也不包含按雇主确定的 SUTA 经验税率(该税率由州分配,无法通过查询获得)。使用者需自行计算预扣税并承担相应责任。
payroll_federal_rates
按年份列出 FICA(社保 + Medicare + 超过 $200k 部分的 0.9% 额外 Medicare)和 FUTA 的税率、工资基数及最高抵免额。
payroll_state_pit — 州个人所得税(工资预扣)
| column | description |
|---|---|
year | 纳税年度 |
state | 2 位州代码 |
tax_type | none(无工资所得税)/ flat(统一税率)/ progressive(累进税率) |
flat_rate | 统一税率(tax_type='flat' 时) |
top_marginal | 最高边际税率(tax_type='progressive' 时) |
bracket_summary | 可选的税率档位简要 JSON |
supplemental_rate | 已公布时的补充收入(奖金)预扣税率 |
citation_url | 州 DOR / 预扣税指南 |
notes | 各州具体说明 |
payroll_state_suta — 州失业保险工资基数及税率范围
| column | description |
|---|---|
year | 纳税年度 |
state | 2 位州代码 |
wage_base | 每名员工的年度 SUTA 工资基数 |
new_employer_rate | 已公布时的新雇主适用税率 |
min_rate / max_rate | 经验税率范围的上下限 |
citation_url | 州 UI 机构 |
不包含各雇主的 SUTA 税率——各雇主的税率根据其经验记录评级,并由州 UI 机构每年核定。
payroll_local_income_tax — 市 / 县 / 市镇所得税
| column | description |
|---|---|
year | 纳税年度 |
state | 2 位州代码 |
jurisdiction_type | city / county / municipality / school_district / township / borough |
jurisdiction_name | 例如:Philadelphia、Anne Arundel County、New York City |
geoid | 已知时提供 FIPS / place GEOID |
resident_rate / non_resident_rate | 预扣税率 |
courtesy_withholding | 州是否公布礼遇预扣标记 |
citation_url | 州 DOR / 地方机构 |
地方所得税覆盖范围(3,662 条记录,8 个州): PA(2,627 个 PSD)·
OH(890 个市镇:RITA + CCA + DOR 自主管理)· IN(92 个县)·
MD(24 个县)· MI(24 个城市)· NY(NYC + Yonkers)· MO(KC + STL)·
DE(Wilmington)。其余约 8 个征收地方所得税的州尚未覆盖(KY、IA、OR、AL、CO、WV、KS、NJ-Newark);其他约 34 个州完全不征收地方所得税。依赖此数据进行预扣前,请阅读 PAYROLL-COVERAGE.md——其中详细记录了所有缺口和免责声明。
payroll_reciprocity — 州所得税互惠协议
| column | description |
|---|---|
state_a / state_b | 两个州 |
direction | mutual(互惠)或 a_to_b(单向) |
citation_url | 州 DOR |
员工提交豁免表格(例如 PA REV-419、MD MW507)后,互惠协议可免除非居民州的预扣税。
许可与署名
本数据集采用 知识共享署名 4.0 国际版(CC-BY-4.0) 许可——请参阅 LICENSE。
您可以使用、分享和改编这些数据,包括用于商业用途,但必须注明出处。所需署名:
销售税数据由 TaxLocus 提供 — https://taxlocus.com
免责声明
本数据集仅供参考,不构成税务建议。销售税率和规则经常变化,特殊税区和地方边界较为复杂,此快照可能包含错误或遗漏。在用于申报或缴纳税款前,请务必向相关州税务局核实。TaxLocus 不对准确性、完整性或任何用途的适用性作出保证。
需要精确到地址的数据吗?
免费数据集提供按命名辖区划分的税率。若要将实际街道地址解析为精确的辖区组合——包括几何数据、产品应税性和经济关联追踪——请使用 taxlocus.com 上的 TaxLocus API。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。