mcpField
T
travel-companion

travel-companion

github.com/banjthemanProductivity0290 installsUpdated 39w ago
Repository

About travel-companion

travel-companion is an agent skill for travel planning, destination research, and itinerary management. It guides browser research across social platforms, events, maps, and travel information, then compiles weather, activities, addresses, and costs, with an option to email the itinerary.

Key features

  1. 01Clarify destination, dates, budget, and interests
  2. 02Research travel and event information in a browser
  3. 03Read page snapshots and extract details
  4. 04Compile activities, weather, and costs
  5. 05Offer itinerary delivery through AgentMail

Use cases

  1. 01Plan a weekend city itinerary
  2. 02Find local events for specific dates
  3. 03Organize a trip around a budget
  4. 04Compile attraction addresses and costs for email sharing

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/banjtheman/travel-companion-skill --skill travel-companion

After installing, type/travel-companionin Claude Code to confirm it loaded.

Bundled filesreferences/agentmail.mdreferences/browser.md

Details

From the project README

Travel Companion

Assist users with travel planning, destination research, and itinerary management.

Quick Start

  1. Clarify the request - Confirm destination, dates, budget, and interests
  2. Research - Use browser with profile: "openclaw" to search:
    • TikTok for trending local tips
    • Instagram for events and spots
    • Eventbrite for specific dates
    • Google Maps for attractions
    • Expedia for flights/hotels
  3. Take snapshots - Read pages with snapshotFormat: "ai"
  4. Compile - Create summary with activities, weather, costs
  5. Offer to email - Send itinerary via AgentMail

Browser Usage

Always use profile: "openclaw":

{
  "action": "navigate",
  "targetUrl": "https://www.tiktok.com/search?q=fun%20things%20to%20do%20in%20tokyo",
  "profile": "openclaw"
}

No extension needed - OpenClaw manages the browser directly.

Search URLs

TikTok (trending tips): https://www.tiktok.com/search?q={query}

Instagram (events): https://www.instagram.com/explore/search/keyword/?q={query}

Eventbrite (specific dates): https://www.eventbrite.com/d/{city}/events-{date}/

Google Maps (attractions): https://www.google.com/maps/search/best+attractions+{city}

Expedia (flights): https://www.expedia.com/Flights-Search?trip=roundtrip&from={from}&to={to}&dates={date1},{date2}

Workflow

  1. Navigate to URL with action: "navigate"
  2. Wait for load with action: "act", request: { kind: "wait", timeMs: 5000 }
  3. Read page with action: "snapshot", snapshotFormat: "ai"
  4. Extract relevant info from snapshot text

Email Itinerary

Use AgentMail with AGENTMAIL_API_KEY - see references/agentmail.md

Response Format

Keep concise with emojis for visual appeal:

  • Weather summary
  • TikTok/Instagram highlights
  • Eventbrite events
  • Attractions with addresses
  • Cost estimates

End with: "More details or email this itinerary?"

Troubleshooting

"Can't reach browser" - User runs: openclaw browser start

Instagram blocks access - Use TikTok and Eventbrite instead

Page won't load - Increase wait time to 5000ms+, try alternate URLs

Examples

Day trip:

User: What's fun in DC on Friday?

Search TikTok for trending DC tips, Instagram for events,
Eventbrite for Friday activities. Snapshot each page.
Summarize top 3-5 options with addresses and costs.

Full trip:

User: Plan a weekend in Miami under $500

Research Expedia for flights/hotels, Instagram for beach spots,
TikTok for food tips. Create 2-day itinerary. Offer to email.

Comments

Markdown supported