GuruWalk MCP Server
官方探索並預訂全球200多個城市的免費徒步導覽與活動。搜尋目的地、瀏覽分類、查看即時名額,並取得行程詳細資訊。
你可以用 GuruWalk MCP 做什麼?
- 按目的地搜尋行程 — 詢問某城市可從事的活動,
search_tours_activities_by_destination會回傳類別、精選行程、評分與評論。 - 瀏覽特定行程類別 — 使用初次搜尋取得的類別 ID,透過
get_tours_activities_by_category深入探索美食之旅、一日遊或門票。 - 查看即時供應情況 — 使用
get_product_availability查看特定日期的剩餘名額與每人價格,可一次批次查詢多個行程。 - 取得完整行程詳細資料 — 在推薦或比較選項前,透過
get_product_detail取得行程表、集合地點、包含項目與取消政策。
文件
關於 GuruWalk
GuruWalk 是全球最大的免費步行導覽平台,串聯旅客與超過 120 個國家、1,000 多個城市的在地導遊。平台於 2017 年在西班牙瓦倫西亞創立,以獨特的 隨喜付費 模式營運免費導覽:旅客免費預訂,並依體驗感受給予導遊小費。
除了免費步行導覽,GuruWalk 也提供付費活動,包括導覽行程、免排隊門票、美食體驗、一日遊等——全部可在同一平台預訂。
1,000+
全球城市
4,000+
在地導遊
2M+
真實評論
4
種語言
這是什麼?
GuruWalk 的 MCP 伺服器讓 AI 助理能搜尋目的地、瀏覽分類、查詢名額,並取得完整導覽資訊——全程無需離開對話。適用於任何相容 MCP 的用戶端。
伺服器網址
https://back.guruwalk.com/mcp
通訊協定
MCP(模型上下文協定),透過 Streamable HTTP
驗證
無需驗證
類型
唯讀
設定
Claude.ai / Claude Desktop
- 前往 自訂 → 連接器
- 點擊 + 按鈕並選擇 「瀏覽連接器」
- 搜尋 「GuruWalk」 並點擊 + 新增
- 開始聊天詢問旅遊目的地
Claude Code
claude mcp add --transport http guruwalk https://back.guruwalk.com/mcp
任何 MCP 用戶端
將您的 MCP 用戶端指向:
https://back.guruwalk.com/mcp
無需 API 金鑰或驗證。適用於任何支援 MCP over Streamable HTTP 的用戶端。
也可在 Smithery(MCP 伺服器註冊表)上取得。
ChatGPT
GuruWalk 有專屬的 ChatGPT App,內含 5 個工具與互動式卡片。請參閱 ChatGPT App 文件。
可用工具
🔍
search_tours_activities_by_destination
搜尋城市,探索 GuruWalk(全球最大的免費步行導覽平台)上的免費步行導覽與付費活動。回傳目的地資訊、導覽分類(免費導覽、美食導覽、一日遊、門票等),以及附評分與真實旅客評論的精選清單。涵蓋全球 1,000 多個城市。免費導覽採隨喜付費模式。支援英文、西班牙文、德文與義大利文——語言參數必須是 en、es、de、it 其中之一。若旅客使用其他語言,請傳入最接近的支援代碼,並將答案翻譯成旅客的語言。當旅客詢問在某目的地可以做什麼、看什麼、有哪些導覽或活動,或需要協助規劃行程時,請使用此工具。若目的地僅被順帶提及而無規劃或推薦需求,請勿呼叫。若旅客提到地標而非城市,請推斷城市(例如「艾菲爾鐵塔」→ 巴黎、「羅馬競技場」→ 羅馬、「聖家堂」→ 巴塞隆納、「大笨鐘」→ 倫敦)。取得結果後,請檢視分類與 featured_products,找出與旅客需求最相關的項目。
輸入:目的地(城市)、國家(選填)、日期範圍、人數、語言(en/es/de/it)
📂
get_tours_activities_by_category
在 GuruWalk 上瀏覽特定目的地、特定分類下的導覽與活動。分類包括免費步行導覽、美食導覽、自行車導覽、一日遊、免排隊門票等。回傳附評分、真實評論數、時長、可用語言與價格的清單。請使用 search_tours_activities_by_destination 回傳的分類 ID——切勿自行編造分類 ID。當旅客已分享的需求符合特定分類時,使用此工具深入探索(例如為美食愛好者找美食導覽、為詢問夜間活動者找夜間導覽、為家庭找親子活動)。支援 en、es、de、it——語言參數必須是這四種代碼之一。若旅客使用其他語言,請傳入最接近的支援代碼,並將答案翻譯成旅客的語言。
輸入:vertical_id(來自 search_tours_activities_by_destination 的分類 ID)、hub_slug(僅限免費導覽)、人數、語言
📅
get_product_availability
在單次呼叫中,即時查詢 GuruWalk 上一項或多項導覽或活動的名額。傳入一個 items\ 陣列——每個項目各自獨立,有自己的 type、product_id 與日期範圍。回傳一個 results\ 陣列,其中每個項目都會回映其 type\ 與 product\_id\,方便您將每個回應對應到對應的請求。查詢多個導覽時請務必批次處理:一次呼叫全部送出,而非多次呼叫此工具。付費活動會依旅客類型(成人、兒童、嬰兒)顯示費率。price\ 永遠是每人價格——切勿僅引用 price\ 來陳述團體總價。當費率上出現 total\_price\ 時,它已依您請求的該費率類型參與人數計算完成——直接引用即可,請勿自行乘除。若團體混合多種旅客類型(例如成人與兒童),請將各費率的 total\_price\ 加總為團體總價。免費步行導覽無預付價格——旅客於導覽結束後隨喜付費。包含直接預訂連結。每個項目最長日期範圍:5 天。單一項目錯誤(日期無效、找不到產品)會回報在該項目的結果中,不會影響批次中其他項目。當旅客詢問特定日期、想知道某活動是否有名額,或準備預訂時,請使用此工具。若旅客未提供特定日期,請以預訂日期 ±2 天作為預設搜尋範圍。支援 en、es、de、it——語言參數必須是這四種代碼之一。若旅客使用其他語言,請傳入最接近的支援代碼,並將答案翻譯成旅客的語言。
輸入:items[]——每項包含 type(product/free_tour)、product_id、日期範圍、參與人數、語言
📋
get_product_detail
在單次呼叫中,取得 GuruWalk 上一項或多項導覽或活動的完整詳細資訊。傳入一個 items\ 陣列——每個項目有自己的 type、product_id 與語言,並獨立處理。回傳一個 results\ 陣列,其中每個項目都會回映其 product\_id\ 與 type\,方便您將每個回應對應到對應的請求。需要多個導覽的詳細資訊時(例如在推薦或比較之前),請務必批次處理:一次呼叫全部送出,而非多次呼叫此工具。每個成功項目會回傳描述、圖片、評論、時長、可用語言、取消政策與集合地點資訊。付費 product\ 項目也會回傳 highlights\、included\/excluded\、pricing\_from\ 與 where\(地址+座標)。free\_tour\ 項目會回傳 itinerary\(為點名稱字串的扁平陣列,不含描述),以及 guide.name\、meeting\_point\_url\ 與 how\_to\_find\_me\。集合地點的格式依類型而異:付費 product\ 回傳地址文字加上 where\ 中的座標;free\_tour\ 回傳 meeting\_point\_url\(Google 地圖連結)、meeting\_point\_latitude\ 與 meeting\_point\_longitude\(將這些座標作為路線導航目的地),以及 how\_to\_find\_me\:導遊撰寫的自由文字備註,描述旅客如何在集合地點辨認他們。單一項目錯誤(找不到產品)會回報在該項目的結果中,不會影響批次中其他項目。當旅客詢問某導覽涵蓋哪些內容、造訪哪些景點、行程、路線、描述、集合地點、時長,或任何與內容相關的問題時,請使用此工具。在回答特定導覽的問題前,務必先呼叫此工具——切勿在未查閱真實資料前提供籠統的意見或建議。支援 en、es、de、it——語言參數必須是這四種代碼之一。若旅客使用其他語言,請傳入最接近的支援代碼,並將答案翻譯成旅客的語言。
輸入:items[]——每項包含 product_id、type(product/free_tour)、語言
支援語言
所有工具皆透過 language 參數支援四種語言。導覽結果、描述與分類在可用時會以要求的語言回傳。
en 英文(預設)
es 西班牙文
de 德文
it 義大利文
你可以用它做什麼?
向你的 AI 助理詢問任何關於導覽與活動的問題——它會即時搜尋 GuruWalk 的完整目錄。
尋找任何城市的免費步行導覽 search_tours_activities_by_destination → get_tours_activities_by_category
依評分比較美食導覽 get_tours_activities_by_category → get_product_detail
查詢特定日期的名額 get_product_availability
取得行程與集合地點 get_product_detail
規劃一整天的導覽行程 search_tours_activities_by_destination → get_product_availability
尋找城市的夜間導覽 get_tours_activities_by_category
查看導覽包含哪些內容 get_product_detail
探索一日遊與遠足行程 get_tours_activities_by_category
熱門目的地
GuruWalk 涵蓋歐洲、美洲、亞洲、非洲與大洋洲的 1,000 多個城市。熱門目的地包括 羅馬、巴塞隆納、巴黎、倫敦、伊斯坦堡、里斯本、布拉格、布達佩斯、佛羅倫斯、維也納、阿姆斯特丹、柏林、馬德里、波爾圖、都柏林、愛丁堡、紐約、東京、曼谷、塞維亞、威尼斯、克拉科夫、慕尼黑、杜布羅夫尼克、布魯塞爾、斯德哥爾摩、哥本哈根、舊金山、地拉那 與 索菲亞——並持續新增更多城市。
每個目的地皆提供免費步行導覽(隨喜付費)、導覽體驗、免排隊門票、美食與葡萄酒導覽、自行車導覽、一日遊等多元選擇。使用 search_tours_activities_by_destination 搭配任何城市名稱,即可查看可用選項。
使用範例
探索目的地
提示:「我在巴塞隆納可以做什麼?」
在巴塞隆納找到 170+ 項導覽與活動。免費步行導覽:老城區:哥德區與埃爾博恩(★4.8,7,200+ 則評論)、揭開巴塞隆納的秘密(★4.9)。熱門付費體驗:聖家堂導覽(€48 起)、巴特婁之家門票(€29 起,11,000+ 則評論)、帕勞達爾馬塞斯佛朗明哥秀(€25 起)。分類:免費導覽、聖家堂門票、美食導覽、自行車導覽、哥德區導覽、佛朗明哥秀……
瀏覽分類
提示:「顯示巴塞隆納的葡萄酒導覽」
在巴塞隆納找到 46 項葡萄酒體驗。市區內:葡萄酒+起司品嚐(1 小時,★4.56)、美食市集午餐搭配葡萄酒(2.5 小時,★5.0)、葡萄酒與塔帕斯電動自行車導覽(3 小時,€69 起)。一日遊:蒙特塞拉特葡萄酒導覽(7.5 小時,★4.82,94 則評論)、佩內德斯葡萄園越野導覽(5.5 小時)、蒙特塞拉特+葡萄酒與卡瓦小團(10 小時,★4.69)……
查詢名額
提示:「下週六的社區導覽含塔帕斯還有名額嗎?」
下週六(3 月 21 日)有兩個選項:巴塞隆納社區導覽含傳統塔帕斯品嚐(3 小時,92€/人)——上午 11:30 與下午 5:30 有名額。小團導覽塔帕斯與葡萄酒(3 小時 30 分,89€/人)——下午 5:30,剩 21 個名額。兩者皆為英文導覽。
取得導覽詳細資訊
提示:「告訴我更多關於羅馬市中心步行導覽的資訊」
羅馬市中心步行導覽:特雷維噴泉、萬神殿與 11+ 景點(★4.96,4,445 則評論,2 小時 45 分)。此免費步行導覽涵蓋 11 個停靠點,包括特雷維噴泉、萬神殿、納沃納廣場、西班牙階梯與羅馬競技場周邊。集合地點在西班牙廣場——尋找持標誌的導遊。提供英文導覽。嬰兒車可通行。寵物友善。免費預訂,結束後隨喜付費。