Travel Information and News

Aggregates travel news, destination info, and reviews from multiple sources.

⚠️ CRITICAL RULE: Output language MUST match the user's query language. If the user writes in Chinese, ALL output (titles, content, summaries) must be in Chinese. If in Japanese, output in Japanese. Never return raw English results when the query is in another language.

Quick Start

# Required: TAVILY_API_KEY in env or ~/.openclaw/.env
# Optional: BRAVE_API_KEY for Brave Search fallback

python scripts/search.py --query "Tokyo travel March 2026" --format text
python scripts/search.py --query "京都賞櫻推薦" --format pdf --output result.pdf
python scripts/search.py --query "Bali hotel reviews" --format docx --output result.docx

Search Sources

Installing Optional Sources

Brave Search: Set BRAVE_API_KEY env var.

Browser suite (三件套): Requires three components working together:

• Xvfb — Virtual framebuffer (provides a fake display for Chromium, default: 1200x720x24)
• Chromium — Browser engine
• Puppeteer (Node.js) — Controls Chromium programmatically

Why not headless mode? Some websites block headless browsers. Running Chromium on a virtual display (Xvfb) makes it appear as a real browser, bypassing most detection.

Note: For advanced interactions requiring simulated clicking (e.g., navigating paginated results, clicking "load more" buttons), install the desktop-control skill from ClawHub:

npx clawhub install desktop-control

Installation:

# Xvfb + Chromium
apt-get install -y xvfb chromium

# Puppeteer
npm install puppeteer

Parameters

All parameters can be customized. Defaults are provided.

Output Formats

• text — Plain text summary to stdout
• docx — Word document with structured sections
• pdf — PDF with Noto Sans SC font (supports CJK)

Review Sources

When reviews are requested, the skill attempts to aggregate ratings from:

• TripAdvisor (via browser scraping)
• Google Maps / Google Reviews (via browser scraping)

Workflow

1. Receive user query
2. Detect query language — output MUST match this language unless user specifies otherwise
3. Search Tavily with query + parameters
4. If results insufficient → optionally try Brave Search
5. If specific sites blocked → optionally use browser suite
6. If reviews requested → aggregate ratings
7. Compile and deduplicate results
8. Translate all results to detected/specified language (critical: query language ≠ result language)
9. Format output (text / docx / pdf)

Limits

• Browser suite requires ~512MB RAM for Xvfb + Chromium
• Review scraping depends on site structure (may break if sites change)
• Rate limits apply to Tavily and Brave APIs