Simulated Roadtrip

Generate a narrated road trip with GPS-verified stops and themed descriptions using real Google Maps data, posted in timed updates or chat.

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

bash

# 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:

json

{
  "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