用途:把 RoadsideAmerica.com 的美国和加拿大奇特路边景点目录变成面向智能体、可用管道的 CLI 工具,无官方 API。适合公路旅行规划、查找附近古怪景点、按州浏览、查看景点完整介绍,以及按“最大/最小/最高/怪食物”等主题筛选。
主要能力:near 按地点或坐标查找附近景点;state 按州浏览;show 返回单个景点的名称、地址、介绍及来源 URL;category 按最大/最小/最高/怪食物等分类筛选本地缓存;stats 汇总本地缓存按州和分类的数量;random 随机推荐,可按州或分类约束;trip 为多个城市或坐标一次性收集沿途景点并去重;compare 比较两个州的景点数量;raw 提供原始 HTML 直通。
使用方式:先安装 CLI,npx -y @mvanhorn/printing-press-library install roadside-america --cli-only,或离线时用 go install github.com/mvanhorn/printing-press-library/library/travel/roadside-america/cmd/roadside-america-pp-cli@latest。验证 roadside-america-pp-cli --version,并确保安装目录在 PATH 中。命令加 --agent 展开为 --json --compact --no-input --no-color --yes。示例:roadside-america-pp-cli near 30.27,-97.74 --radius 25 --agent --select name,city,distance,source_url;roadside-america-pp-cli trip "Austin, TX" "Waco, TX" --radius 15 --json。支持 --deliver file:<path> 或 webhook:<url>、profile 保存常用参数、feedback 本地记录使用反馈。
限制:无需认证;只读,不可用于预订、票务、营业时间或实时可用性。地址不作为导航权威,出行前需核实。仅覆盖美国和加拿大。数据为社区来源、非实时,分类依赖本地缓存,需先用 near 或 state 填充缓存。不适合主流旅游、餐厅点评或酒店查询。