tencentmap-lbs-skill

腾讯地图位置服务，支持POI搜索、路径规划、旅游规划、周边搜索，轨迹数据可视化和地图数据可视化

Security Scan

The skill's requirements and instructions are coherent with its stated Tencent Maps LBS purpose; the only practical risk is trusting and installing the external npm package that provides the tmap-lbs CLI and protecting your TMAP_WEBSERVICE_KEY.

Purpose & Capability

Name/description (Tencent LBS: POI, routing, travel, trail visualization) match the required binary (tmap-lbs) and the single required env var (TMAP_WEBSERVICE_KEY). The declared primary credential is the expected Tencent Web Service Key.

Instruction Scope

SKILL.md restricts actions to running the tmap-lbs CLI and following scenario-specific reference docs. It instructs checking/setting the Web Service Key and to request user-provided data URLs for trail visualizations. No instructions appear to read unrelated system files or exfiltrate data beyond calling Tencent map endpoints or user-provided data URLs.

Install Mechanism

Install uses an npm package (@tencent-map/lbs-skills) producing the tmap-lbs binary — this is an expected delivery method for a CLI but carries the usual moderate risk of installing third-party npm packages (verify package authenticity, publisher, and contents before global install).

Credentials

Only one credential (TMAP_WEBSERVICE_KEY) is requested, which is proportionate to calling Tencent Web Service APIs. The docs instruct not to output the key and to prompt the user to set it if missing.

Persistence & Privilege

Skill is not always-enabled and does not request elevated/persistent platform privileges. It can be invoked autonomously by the agent (default), which is normal; there is no evidence it modifies other skills or global agent settings.

Assessment

This skill appears internally consistent: it uses the tmap-lbs CLI installed from the npm package @tencent-map/lbs-skills and your Tencent Web Service key to call map APIs. Before installing or enabling it, consider: 1) Verify the npm package and publisher (review the package on the npm registry or GitHub) before a global install; 2) Install in an isolated environment or use a non-global install if you prefer; 3) Limit the TMAP_WEBSERVICE_KEY scope and rotate it if possible — treat it like any API secret and do not paste it into chats; 4) Be cautious when supplying data URLs for trail visualization (ensure they point to benign JSON and not internal endpoints or sensitive resources); 5) Monitor API usage on your Tencent account after enabling the skill to detect unexpected calls. If you want higher assurance, review the source of @tencent-map/lbs-skills or prefer calling Tencent Web Service APIs directly with your own vetted code.

腾讯地图位置服务 Skill

腾讯地图位置服务向开发者提供完整的地图数据服务，包括周边搜索，地点搜索、路径规划、旅游规划等功能。

Requirements

tmap-lbs

第一次使用如果没有安装 tmap-lbs，请先安装 tmap-lbs, 如果用户需要更新，也是同样的命令。

npm install @tencent-map/lbs-skills -g

腾讯地图 Web Service Key

使用时需要配置腾讯地图 Web Service Key：

1. 先通过 tmap-lbs config get-key 检查是否已配置 Key，只输出是否有，不要输出 Key 值
2. 如果未配置，提示用户访问 腾讯位置服务 创建应用并获取 Key
3. 配置 Key（二选一）：
   • tmap-lbs config set-key <your-key>
   • export TMAP_WEBSERVICE_KEY=<your-key>

功能特性

• 搜索
  • 支持关键词和 POI 搜索功能
  • 支持基于中心点坐标和半径周边搜索
• 规划
  • 旅行日程规划
  • 路径规划（步行、驾车、骑行、公交）
• 数据可视化
  • 地图数据可视化
  • 轨迹数据可视化展示

当用户想要搜索地址、地点、周边信息（如美食、酒店、景点等）、规划路线时，使用此 skill。

触发条件

用户表达了以下意图之一：

