TianAPI Vehicle Limit Lookup for Openclaw

An Openclaw Skills integration that fetches city vehicle restriction rules, tail-number limits, zones, and penalty details from TianAPI.

workxin
v1.0.0
Jul 13, 2026
0
462
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install tianapi-vehiclelimit

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install tianapi-vehiclelimit 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 TianAPI Vehicle Limit Lookup?

TianAPI Vehicle Limit Lookup is an Openclaw Skills package for retrieving city driving restriction data from TianAPI. It supports lookups by city name or city code and returns local-vehicle and out-of-town vehicle restrictions, rule windows, restricted zones, and fine standards in a format that is easy for agents and scripts to consume.

Use it when your workflow needs fast answers about traffic limitations before a route is planned, a trip is confirmed, or a compliance check is performed. Openclaw Skills can call the bundled scripts/fetch_vehiclelimit.py wrapper or hit the REST endpoint directly, making the skill suitable for both automation pipelines and ad-hoc command-line queries.

TianAPI Vehicle Limit Lookup Use Cases

  • Checking today’s local and non-local vehicle restrictions before driving into a city.
  • Building travel assistants that warn users about tail-number bans, time windows, or zone-specific limits.
  • Automating route planning or dispatch decisions for fleets, delivery teams, or field sales reps.
  • Verifying whether a city’s restriction policy applies to a vehicle by name or code.
  • Embedding Openclaw Skills into CLI workflows that need fast, structured traffic rule lookups.

How TianAPI Vehicle Limit Lookup Works

  1. The user asks for vehicle restriction information for a city and supplies either a city name or a city code.
  2. The skill resolves the request parameters and reads the TianAPI key from the configured environment variable, .env file, or inline CLI argument.
  3. Openclaw Skills runs scripts/fetch_vehiclelimit.py or issues a direct GET request to the TianAPI vehicle limit endpoint.
  4. TianAPI returns structured JSON containing city, localcar, foreigncar, and limitinfo data.
  5. The skill formats the response into a concise, readable summary and maps any API error codes to actionable guidance.
  6. If the request is incomplete or the network fails, the skill surfaces the specific failure state so the caller can retry or correct the input.

TianAPI Vehicle Limit Lookup Setup

  1. Install prerequisites: ensure Python 3 is available.
python3 --version
  1. Register at TianAPI, apply for the city vehicle limit interface, and copy your API key.

  2. Configure authentication using one of the supported Openclaw Skills patterns:

export TIANAPI_VEHICLELIMIT_KEY=your_api_key
echo "TIANAPI_VEHICLELIMIT_KEY=your_api_key" > scripts/.env
  1. Run a lookup or test the REST endpoint:
python3 scripts/fetch_vehiclelimit.py your_api_key --city 北京
curl "https://apis.tianapi.com/vehiclelimit/index?key=YOUR_API_KEY&city=北京"

TianAPI Vehicle Limit Lookup Data Schema & Taxonomy

Runtime artifacts

  • scripts/fetch_vehiclelimit.py: command-line wrapper that encapsulates the lookup flow.
  • scripts/.env: optional local secret store for TIANAPI_VEHICLELIMIT_KEY.
  • Stdout / JSON response: primary output surface; no database or cache is defined.

Request taxonomy

  • key: TianAPI authentication token.
  • city: city name lookup, such as 北京.
  • code: city code lookup, such as 110100.
  • city and code are mutually exclusive selectors.

Core response schema

Field Type Meaning Example
city string Target city name 北京
localcar array Restrictions for local vehicles [{"date": "07月13日周一", "weihao": "1和6"}]
foreigncar array Restrictions for out-of-town vehicles [{"date": "07月13日周一", "weihao": "1和6"}]
limitinfo array Detailed rule records with vehicle type, rules, time windows, and zones [...]

Metadata taxonomy

  • Authentication: TIANAPI_VEHICLELIMIT_KEY environment variable or inline key input.
  • Policy dimensions: vehicle origin, tail-number rule, allowed time range, restricted area, and penalty standard.
  • Error states: 150 quota exhausted, 160 interface not applied, 230 invalid key, 240 missing key parameter, 250 empty result, 280 missing city or code, plus network timeout.

TianAPI Vehicle Limit Lookup Advanced Features

  • Dual invocation model: use the Openclaw Skills wrapper or call TianAPI directly over HTTPS.
  • Flexible query normalization with either city name or city code.
  • Split local-car vs foreign-car outputs for faster human review and downstream routing logic.
  • Explicit error code handling for quota, application, auth, missing-parameter, and empty-data states.
  • Environment-variable, .env, and inline-key auth patterns suited to automation and CI-style runs.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins python3
Github Stars: 0
forks: 0

Featured*