tripgo-api
Comprehensive interface for the TripGo API, covering routing, public transport, trips, and location services. Use for multimodal journey planning, public transport data, and geocoding. Works well with location-discovery skills (e.g., goplaces) to resolve POIs and pass coordinates to compute and compare route options and costs (e.g., taxi fares) across transport modes.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/guanyu-zhang/tripgo-apiTripGo API Skill
This skill provides a complete interface to the TripGo API, enabling agents to perform multimodal routing, retrieve public transport information, manage trips, and perform geocoding.
Overview
The TripGo API is a platform for multimodal transport, allowing users to plan trips combining public transport, car, bike, taxi, rideshare, and more. This skill encapsulates the API endpoints into modular scripts and documentation references.
A key advantage is mode-aware trip comparison from the same origin/destination context, enabling assistants to return practical route choices with transport-type tradeoffs in one workflow. It also works exceptionally well with location-discovery skills (e.g., Google Places / goplaces): resolve a place first, then pass coordinates/IDs into TripGo routing to produce actionable journey options, including fare signals and cost estimates (e.g., taxi fares) when provided by upstream operators.
Configuration
To use this skill, you must set the following environment variables:
TRIPGO_API_KEY: Your TripGo API key (header:X-TripGo-Key). Get it here: https://skedgo.com/tripgo-api/TRIPGO_BASE_URL: (Optional) Base URL for the API. Defaults tohttps://api.tripgo.com/v1.TRIPGO_WEBHOOK_ALLOWLIST: (Optional, recommended) Comma-separated allowlist of webhook domains (e.g.example.com,webhooks.example.org).TRIPGO_ALLOW_UNSAFE_WEBHOOK: (Optional, defaultfalse) Set totrueto bypass webhook allowlist checks for trusted/manual debugging only.
Runtime Requirements
Install these binaries before running scripts:
curl(required): API requestsjq(required): JSON validation, safe JSON construction, and URL encodingpython3(optional): pretty-printing for a few scripts
Security Notes
- Scripts that accept JSON parameters validate those values with
jqbefore sending requests. - Scripts that send query parameters URL-encode user-provided values.
- Webhook hook registration enforces
https://and domain allowlisting by default (TRIPGO_WEBHOOK_ALLOWLIST) to reduce exfiltration risk. - API key usage is expected: requests send
X-TripGo-Keyto the configured TripGo base URL.
Directory Structure
SKILL.md: This file.references/: Detailed documentation for each API section.scripts/: Executable Bash scripts for each API endpoint.
References (references/)
Documentation is organized by API section. Load these files to understand specific endpoints, parameters, and response structures.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-guanyu-zhang-tripgo-api": {
"enabled": true,
"auto_update": true
}
}
}