Files
higress/plugins/wasm-go/mcp-servers/mcp-tourist-attraction-query/README_ZH.md
2025-04-16 14:48:53 +08:00

72 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 旅游景点查询
API认证需要的APP Code请在阿里云API市场申请: https://market.aliyun.com/apimarket/detail/cmapi022105
## 什么是云市场API MCP服务
阿里云云市场是生态伙伴的交易服务平台我们致力于为合作伙伴提供覆盖上云、商业化和售卖的全链路服务帮助客户高效获取、部署和管理优质生态产品。云市场的API服务涵盖以下几个类目应用开发、身份验证与金融、车辆交通与物流、企业服务、短信与运营商、AI应用与OCR、生活服务。
云市场API依托Higress提供MCP服务您只需在云市场完成订阅并获取AppCode通过Higress MCP Server进行配置即可无缝集成云市场API服务。
## 如何在使用云市场API MCP服务
1. 进入API详情页订阅该API。您可以优先使用免费试用。
2. 前往云市场用户控制台使用阿里云账号登陆后查看已订阅API服务的AppCode并配置到Higress MCP Server的配置中。注意在阿里云市场订阅API服务后您将获得AppCode。对于您订阅的所有API服务此AppCode是相同的您只需使用这一个AppCode即可访问所有已订阅的API服务。
3. 云市场用户控制台会实时展示已订阅的预付费API服务的可用额度如您免费试用额度已用完您可以选择重新订阅。
# tourist-attraction-query 服务器配置文档
本文档旨在为`tourist-attraction-query`服务器提供一个清晰的功能和工具使用指南。通过本指南用户可以了解如何利用该服务来查询旅游景点相关信息以及如何解读API响应。
## 功能简介
`tourist-attraction-query` 是一款专为旅游爱好者设计的服务平台,它允许用户根据不同的搜索条件(如城市、省份或特定景点名称)来查找详细的旅游景点资料。这项服务不仅能够返回关于景点的基本信息(比如地址、联系方式等),还提供了诸如最佳游览时间、门票价格等实用建议,极大地丰富了用户的旅行计划制定过程。
## 工具简介
### 景点信息查询
**用途**:此工具主要用于帮助用户快速定位并获取感兴趣的旅游目的地的具体详情。用户可以根据自己的需求设置筛选条件,从而获得更加精准的结果。
**使用场景**
- 当你需要规划一次旅行但对目的地不熟悉时。
- 如果你想比较不同景点之间的差异以便做出选择。
- 对于想要了解更多有关某个特定地方的文化背景或者历史故事的游客来说也非常有用。
#### 参数说明
- **city** (市): 输入想查询的城市名。
- **page** (页码): 指定希望查看的数据页数。
- **province** (省): 提供省级行政区划以缩小搜索范围。
- **spot** (景点名称): 直接输入你感兴趣的景点名字进行精确匹配。
#### 请求示例
```yaml
url: https://scenicspot.market.alicloudapi.com/lianzhuo/scenicspot
method: GET
headers:
Authorization: "APPCODE {{.config.appCode}}"
X-Ca-Nonce: "{{uuidv4}}"
```
#### 响应结构
响应将以JSON格式返回并包含以下字段
- **data**: 包含实际数据的对象。
- **record[]**: 每个记录都是一个对象,代表一个景点的信息。
- **addr**: 地址
- **grade**: 等级
- **lat**: 纬度坐标
- **lng**: 经度坐标
- **opentime**: 开放时间
- **spot**: 名称
- **tel**: 联系电话
- **type**: 类型
- **url**: 官网链接
- **visittime**: 推荐游玩时间
- **totalcount**: 总条目数
- **totalpage**: 总页数
- **resp**: 包含请求状态的消息。
- **RespCode**: 状态码
- **RespMsg**: 描述信息
以上就是`tourist-attraction-query`服务器及其主要功能的简要介绍。希望这份文档能帮助您更好地理解和使用我们的服务!