SkillHub

simulated-roadtrip

v1.0.1

基于真实谷歌地图数据生成解说式公路旅行,包含GPS验证停靠点与主题描述,支持定时更新或聊天发布。

Sourced from ClawHub, Authored by JPaulGrayson

Installation

Please help me install the skill `simulated-roadtrip` from SkillHub official store. npx skills add JPaulGrayson/simulated-roadtrip

Simulated Road Trip

Let your Clawbot go on a GPS-grounded road trip through the real world. Pick a route, choose a theme, and Turai generates narrated stops using real Google Maps data. Your agent posts updates as it "travels."

Concept

Your agent picks a starting point and destination, and the Turai Road Trip API plans a real route with actual stops along the way. Each stop includes:

  • Real location data — GPS coordinates, place names, distances from Google Maps
  • Themed narration — Written from the perspective of someone actually traveling there
  • Atmosphere details — What you'd see, hear, smell, eat at each stop

The agent can drip-feed these stops over time — one per hour, one per day — creating an ongoing travel narrative in chat, on Moltbook, or any messaging channel.

Themes

Theme Focus
history Historical landmarks, battlefields, monuments
foodie Local restaurants, street food, regional specialties
haunted Ghost stories, abandoned places, local legends
weird Roadside attractions, oddities, world's largest things
nature National parks, scenic overlooks, wildlife
art Galleries, murals, public art installations
architecture Notable buildings, bridges, urban design
music Venues, birthplaces of musicians, music history
literary Bookstores, author homes, fictional settings
film Filming locations, movie landmarks
spiritual Temples, churches, sacred sites
adventure Extreme sports, hiking, off-the-beaten-path

Setup

  1. Get a Turai API key from turai.org
  2. Set the environment variable: bash export TURAI_API_KEY="your-key-here"

Usage

From the command line

# Basic road trip — NYC to LA, 5 stops, foodie theme
node skills/simulated-roadtrip/scripts/roadtrip.mjs 
  --from "New York City" 
  --to "Los Angeles" 
  --theme foodie 
  --stops 5

# Haunted road trip through New England
node skills/simulated-roadtrip/scripts/roadtrip.mjs 
  --from "Salem, MA" 
  --to "Sleepy Hollow, NY" 
  --theme haunted 
  --stops 4

# Drip-feed mode — post one stop every 2 hours
node skills/simulated-roadtrip/scripts/roadtrip.mjs 
  --from "Nashville, TN" 
  --to "New Orleans, LA" 
  --theme music 
  --stops 6 
  --drip 2h

# Save trip data to JSON for later use
node skills/simulated-roadtrip/scripts/roadtrip.mjs 
  --from "Tokyo" 
  --to "Kyoto" 
  --theme art 
  --stops 4 
  --output trip.json

Drip-feed intervals

  • 1h, 2h, 4h — hours between posts
  • 1d — one stop per day
  • 30m — every 30 minutes (for impatient travelers)

From your agent

"Take a road trip from Chicago to Austin, music theme, 5 stops"

The agent should run the script, then post each stop as a chat message or social update.

API Reference

Endpoint: POST https://turai.org/api/agent/roadtrip

Headers: - x-api-key: Your Turai API key - Content-Type: application/json

Body:

{
  "from": "New York City",
  "to": "Los Angeles",
  "theme": "foodie",
  "stops": 5
}

Response: JSON with array of stops, each containing location data and narration.

Files

  • SKILL.md — This file
  • scripts/roadtrip.mjs — Main script