AGENT SKILL

atlas-obscura

Search Atlas Obscura for weird, wonderful, and hidden gem places near any destination. Find the interesting stuff, not boring plaques. Search by coordinates, get full details with descriptions and images.

License 许可
MIT
最近更新
2026-11-09
Stars
★ 978
Forks
120

01 前言 Front Matter

name
atlas-obscura
api_key
None (free)
license
MIT
summary
Hidden gems and unusual attractions near any destination.
category
destinations
description
Search Atlas Obscura for weird, wonderful, and hidden gem places near any destination. Find the interesting stuff, not boring plaques. Search by coordinates, get full details with descriptions and images.

02 资源文件 3

03 SKILL.md 正文

Atlas Obscura

Find genuinely interesting hidden gems near any destination via Atlas Obscura. Searches by coordinates, scores places for interestingness, and filters out mundane historical markers.

No API key needed. Uses the atlas-obscura-api npm scraper.

Prerequisites

Install dependencies (one time):

cd skills/atlas-obscura && npm install

City Coordinates Reference

Common cities for trip planning. Use these with the search commands.

City Lat Lng
New York 40.7128 -74.0060
London 51.5074 -0.1278
Paris 48.8566 2.3522
Tokyo 35.6762 139.6503
Bangkok 13.7563 100.5018
Rome 41.9028 12.4964
Barcelona 41.3874 2.1686
Istanbul 41.0082 28.9784
Mexico City 19.4326 -99.1332
Lisbon 38.7223 -9.1393
Seoul 37.5665 126.9780
Oslo 59.9139 10.7522
Copenhagen 55.6761 12.5683
Stockholm 59.3293 18.0686

Commands

All commands run from the repo root. Output is JSON. Image URLs are excluded by default to keep output lean. Add --images to any command when you need them (e.g. generating HTML pages).

Search Nearby (Filtered)

Finds places near coordinates, fetches full details, scores for interestingness, and filters out boring stuff. Slower (fetches each place) but gives you the good stuff.

node skills/atlas-obscura/ao.mjs search <lat> <lng>

Example:

node skills/atlas-obscura/ao.mjs search 35.6762 139.6503

Returns up to 20 places sorted by interest score. Each has full description, tags, and directions.

Timeout note: This makes ~20 HTTP requests (one per place). Allow 30-60 seconds.

Quick Search (Unfiltered)

Fast nearby search. Returns title, subtitle, coordinates, distance. No detail fetching or scoring.

node skills/atlas-obscura/ao.mjs quick <lat> <lng>

Search Unfiltered with Details

Same as filtered search but keeps everything, including boring plaques.

node skills/atlas-obscura/ao.mjs search <lat> <lng> --all

Full Place Details

Get complete information for a specific place by ID.

node skills/atlas-obscura/ao.mjs place <id>

Returns: title, subtitle, full description (multi-paragraph), directions, tags, nearby places, interest score.

Short Place Summary

Quick place lookup without the full scrape. One request.

node skills/atlas-obscura/ao.mjs short <id>

Including Images

Add --images to any command to include thumbnail and image URLs in the output. Useful when generating HTML pages or visual reports.

node skills/atlas-obscura/ao.mjs search <lat> <lng> --images
node skills/atlas-obscura/ao.mjs place <id> --images

Interest Scoring

Places are scored based on:

Bonus points for: Abandoned, Ruins, Ghost Towns, Underground, Caves, Natural Wonders, Unusual Collections, Street Art, Museums, Markets, Hot Springs, Waterfalls, Breweries, Gardens, Islands, Art, Sculpture, Murals. Also: rich descriptions, multiple images.

Penalties for: Plaques, Historical Markers, Monuments, War Memorials, Government Buildings. Also: places marked "gone" or hidden from maps.

Places scoring below 0 are filtered out in the default search.

Useful jq Filters

# Just titles and subtitles
... | jq '.[] | {title, subtitle, tags}'

# Top 5 by interest score
... | jq '[sort_by(-.interest_score) | .[0:5] | .[] | {title, subtitle, interest_score, url}]'

# Places with specific tags
... | jq '[.[] | select(.tags | any(. == "Underground" or . == "Caves"))]'

# Just URLs for browsing
... | jq -r '.[].url'

When to Use

Load this skill when:

  • Planning trips and want to find hidden gems near destinations
  • Looking for unique, weird, or wonderful places to visit
  • Need Atlas Obscura recommendations for specific coordinates
  • Adding interesting stops to an itinerary

Do not:

  • Use for booking (AO is discovery only)
  • Hammer the scraper excessively (it's scraping atlasobscura.com, be respectful)
  • Expect real-time availability (places can close, change hours, etc.)

04 同仓库更多 Skills

borski
borski/travel-hacking-toolkit

wikipedia-airports

Discover destinations served from any airport via Wikipedia. Sanity-check whether an airline flies a specific route, find regional service that fare tools miss, identify late-split-return airport options.

★ 978
borski
borski/travel-hacking-toolkit

wheretocredit

Mileage earning rates by airline and booking class via wheretocredit.com. Redeemable and qualifying miles across 50+ programs. Use when deciding where to credit a flight or comparing earning rates.

★ 978
borski
borski/travel-hacking-toolkit

vrbo

Search VRBO (Vrbo / Expedia Group) vacation rentals including entire homes, condos, and cabins via Patchright browser automation. VRBO sits behind Akamai Bot Manager so plain HTTP and standard Playwright get a 429 bot wall. Use for whole-home or group stays, multi-bedroom rentals, and Airbnb-vs-VRBO comparisons. Trigger phrases include search VRBO, Vrbo rentals, vacation rental, cabin rental, whole house, condo for the group.

★ 978
borski
borski/travel-hacking-toolkit

tripadvisor

TripAdvisor Content API for hotel ratings, restaurant search, attraction reviews, rankings, and nearby locations. Use when evaluating hotels or researching destinations. 5K calls/month.

★ 978
borski
borski/travel-hacking-toolkit

trip-planner

Full trip planning orchestration. Combines flight search, hotel search, and points optimization into one cost analysis. Use when the user says "plan a trip" or wants the complete picture for a destination.

★ 978
borski
borski/travel-hacking-toolkit

trip-log

Save flight searches, itineraries, and booked trips to the trips/logs/ directory for future reference. OPT-IN — use when the user asks to log a trip or look up past searches, or on every search only if the user has said they want automatic logging. Also use to update status when a trip is booked or completed.

★ 978