wander-agent

="center"> # 🌍 漫游智能体 **一款拥有 66 种工具的旅行规划 AI，无需 API 密钥。** 向你的 AI 询问任何有关旅行的问题 — 机票、酒店、签证、天气、安全、当地美食、行李清单 — 并获得真实的数据反馈，而不是虚构的答案。 [](https://github.com/Viraishra1/wander-agent/actions/workflows/ci.yml) [](https://www.python.org/) [](https://modelcontextprotocol.io/) [](https://github.com/VirajMishra1/wander-agent/blob/main/LICENSE) [](https://glama.ai/mcp/servers/VirajMishra1/wander-agent观看启动演示](https://x.com/virajm1shra/status/2059930318359109965) </div> --- ## 这是什么？ 漫游智能体是一款 **AI 助手的工具插件**（Claude、Cursor、Windsurf 等），为 AI 提供真实的旅行数据。 没有这个插件，询问 AI “从纽约到东京在最便宜的机票答案往往是虚。有了这个插件，AI 会调用真实的数据源 — Google Flights、Open-Meteo、美国国务院旅行建议、OpenStreetMap — 为你提供实际的价格、天气预报和实时的签证要求。 **你与 AI 的交互方式保持不变 会处理其他事情> *"为我 10 天的巴厘岛之旅，2 人从迪拜出发，出行，预算 美元"* > → 真实的机票、酒店、签证要求、天气预报、当地餐厅、行李清单、日程安排 — 所有信息都在一个回答中。 --- ## 功能 <details> <summary><strong>✈️ 机票</strong></summary> - 搜索实时航班（Google Flights 和 Kiwi.com 并行） - 查找隐藏城市票价 — 例如，购买纽约到墨西哥城的航班，经休斯顿中转，在休斯顿以 40% 的折扣下车 - **分段购票搜索** — 通过枢纽预订两张单独的票；在线旅行社（OTA）合同禁止显示此选项 - **每月价格扫描** — 检查未来一年的每个月份，返回最便宜的飞行月份 - **票价日历** — 给定月份内最便宜的一天，星期几分析 - 扫描错误票价和错误定价的航班 - 查找您可以从任何地方飞到的最便宜的目的地 - 查找不同城市出发的朋友的 cheapest 会面地点 - 自动检查附近的机场（JFK 还会检查 EWR、LGA；DXB 还会检查 SHJ、AUH） </details> <summary><strong>🏨 酒店</strong></summary> - 搜索酒店，链接到 BookingAirbnb、Expadvisor 等 平台 - 在日期范围内优化最便宜的航班 + 酒店组合 </details> <details> <summary><strong>📋 签证和入境</strong></summary> - 检查是否需要签证、电子签证、ETA 或无需签证 - 查看每个国家/地区您可以无需全签证入境 - **护照实力排名** — Henley 指数 2024 排名，无签证覆盖百分比，区域分布 - **双护照比较** — 查看每个护照解锁的特定目的地 - **中转签证检查** — 您是否需要签证才能中转？200+ 个护照 × 中转规则 - 官方政府申请链接 </details> <details> <summary><strong>🌤️ 天气</strong></summary> - 任意地点的 16 天实时预报 - 根据 5 年气候数据，推荐最佳游览时间 - 时差计算器，科学恢复时间表 </details> <summary><strong>⚠️ 安全</strong></summary> - 实时美国国务院旅行建议级别（1 级 = 安全，4 级 = 请勿旅行） - 列出达到或超过给定风险级别的每个国家/地区 - 最近的旅行新闻：罢工、机场关闭、入境禁令议 </<details> <summary💰 strong></summary> - 220 个城市的每日算（预算档/豪华实时货币转换 - 结合航班、酒店和每日花费计算总行程费用 </details> <details> <summary><strong>🗺️ 规划</strong></summary> - 每天的行程安排，包括天气和活动 - 按成本 + 天气 + 安全 + 活动对目的地进行排名和评分 - 比较 - 观赏目的地 NOAA KP 指数预报 **开合旅行** — 飞往罗马，乘火车到巴黎飞回。自动合成。 </details> <details> <summary><strong>🍜 食物和夜生活</strong></summary> - 任意地点的餐厅、酒吧、酒馆和咖啡馆（OpenStreetMap） - 料理筛选、价格水平、营业时间、距离 - 预订链接：Google Maps、Zomato、TripAdvisor、Yelp、OpenTable、Resy、Untappd </details> <details> <summary><strong>🎒 出行指南</strong></summary> - 根据天气、活动和行程长度量身定制行李清单 - 17 种语言的短语手册，附发音指南 - 10 个主要枢纽机场的停留指南（DXB、SIN、IST、DOH、NRT、CDG、HKGN、AMS、） - 健康疫苗、水安全、食品安全、行前时间表 - 公共汽车、渡轮选项，附直接预订链接 -地点的观景点、海滩、徒步小径、共享办公空间 **本地 SIM 卡 — 25+ 个国家：最佳预付费 SIM 卡与 eSIM，费用、购买地点、绑定策略 </details> <details> <summary><strong>🧠 记忆和决策</strong></summary> - 保存您的出发机场、护照、货币和兴趣爱好 — 无需再次询问 - 记录您的旅行历史 - **已保存的行程** — 持久性行程，附有 8 项预订清单，在会话间保持 - **票价监控** — 设置路线的目标价格，按需重新定价，当价格下降时收到购买信号 - **价值排名** — 根据价格 * 和中转、时长、退款能力、行李和麻烦（标记隐藏城市/分段购票风险）为选项评分 0-100 </details> <details> <summary><strong>💳 信用卡积分和里程</strong> - **积分估值** — 此奖励预订是否划算？根据 20+ 个计划基准的积分每分价值计算器 - **转账合作伙伴** — 您可以将 Chase UR / Amex MR / Citi TYP / Capital Bilt 积分转账到哪些航空公司和酒店？附比率和转账时间 - **积分** — 您应该使用积分还是现金支付？考虑积分价值、和现金返还 - **赚取计算器** — 您的 Amex Gold 信用卡在 500 美元的晚餐中能赚取多少积分？9 张卡片模拟，附有奖励类别 - **最佳奖励** — 精选高价值兑换：ANA 头等舱 120k 积分（16.7cpp），Hyatt 全包 25k 积分（2.4cpp），土耳其航空商务舱 45k 积分（8.9cpp） - **计划比较** — 哪个积分计划为特定预订提供最佳价值？ - **信用卡组合** — 将您的信用卡保存到个人资料中，积分工具会自动使用它们 </details> --- ## 安装（5 分钟） ### 步骤 1 — 安装 Python 您需要 Python 3.10 或更新版本。检查您是否已安装： ```bash python3 --version ``` 如果没有？从 [python.org](https://www.python.org/downloads/) 下载。 --- ### 步骤 2 — 安装漫游智能体 从 PyPI（推荐）： ```bash install wander-agent ``` 或使用 [uv](https://docs.astral.sh/uv/) — 无需安装，直接运行：bash uvx wander-agent ``` 或从： ```git clone https://github.com/Virajra1/wander cd wander-agent install -e . ``` 验证是否安装成功：bash wander-agent --help ``` --- ### 步骤 3 — 连接到您的 AI 使用的应用程序： <details> <summary><strongaude 桌面版</strong></summary> 文件到文本编辑器： - **mac `~/Library/ApplicationClaude/claude_desktop_config.json` - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json` 添加以下内容： ```json { "mcpServers": { "wander-agent": { "command": "wander-agent" } } } ``` 保存文件，然后 **退出打开 Claude 桌面版**。 如果出现 `wander-agent` 未找到的错误，请先找到完整路径： ```bash which wander-agent ``` 然后在配置中使用该路径： ```json { "mcpServers": { "wander-agent": { "command": "/usr/local/bin/wander-agent" } } } ``` </details> <details> <summary><strong>Claude 代码（终端）</strong></summary> ```bash claude mcp add wander-agent wander-agent ``` 确认已注册： ```bash claude mcp list ``` </details> <details> <summary><strong>Cursor</strong></summary> 在您的主目录中创建或编辑 `.cursor/mcp.json````json "mcpServers": { "wander-agent": { "command": "wander-agent" } } } ``` 重启 Cursor。 </details> <details> <summary><strong>Windsurf</strong></summary> 编辑 `~/.codeium/windsurf/mcp_config.json`: ```json { "mcpServers": { wander-agent": { "command": "wander-agent" } } } ``` 重启 Windsurf。 </details> <details> <summary><strong>Cline（VS Code 扩展）</strong></summary> 打开 VS Code 设置，搜索“Cline MCP”，编辑 `cline_mcp_settings.json`: ```json { "mcpServers": { "wander-agent": { "commandwander-agent" } } } ``` </<details> <summary><strong>Continuestrong></summary> 在项目或主目录中编辑 `.continuerc.json`: ```json { mcpServers": { "namewander-agent", command": "wander } ] } ``` </details> <summary><Zed</strong></summary> 编辑 `~/.config/zed/settings.json`: ```json { "context_servers": { "wander-agent": { "command": { "path": "wander-agent", "args": [] } } } } ``` </details> --- ## 可选：更好的数据的 API 密钥 所有功能无需任何 API 密钥都可使用。以下内容可提供更丰富的数据： | 变量 | 解锁内容 | 免费获取 | |----------|----------------|----------------| | `FOURSQUARE_API_KEY` | 餐厅/酒吧的真实评分和价格水平 | [foursquare.com/developers](https://foursquare.com/developers/signup) | | `TICKETMASTER_API_KEY` |列表（音乐会、体育、演出） | [developer.ticketmaster.com](https://developer.ticketmaster.com) | 在启动 AI 之前设置它们： ```bash export FOURSQUARE_API_KEY=your_key_here export TICKETMASTER_API_KEY=your_key_here ``` 或将它们添加到 shell 配置文件（`~/.rc`、`~/.bashrc`）中，使其永久生效## 所有 工具 ### ✈️ 机票 工具 | 功能------|-------------| |_flights` | 跨 Google Flights 和.com 的实时航班搜索。返回价格、时长、停靠站和链接。 | find_skiplagged_fares` | 隐藏城市票价 — 购买联程航班转城市下车。通常便宜 40–60%。仅限随身行李。 | | `find_split_ticket` | 通过枢纽预订两张单独的票，而不是一张直通票。OTA 合同禁止显示此选项。许多航为 20–60%。包含完整的风险披露。 | | `find_cheapest_month`采样每个月的第一个星期二（统计上的预订日）扫描未来 12。返回按价格排名的所有月份，并附预订链接。 | | `fare_calendar`完整的月份 — 最多 15 个采样日，星期几分析，价格层级，最佳/最差周。在给定月份内找到最便宜的飞行日期。 | | `find_mistake_fares` | 扫描 Secret Flying 和 The Flight Deal RSS 以获取价和闪购。 | | `cheap_anywhere | 来自 114的全球的目的地。 | | `find_destinations` | 在总航班 + 酒店）内找到可达的目的地。 | |_origin_meet | 来自不同多个朋友最便宜的会面城市。 | | `verify_flight_route` | 确认两机场直飞或联程航班| `find_aurora_destinations` |光观赏目的地，附 NOAA KP预报和航班价格。 | ### 🏨 酒店 | 工具 | 功能 | |------|| `search_hotels` | 酒店， Booking.com、Airbnb、ExpTripadvisor 等 6 个平台。 | optimize_budget` | 在灵活的日期范围内便宜的航班 + 酒店组合。 | ### 📋 签证和入境 | 工具 | 功能 | |------|-------------| | `check_visa_requirement` | 护照 + 目的地对的签证类别。返回免签证、ETA、电子签证、落地签证或需要签证 — 附官方申请链接。 | | `visa_free_destinations` | 给定护照可以无需全签证入境的每个国家/地区。 | | `get_passport_power` | Henley 指数 2024 排名，无签证覆盖百分比，免签证旅行百分比，区域分布。传递两个护照以进行对比：每个护照解锁哪些目的地，而另一个护照则不解锁。 | | `check_transit_visa` | 您在中转机场是否需要签证？涵盖 200+ 个护照 × 中转国组合。检查、JFK、DXB、SIN、IST、DOH、NRT、ICN、YYZ、SYD 和 30+ 个其他机场。 | ### 🌤️ 天气 | 工具 | 功能 | |------|-------------| | `get_weather` | 任意坐标的 16 天实时天气预报。对于预报窗口之外的日期，退回到 5 年的历史数据。 | | `best_month_to_visit` | 根据历史气候数据，为某个地点排名 12 个月。 | ### ⚠️ 安全和新闻 | 工具 | 功能 | |------|-------------| | `get_travel_advisory` | 美国国务院实时旅行建议级别（1-4 级）和来自实时 RSS 源。 | | `list_advisories_by_level` | 当前处于或高于给定建议级别的所有国家/地区。 | | `get_travel_news` | 扫描谷歌新闻获取最近的干扰：罢工、机场关闭、入境禁令、抗议活动。 | ### 💰 费用和货币 | 工具 | 功能 | |------|-------------| | `get_cost_of_living` | 220 个城市的每日预算估算，涵盖预算、中档和豪华三个层级。 | | `convert_currency` | 通过欧洲中央银行汇率进行实时货币兑换。 | | `get_exchange_rates` | 从基准货币获取多种货币的汇率。 | ### 🗺️ 规划和评分 | 工具 | 功能 | |------|-------------| | `plan_trip_package` | 主要的协调器。调用 8+ 个工具并行返回完整行航班、酒店、签证、、活动、地面交通、算和预订清单。 | plan_itinerary` | 每天的行程安排，附有天气预报和建议活动。 | | `find_open_j | 计划飞入/陆行/飞出的行程：抵达 A 市，乘火车或公共汽车，飞回 B 市。组合航班 + 地面。显示总费用与往 A 市的比较。名称或 IATA 代码。 | | `score_destinations` | 按成本、天气、安全性和活动等加权组合对目的地进行排名。 | | `estinations` | 相同日期下2-5 个目的地进行比较。 | ### 🍜 食品生活 | 功能 | |------|-------------| |_restaurants_bars` |Map 提供的指定地点的餐厅、酒吧、酒馆和咖啡馆、价格水平、营业距离和链接到 Google Maps、Zomato、TripAdvisor、YelpResy 和 Unt。 | ### 🌐 智能旅行工具 | 工具 | 功能 | || | `score_nomad_cities` | 根据 6对远程工作城市进行排名：成本、安全、网速、天气、性和生活方式。可配置权重。 | | `calculate_flight_carbon` | 使用 ICAO/DEFRA 2024 因子和辐射强迫FI ×1.9）计算的 CO2e 足迹。每乘客和总排放量，Gold Standard 抵消成本，以及短途航班/汽车比较。 | ### 🎒 出行指南 | 工具 | 功能 | |------|-------------| | `generate_packing_list` | 根据目的地天气、活动和行程长度量身定制行李清单。 | | `find_places` | OpenStreetMap 提供的景点、沙滩、徒步小径、共享办公空间、瀑布、市场等。 | | `calculate_jet_lag` | 科学计算时差严重程度，附带恢复计划：出发前调整、褪黑素时间、光线暴露策略。 | | `get_language_phrasebook` | 17 种语言的短语手册，附带本地文字、罗马拼音和音频提示。 | | `get_stopover_guide` | 10 个主要枢纽机场中途停留指南。包括中转签证检查、机场内活动和城市游览选项。 | | `check_travel_health` | 所需和推荐的疫苗、水安全、食品安全、蚊子风险、海拔风险和行前准备时间表。基于 CDC 和 WHO 2024-2025 数据。 | | `search_ground_transport` | 公共汽车、火车和渡轮选项，附带预订链接。区域感知：美国的 Amtrak 和 Greyhound，欧洲的 Trainline 和 BlaBlaCar，印度的 IRCTC，东南亚的 12Go。 | | `get_local_sim_guide` | 25+ 个国家最佳预付费 SIM 卡和 eSIM。返回运营商、费用、数据限额、购买地点、绑定策略和基于持续时间的建议（≤3 天 → eSIM；更长时间 → 本地 SIM 卡）。对于未列出的国家/地区，备用 Airalo/Holafly。 | ### 🏛️ 景点和信息 | 工具 | 功能 | |------|-------------| | `search_activities` | 来自 Wikidata 的指定地点的景点。按类别筛选：博物馆、公园、建筑、夜生活、食物、历史、自然等。 | | `get_local_events` | 来自 Eventbrite 的现场活动：音乐会、体育比赛、节日。 | | `get_destination_info` | 国家基本信息：货币、官方语言、时区、拨号代码、驾驶方向。 | | `geocode` | 将地名转换为坐标。 | | `verify_place` | 确认地点实际存在（防止 AI 幻觉）。 | ### 🧠 Traveler Profile | 工具 | 功能 | |------|-------------| | `get_traveler_profile` | 加载您的保存的个人资料：首页机场、护照、货币、兴趣和旅行历史。 | | `onboard_traveler` | 一次性设置。保存您的偏好设置，以便 AI 在未来的每个会话中自动使用。 | | `update_traveler_profile` | 更新任何字段，管理投资组合中的信用卡，或记录已完成的旅行。 | | `get_trip_history` | 您的记录的旅行历史。 | ### 🧳 Saved Trips (跨会话内存) 持久化到 `~/.wander_agent/trips.json`。一个旅行携带一个 8 项的预订检查清单（航班、酒店、签证、保险、地面交通、咨询、行李打包、通知银行）。 | 工具 | 功能 | |------|-------------| | `save_trip` | 保存您正在计划的旅行。返回 `trip_id` 和一个新的预订检查清单。 | | `list_my_trips` | 列出已保存的旅行，并附有检查清单进度。按状态（规划/预订/已完成/已取消）筛选。 | | `get_trip_status` | 完整状态 + 指定行程的检查清单进度， 按 ID 或目的地。 | | `update_trip` | 更改状态/日期，勾选检查清单项目，或将航班/酒店选项添加到行程中。 | | `delete_trip` | 删除已保存的旅行。 | ### 🔔 Fare Watching 持久化到 `~/.wander_agent/fare_watches.json`。记录每个观察路线的基准价格和价格历史。 | 工具 | 功能 | |------|-------------| | `watch_fare` | 开始观察指定路线，附带可选的目标价格。创建时捕获基准价格。 | | `list_fare_watches` | 列出观察记录，包含基准价格/最新价格/最低价格和状态。 | | `check_fare_watches` | 重新定价观察中的路线。返回购买信号警报：`target_hit`、`price_drop`、`price_rise`、`no_change`。 | | `stop_fare_watch` | 暂停或删除观察记录。 | ### ⚖️ Value Ranking | 工具 | 功能 | |------|-------------| | `rank_trip_options` | 对航班/旅行选项进行评分，范围从 0 到 100，基于价格和中转站、时长、退款可能性、行李和麻烦程度。预设：最便宜/最快/最方便/最灵活/平衡。标记隐藏城市、分割票和自我中转风险，以免最便宜的票价被盲目选择为赢家。 | ### 💳 Credit Card Points & Miles 涵盖 20 个忠诚度计划（Chase UR、Amex MR、Citi TYP、Capital One、Bilt、11 家航空公司、4 家酒店连锁）的静态数据集，9 张热门信用卡的奖励类别和 10 个精选的优质奖励。信用卡投资组合保存到 `~/.wander_agent/profile.json`。 | 工具 | 功能 | |------|-------------| | `estimate_points_value` | 这个奖励预订是否值得？计算每积分的价值，并与该计划的基准估值进行比较。返回优秀/良好/一般/差劲的结论。 | | `find_transfer_partners` | 显示指定银行计划的航空和酒店合作伙伴（例如 Chase UR → United、Hyatt、BA 等），附带转账比率和时间。按合作伙伴价值排序。 | | `calculate_points_or_cash` | 您应该使用积分还是现金支付此预订？考虑每积分价值、积分机会成本和用特定信用卡支付现金后可以赚取的积分。 | | `estimate_points_earning` | 在指定信用卡上，购买可以赚取多少积分。涵盖 9 张信用卡的奖励类别乘数（例如 3 倍餐饮、5 倍旅行门户、4 倍超市等）。 | | `find_sweet_spot_awards` | 精选高价值兑换：ANA 头等舱（16.7cpp）、新加坡套房（16.3cpp）、土耳其商务舱（8.9cpp）、Hyatt 全包（2.4cpp）等。按您的计划、舱位、预算或路线筛选。 | | `compare_points_programs` | 哪个积分计划为特定预订提供最佳价值？比较估算的积分成本、门户 vs 转账价值、最佳合作伙伴和匹配的优质奖励。自动使用您的个人资料信用卡。 | --- ## 工具排名：实用性 × 特殊因子 根据实用影响和独特性进行排名 — 其他 OTA、聊天机器人和其他旅行工具无法实现的功能。 | 排名 | 工具 | 原因 | |------|------|---------------| | 🥇 1 | `find_split_ticket` | OTA **合同禁止** 显示此内容。通过中转站预订两张票而不是直通票。在许多长途航线上可节省 20-60%。旅行行业的公开秘密。 | | 2 | `find_skiplagged_fares` | 隐藏城市票务。以带有中转站的城市 B 的航班预订机票 — 在城市 A 下车，从未登上最后一程。比正常票价便宜 40-60%。根据航空公司条款和条件非法，但不违反任何法律。仅限随身行李。 | | 3 | `plan_trip_package` | 一条消息 → 完整行程。并行触发 8+ 个工具：航班、酒店、签证、天气、安全、活动、地面交通、成本估算。展示该代理可以做什么的最佳演示。 | | 4 | `find_cheapest_month` | 扫描 12 个月，采样每个月的第一个星期二（统计上最便宜的预订日）。返回按价格排名的月份，并附有季节标签。提前 1-2 个月预订可节省数百美元。 | | 5 | `check_transit_visa` | 没人想检查但为时已晚的签证。您是否需要在 Heathrow 转机？在法兰克福转机？200+ 个护照 × 中转站组合。防止旅行终止。 | | 6 | `multi_origin_meetup` | 三个朋友，三个不同的城市。哪个城市是他们最便宜的会面地点？没有 OTA 具备此工具。 | | 7 | `find_open_jaw` | 飞往罗马，乘火车到巴黎，从巴黎飞回家。没有 OTA 允许您组合此内容。自动为两个航班和陆路段定价，并与简单的往返罗马进行比较。 | | 8 | `get_passport_power` | Henley 2024 排名，免签证百分比，区域明细。双重护照模式：精确的集合差异，显示每个护照解锁的国家/地区。“使用您的印度护照前往泰国，使用您的美国护照前往巴西。” | | 9 | `score_nomad_cities` | 数字游牧者的 6 维评分：成本、安全、网速、天气、签证便利性和生活方式。可配置权重。“比较 Bali、Lisbon 和 Tbilisi 适合居住 3 个月的评分，将互联网权重设为成本的 3 倍。” | | 10 | `find_mistake_fares` | 来自专用交易聚合器的错误票价和航空公司定价错误。被动发现 — “现在 JFK 出发有哪些超便宜的票？” | ## 数据源 | 源 | 提供内容 | 需要密钥？ | |--------|----------------|-------------| | Google Flights（爬虫） | 机票价格和航空公司名称 | 否 | | Kiwi.com | 可预订的实时机票价格 | 否 | | Open-Meteo | 天气预报和 5 年历史气候数据 | 否 | | Frankfurter（ECB） | 汇率 | 否 | | Wikidata SPARQL | 景点和兴趣点 | 否 | | OpenStreetMap Overpass | 餐厅、酒吧、海滩、观景点、徒步旅行 | 否 | | 美国国务院 RSS | 旅行建议 | 否 | | Open-Meteo 地理编码 | 地名坐标 | 否 | | RESTCountries | 国家元数据 | 否 | | Secret Flying / The Flight Deal | 错误票价和优惠 | 否 | | NOAA 太空天气 | 极光 KP 指数预报 | 否 | | Google News RSS | 旅行中断新闻 | 否 | | Skiplagged | 隐藏城市票价 | 否（脆弱的爬虫） | | Rome2Rio / Omio | 地面交通选项 | 否（备用链接） | | Eventbrite | 现场活动 | 否 | | Foursquare Places v3 | 餐厅/酒吧评分和价格水平 | 可选（免费层） | | Ticketmaster Discovery | 现场活动列表 | 可选（免费层） | | 静态数据集 | 签证要求、生活成本、机场数据、过境签证规则、SIM 卡数据、Henley 排名、积分/里程估值 | N/A | --- ## 信任程度 大多数结果都带有 `data_meta` 块，以便 AI 可以在您预订前告诉您该数字的可靠性： ```json "data_meta": { "confidence": "scraped_live", "trust_score": 80, "trust_label": "实时抓取", "meaning": "刚刚从 Google Flights 抓取。真实但可能瞬间变化。", "fetched_at": "2026-06-02T18:30:00+00:00", "source": "google_flights + kiwi.com" } ``` | 标签 | 信任程度 | 含义 | |-------|-------|---------------| | `deeplink` | 95 | 打开实时提供商页面 — 始终保持最新 | | `live_api` | 90 | 官方 API（ECB 汇率、NOAA） | | `live_rss` | 85 | 实时政府信息流（国务院建议） | | `live_forecast` | 85 | Open-Meteo 实时天气 | | `scraped_live` | 80 | 实时抓取 — 真实但可能变化 | | `curated_snapshot` | 55 | 精心策划的数据集 — 预订前请验证 | | `wikidata_fallback` | 50 | 来自 Wikidata | | `estimated` | 35 | 模型化数据 — 仅供粗略参考 | --- ## 公开限制 **机票价格：** Google Flights 爬虫如果 Google 更改页面结构可能会中断。Kiwi 价格是真实且可预订的。两者并行运行 — 如果一个失败，另一个仍会返回结果。 **分段票风险：** `find_split_ticket` 提供了真正的节省，但存在错过连接的风险。如果您的第一程航班延误，第二家航空公司不会等待，也不会为您重新预订机票。该工具始终返回完整的风险披露列表。购买涵盖分段票连接的旅行保险。 **酒店价格：** 每个酒店价格 API 都需要付费。本工具返回酒店名称和链接到 9 个预订网站，您可以在那里查看实时价格。不直接显示价格。 **签证数据：** 静态快照（更新于 2024 年）。政策可能会变化 — 在预订任何内容之前，请始终通过响应中的官方链接进行验证。不要仅凭此信息做出移民决定。 **过境签证数据：** 规则编码为静态数据集，涵盖 200+ 种组合。可能缺少特殊情况（具有双边豁免的国籍、最近的政策变化）。请始终与航空公司或目的地大使馆验证。 **护照权力数据：** Henley Index 2024 快照。排名每年都会变化。在做出基于国籍的决定之前，请与官方来源确认。 **SIM 卡数据：** 截至 2024 年第四季度的精选快照。价格和计划经常变化。视为指南；购买前请验证。 **活动：** 从 Eventbrite 抓取。对于 0-60 天范围内的活动覆盖最佳。未来更远的活动可能尚未列出。 **旅行建议：** 仅限美国国务院。更新时间在官方更改后 24-48 小时内，通过 RSS 获取。 **健康数据：** 来自 CDC Yellow Book 和 WHO 2024-2025 建议的精选快照。不能代替旅行医学诊所的建议。 **地面交通：** 使用 Rome2Rio 数据进行路线发现。实际价格和时间表必须在预订网站上确认 — 时间和费用会变化。 **积分/里程估值：** 基准每积分价值是编辑平均值（TPG、NerdWallet、OMAAT）。实际兑换价值取决于特定奖励可用性、转账奖金和动态定价。优质奖励假设有 saver 级别的可用性。信用卡奖励类别反映 2025 年第一季度的条款 — 发行商会定期更改这些条款。 **碳排放量计算：** ICAO/DEFRA 2024 排放因子，带有标准 RFI 乘数（×1.9）。实际排放量因飞机类型、载客率和航线而异。请将其用作估算，而不是会计数字。 --- ## 云部署（Docker） 包含的 `Dockerfile` 和 `railway.toml` 允许您在云中托管此服务器，以便您可以从任何设备连接，而不仅仅是安装它的计算机。 **您不需要此功能进行正常的本地使用。** 按照上面的设置描述进行本地安装和运行。 如果您想在 [Railway](https://railway.app) 上自行托管： ```bash # 推送到 GitHub，然后将存储库连接到 Railway # 如果使用可选 API 密钥，请在 Railway 仪表板中设置环境变量 ``` 服务器根据 `WANDER_TRANSPORT` 环境变量自动切换到 HTTP（标准输入输出）或 HTTP。 --- ## 开发 ```bash # 安装开发依赖 pip install -e ".[dev]" # 运行测试 python -m pytest tests/ -v ``` # 统计已注册工具 grep -c "@mcp.tool()" src/wander_agent/server.py ``` **添加工具:** 1. 在 `src/wander_agent/tools/` 目录下创建您的工具文件，例如 `your_tool.py`，并定义一个异步函数 2. 在 `src/wander_agent/server.py` 中导入该工具 3. 使用 `@mcp.tool()` 和异步包装函数进行封装 4. 重启您的 AI 客户端以加载新工具 **持续集成：** 每次推送和拉取请求到 `main` 分支时，都会运行测试套件，测试环境为 Python 3.10/3.11/3.12，并断言已注册工具数量。 **发布：** 发布 GitHub 版本会触发 PyPI 发布工作流（受信任的发布，无需令牌）。首先，请在 `pyproject.toml` 和 `server.json` 中更新版本号。 --- ## 许可证 MIT mcp-name: io.github.VirajMishra1/漫游代理