什么是 ZipTax 销售税查询？

此 Openclaw Skills 扩展赋予 AI 代理在超过 12,000 个美国司法管辖区执行精确销售税查询的能力。通过利用 ZipTax API，它为地址查询提供门牌级的准确性，并支持基于坐标和邮政编码的查询。

它旨在处理复杂的税务场景，包括服务和运费的可征税性，帮助开发人员和自动化代理将税务计算直接集成到财务工作流或电子商务应用程序中。该技能专注于通过最新的 ZipTax v60 API 规范提供技术准确性。

下载入口:https://github.com/openclaw/skills/tree/main/skills/ericlakich/ziptax

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

ZipTax 销售税查询 应用场景

• 电子商务结账流程中销售税的自动计算。
• 审核特定美国地址或精确 GPS 坐标的税率。
• 获取用于财务报告的司法管辖区明细（州、县、市、区）。
• 检查特定区域内服务和运输的征税规则。
• 通过 Openclaw Skills 监控税务数据消耗的 API 使用情况和账户指标。

1. 用户或代理提供位置标识符，如完整地址、经纬度或邮政编码。
2. 该技能识别最佳查询方法，优先选择门牌级地址验证以获得比简单邮政编码查询更高的准确度。
3. 向通过 X-API-KEY 标头验证的 ZipTax v60 API 端点发送 GET 请求。
4. 技能解析响应元数据，在继续操作前确保代码为 100 的成功状态。
5. 详细数据（包括总合并税率和特定司法管辖区的个人基础税率）以结构化格式返回。

ZipTax 销售税查询 配置指南

要在 Openclaw Skills 框架内使用此技能，您必须从 ZipTax 平台获取 API 密钥。在终端或配置文件中将 API 密钥设置为环境变量：

export ZIPTAX_API_KEY='your_api_key_here'

您可以通过运行包含的查询脚本来验证设置：

./scripts/lookup.sh --postalcode 90210

ZipTax 销售税查询 数据架构与分类体系

该技能根据 ZipTax JSON 架构处理并返回数据。关键字段包括：

name: ziptax-sales-tax
description: >
  Look up U.S. sales tax rates using the ZipTax API. Use when the user asks about sales tax rates,
  tax calculations for a U.S. address/ZIP code/coordinates, freight or service taxability,
  jurisdiction-level tax breakdowns, use tax vs sales tax, or needs to integrate sales tax
  data into an application. Also handles account usage metrics and product taxability codes (TIC).
  Supports address-level (door-level), lat/lng, and postal code lookups across 12,000+ jurisdictions.

ZipTax Sales Tax Lookup

Setup

Set ZIPTAX_API_KEY env variable with your API key from https://platform.zip.tax (DEVELOP > API Keys). Free tier gives 100 calls/month. Never share your API key publicly.

Quick Start

Address Lookup (most accurate)

curl -s "https://api.zip-tax.com/request/v60?address=200+Spectrum+Center+Drive+Irvine+CA+92618" r
  -H "X-API-KEY: $ZIPTAX_API_KEY"

Postal Code Lookup

curl -s "https://api.zip-tax.com/request/v60?postalcode=92618" r
  -H "X-API-KEY: $ZIPTAX_API_KEY"

Lat/Lng Lookup

curl -s "https://api.zip-tax.com/request/v60?lat=33.6525&lng=-117.7479" r
  -H "X-API-KEY: $ZIPTAX_API_KEY"

Workflow

1. Determine lookup type: address (best), lat/lng, or postal code
2. Use v60 (latest) for full jurisdiction breakdowns; use v10 for simple combined rate
3. Make GET request to https://api.zip-tax.com/request/v60 with auth header
4. Check metadata.response.code — 100 means success
5. Read taxSummaries[0].rate for total sales tax rate
6. Read baseRates array for state/county/city/district breakdown
7. Check service.taxable and shipping.taxable for service/freight taxability

Key Points

• Address > Postal code: Address gives one exact result; postal code returns all rates in that ZIP
• Auth: Header X-API-KEY or query param key
• Rate format: Decimal (0.0775 = 7.75%)
• Response code 100 = success; check metadata.response.code
• Metrics endpoint (/account/metrics) does not count against quota

Bundled Resources

• scripts/lookup.sh — CLI wrapper for quick lookups. Run with --address, --lat/--lng, --postalcode, or --metrics
• references/api-reference.md — Full API reference with all endpoints, response schemas, code samples, response codes, and SDK links. Read when you need endpoint details or response field definitions.