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:

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:

   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

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:

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

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

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.

1. Get a Turai API key from turai.org 2. Set the environment variable:

   export TURAI_API_KEY="your-key-here"