• 搜索某类地点或某个确定地点（比如"故宫在哪"，"搜酒店"、"找加油站"）
• 基于某个位置搜索周边（如"奥林匹克公园周边美食"、"北京西站附近的加油站"）
• dan 包含"搜"、"找"、"查"、"附近"、"周边"、"路线"、"规划"等关键词
• 旅游规划（如"帮我规划北京一日游"、"杭州西湖游览路线"）
• 规划路线（如"从故宫到南锣鼓巷怎么走"、"规划一条骑行路线"）
• 轨迹可视化（如"帮我生成轨迹图"、"上传轨迹数据"、"GPS 轨迹展示"）

场景判断

收到用户请求后，先判断属于哪个场景：

• 场景一：用户搜索某个位置周边或者附近的某类地点，输入中同时包含「位置」和「搜索类别或者 POI 类型」两个要素（如"西直门周边美食"、"北京南站附近酒店", "搜索亚洲金融大厦附近的奶茶店"）
• 场景二：POI 详细搜索（使用 Web 服务 API）
• 场景三：路径规划
• 场景四：旅游规划
• 场景五：轨迹可视化（用户提供了轨迹数据地址，想生成轨迹图）

---

场景一：基于位置的周边或者附近搜索

用户想搜索某个位置周边或者附近的某类地点。需要先通过地理编码 API 获取该位置的经纬度，再拼接带坐标的搜索链接。

📖 匹配到此场景后，必须先读取 references/scene1-nearby-search.md 获取详细的执行步骤、API 格式、完整示例和回复模板，严格按照文档中的步骤执行。

---

场景二：POI 详细搜索

使用腾讯地图 tmap-lbs 进行 POI 搜索，支持关键词搜索、城市限定、周边搜索等。

📖 详细的格式、参数说明和返回数据格式请参考 references/scene2-poi-search.md

---

场景三：路径规划

使用腾讯地图 tmap-lbs 规划路线。支持步行、驾车、骑行（自行车）、电动车、公交等多种出行方式。

📖 详细的格式、各出行方式的 API 端点、参数说明和返回数据格式请参考 references/scene3-route-planning.md

---

场景四：旅游规划

用户想去某个城市旅游，提供了多个想去的景点，需要规划最佳行程路线，并可选推荐餐厅、酒店等。需要先通过地理编码 API 获取各景点的经纬度，再拼接旅游规划链接。

📖 匹配到此场景后，必须先读取 references/scene4-travel-planner.md 获取详细的执行步骤、API 格式、完整示例和回复模板，严格按照文档中的步骤执行。

---

场景五：地图数据可视化

当用户有一份包含轨迹坐标的数据，希望在地图上以轨迹图的形式可视化展示。不需要 API Key。

触发条件

用户提到"轨迹"、"轨迹图"、"轨迹可视化"、"GPS 轨迹"、"运动轨迹"、"行驶轨迹"等意图，并提供了数据地址或轨迹数据。

📖 匹配到此场景后，必须先读取 references/scene5-trail-map.md 获取详细的 URL 格式、执行步骤、完整示例和回复模板，严格按照文档中的步骤执行。

---

注意事项

• 场景判断是关键：区分用户是"直接搜某个东西"、"在某个位置附近搜某个东西"、"规划路线"还是"旅游规划"
• 关键词应尽量精简准确，提取用户真正想搜的内容
• URL 中的中文关键词浏览器会自动处理编码，无需手动 encode
• 腾讯地图坐标格式为 纬度,经度（注意：纬度在前，经度在后）
• 如果 API 返回 status 不为 0，说明请求失败，需提示用户检查地址是否有效
• API Key 请妥善保管，切勿分享给他人

文档引用（references）

各场景的详细操作文档存放在 references/ 目录下：

文件	说明
references/scene1-nearby-search.md	场景一：周边/附近搜索 — 执行步骤、API 格式、完整示例、回复模板
references/scene2-poi-search.md	场景二：POI 详细搜索 — 请求格式、参数说明、返回数据格式
references/scene3-route-planning.md	场景三：路径规划 — 请求格式、API 端点、参数和返回数据说明
references/scene4-travel-planner.md	场景四：旅游规划 — 使用方法、功能说明
references/scene5-trail-map.md	场景五：轨迹可视化 — URL 格式、执行步骤、完整示例、回复模板

---

相关链接

• 腾讯位置服务
• Web 服务 API 总览