← Back to Skills Marketplace
vijays365

TomTom Traffic Commute

by vijays365 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
37
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install tomtom-traffic-commute
Description
Get real-time commute traffic using TomTom Routing API. Live travel times, delays, and ETAs.
README (SKILL.md)

TomTom Traffic Commute

Get real-time commute traffic data using the TomTom Routing API. Returns distance, travel time with live traffic, delay minutes, and ETAs.

Setup

  1. Get a TomTom API key — free tier at developer.tomtom.com (2,500 free transactions/day)
  2. Set the environment variable: TOMTOM_API_KEY

Quick Start

export TOMTOM_API_KEY=yourkey
bash scripts/tomtom-traffic.sh "51.5081,-0.0753" "50.8213,-0.1325"

Usage

Basic query

export TOMTOM_API_KEY=yourkey
bash scripts/tomtom-traffic.sh \x3Corigin-lat,origin-lon> \x3Cdest-lat,dest-lon>

Query with departure time

export TOMTOM_API_KEY=yourkey
bash scripts/tomtom-traffic.sh "51.5081,-0.0753" "50.8213,-0.1325" "2026-06-09T06:45:00+01:00"

Output format

{
  "distance_km": 84.2,
  "travel_time_min": 63,
  "traffic_delay_min": 1,
  "traffic_affected_km": 1.1,
  "departure_time": "2026-06-05T10:43:27+01:00",
  "arrival_time": "2026-06-05T11:46:50+01:00",
  "summary": "84.2 km, 63 min (delay: 1 min)"
}

Automate with Cron

Optionally combine with AgentMail for daily commute email notifications. See examples/commute-email.sh for a complete workflow.

Scripts

Script Purpose
scripts/tomtom-traffic.sh CLI tool — queries TomTom Routing API. No dependencies.
examples/commute-email.sh Optional: TomTom + AgentMail email workflow

API Reference

Uses TomTom Routing API v1 /calculateRoute endpoint:

  • Endpoint: https://api.tomtom.com/routing/1/calculateRoute/{origin}:{dest}/json
  • Parameters: traffic=true, routeType=fastest
  • Auth: API key in query string (key=)
  • Free tier: 2,500 transactions/day
  • Coordinates: lat,lon format (decimal degrees)
  • Departure time: optional — defaults to "now"
Usage Guidance
Install only if you are comfortable sending precise commute locations and optional departure timing to TomTom, and only use the AgentMail example with trusted input values until the shell scripts are fixed to pass data safely into Python instead of interpolating it into source code.
Capability Tags
cryptorequires-sensitive-credentials
Capability Assessment
Purpose & Capability
The core behavior matches the stated purpose: it takes user-provided commute coordinates, calls TomTom Routing API, and formats traffic timing output.
Instruction Scope
The documentation shows TomTom API use and the optional AgentMail workflow, but it could more plainly warn that exact commute coordinates, timing, and emailed summaries may be sent to third-party services.
Install Mechanism
There are no install-time hooks, package installs, or hidden startup steps; metadata declares bash and curl, though the scripts also require python3.
Credentials
TOMTOM_API_KEY is proportionate for the advertised API integration, and AgentMail credentials are only used by the optional example when explicitly configured.
Persistence & Privilege
The artifacts do not create persistence or background workers, but inline Python snippets interpolate shell arguments and environment values directly into source code, creating a local code-execution risk if those values are untrusted.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install tomtom-traffic-commute
  3. After installation, invoke the skill by name or use /tomtom-traffic-commute
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of TomTom Traffic Commute. - Get real-time commute traffic with TomTom Routing API. - Returns distance, travel time (with live traffic), delay minutes, and ETAs. - Simple Bash script interface; requires only curl and a free TomTom API key. - Supports scheduling (e.g., via cron) and integrates with AgentMail for daily email notifications.
Metadata
Slug tomtom-traffic-commute
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is TomTom Traffic Commute?

Get real-time commute traffic using TomTom Routing API. Live travel times, delays, and ETAs. It is an AI Agent Skill for Claude Code / OpenClaw, with 37 downloads so far.

How do I install TomTom Traffic Commute?

Run "/install tomtom-traffic-commute" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is TomTom Traffic Commute free?

Yes, TomTom Traffic Commute is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does TomTom Traffic Commute support?

TomTom Traffic Commute is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created TomTom Traffic Commute?

It is built and maintained by vijays365 (@vijays365); the current version is v1.0.0.

💬 Comments