A specialized skill for retrieving real-time U.S. sales tax rates and jurisdictional breakdowns via the ZipTax API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ziptax
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install ziptax using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is ZipTax Sales Tax Lookup?
This Openclaw Skills extension empowers AI agents to perform precise sales tax lookups across over 12,000 U.S. jurisdictions. By leveraging the ZipTax API, it provides door-level accuracy for address lookups, as well as support for coordinate-based and postal code queries.
It is designed to handle complex tax scenarios, including service and freight taxability, helping developers and automated agents integrate tax calculations directly into financial workflows or e-commerce applications. The skill focuses on delivering technical accuracy through the latest ZipTax v60 API specifications.
ZipTax Sales Tax Lookup Use Cases
- Automated calculation of sales tax for e-commerce checkout flows.
- Auditing tax rates for specific U.S. addresses or precise GPS coordinates.
- Retrieving jurisdictional breakdowns (state, county, city, district) for financial reporting.
- Checking taxability rules for services and shipping within specific regions.
- Monitoring API usage and account metrics for tax data consumption through Openclaw Skills.
How ZipTax Sales Tax Lookup Works
- The user or agent provides a location identifier such as a full address, latitude/longitude, or postal code.
- The skill identifies the optimal lookup method, preferring door-level address validation for maximum accuracy over simple ZIP code lookups.
- A GET request is dispatched to the ZipTax v60 API endpoint authenticated via the X-API-KEY header.
- The skill parses the response metadata, ensuring a code 100 success status before proceeding.
- Detailed data, including the total combined rate and individual base rates for specific jurisdictions, is returned in a structured format.
ZipTax Sales Tax Lookup Setup
To use this skill within the Openclaw Skills framework, you must obtain an API key from the ZipTax platform. Set the API key as an environment variable in your terminal or configuration file:
export ZIPTAX_API_KEY='your_api_key_here'
You can verify the setup by running the included lookup script:
./scripts/lookup.sh --postalcode 90210
ZipTax Sales Tax Lookup Data Schema & Taxonomy
The skill processes and returns data based on the ZipTax JSON schema. Key fields include:
| Field | Type | Description |
|---|---|---|
taxSummaries[0].rate |
Decimal | The total combined sales tax rate (e.g., 0.0775 for 7.75%). |
baseRates |
Array | Breakdown of rates for State, County, City, and District levels. |
service.taxable |
Boolean | Indicates if services are taxable in that specific jurisdiction. |
shipping.taxable |
Boolean | Indicates if shipping/freight is taxable in the jurisdiction. |
metadata.response.code |
Integer | Status code where 100 indicates a successful lookup. |
ZipTax Sales Tax Lookup Advanced Features
- Support for door-level address accuracy which is significantly more precise than postal code-only lookups.
- Dual-version API support (v60 for detailed breakdowns, v10 for simple combined rates).
- Built-in metrics endpoint support to track usage quotas without consuming API credits.
- Integrated CLI wrapper for quick terminal-based lookups and debugging within Openclaw Skills environments.
- Comprehensive handling of Product Taxability Codes (TIC) and use tax vs sales tax distinctions.
SKILL.md
Loading
Related Openclaw Skills
Professional Chinese Text Summarizer (Pro Zh-Summary)
A professional-grade Chinese summarization tool that uses MT5 architecture to transform long-form content into concise abstracts.
Otter.ai CLI
A powerful command-line interface for searching, downloading, and managing Otter.ai meeting notes and transcripts.
Baserow
A powerful skill for interacting with Baserow tables and rows via REST API to automate CRM and pipeline data management.
Recursive Self-Improvement AI Agent
An advanced AI agent skill designed for autonomous error detection, recursive code optimization, and intelligent system recovery.
antitempmail
A robust email validation tool that identifies and blocks temporary or disposable email addresses via the AntiTempMail API.
Jellyseerr Media Manager
A powerful automation tool for requesting and managing movies and TV shows via Jellyseerr for self-hosted media servers.
Featured*
