mcpField
A
atlas-obscura

atlas-obscura

github.com/borski其他78074 次安装2 天前更新
代码仓库

关于 atlas-obscura

Atlas Obscura 是旅行发现技能，可通过坐标查找 Atlas Obscura 网站上的特色地点。它会为结果评分和筛选，也支持快速搜索及查看地点详情。

主要功能

  1. 01按坐标搜索附近地点
  2. 02按趣味度为地点排序
  3. 03过滤普通历史标记
  4. 04获取介绍、路线和标签
  5. 05按需包含图片链接

适用场景

  1. 01查找目的地附近的特色景点
  2. 02为旅行行程添加隐秘景点
  3. 03查询特定地点的详细信息

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/borski/travel-hacking-toolkit --skill atlas-obscura

安装后在 Claude Code 中输入/atlas-obscura确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

ao.mjs
package-lock.json
package.json

详细介绍

Atlas Obscura

通过 Atlas Obscura 查找任意目的地附近真正有趣的隐秘好去处。按坐标搜索，为地点评定有趣程度，并过滤掉平平无奇的历史标记。

无需 API 密钥。使用 atlas-obscura-api npm 抓取工具。

先决条件

安装依赖（一次即可）：

cd skills/atlas-obscura && npm install

城市坐标参考

适合行程规划的常见城市。可在搜索命令中使用这些坐标。

城市纬度经度
纽约40.7128-74.0060
伦敦51.5074-0.1278
巴黎48.85662.3522
东京35.6762139.6503
曼谷13.7563100.5018
罗马41.902812.4964
巴塞罗那41.38742.1686
伊斯坦布尔41.008228.9784
墨西哥城19.4326-99.1332
里斯本38.7223-9.1393
首尔37.5665126.9780
奥斯陆59.913910.7522
哥本哈根55.676112.5683
斯德哥尔摩59.329318.0686

命令

所有命令均从仓库根目录运行。输出为 JSON。默认排除图片 URL，以精简输出。需要图片时（例如生成 HTML 页面），可为任意命令添加 --images。

搜索附近地点（已筛选）

查找坐标附近的地点，获取完整详情，评定有趣程度，并过滤掉乏味的地点。速度较慢（会获取每个地点的详情），但结果更精彩。

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

示例：

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

最多返回 20 个地点，按兴趣分数排序。每个地点均包含完整描述、标签和路线指引。

超时提示： 此操作会发出约 20 个 HTTP 请求（每个地点一个）。请预留 30–60 秒。

快速搜索（未筛选）

快速搜索附近地点。返回标题、副标题、坐标和距离。不获取详情，也不评定分数。

node skills/atlas-obscura/ao.mjs quick <lat> <lng>
搜索未筛选地点并获取详情

与已筛选搜索相同，但会保留所有地点，包括乏味的牌匾。

node skills/atlas-obscura/ao.mjs search <lat> <lng> --all
地点完整详情

通过 ID 获取特定地点的完整信息。

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

返回：标题、副标题、完整描述（多段）、路线指引、标签、附近地点和兴趣分数。

地点简要摘要

快速查询地点，无需完整抓取。仅需一个请求。

node skills/atlas-obscura/ao.mjs short <id>
包含图片

为任意命令添加 --images，即可在输出中包含缩略图和图片 URL。适用于生成 HTML 页面或视觉报告。

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

兴趣评分

地点评分依据如下：

加分项： 废弃场所、遗址、鬼城、地下场所、洞穴、自然奇观、非同寻常的收藏、街头艺术、博物馆、市场、温泉、瀑布、啤酒厂、花园、岛屿、艺术、雕塑、壁画。此外，描述详尽、图片较多也会加分。

扣分项： 牌匾、历史标记、纪念碑、战争纪念馆、政府建筑。此外，标记为“已消失”或从地图上隐藏的地点也会扣分。

默认搜索会过滤掉得分低于 0 的地点。

实用的 jq 筛选器

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

适用场景

在以下情况下加载此技能：

  • 规划旅行，并希望找到目的地附近的隐秘好去处
  • 寻找独特、奇特或令人惊叹的游览地点
  • 需要针对特定坐标的 Atlas Obscura 推荐
  • 为行程添加有趣的停留点

请勿：

  • 用于预订（AO 仅用于发现地点）
  • 过度频繁地调用抓取工具（它会抓取 atlasobscura.com，请适度使用）
  • 期待实时可用信息（地点可能会关闭、营业时间可能会变更等）

评论

支持 Markdown