Tencentmap Map Assistant

What it does

Example prompts

• “/tencentmap-map-assistant”

Requirements

• Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

1. 1Key：未配置 Key 也可直接调用并完成任务；如已有腾讯位置服务 Key，用 save_key_to_dotenv 配置后稳定性更佳。
2. 2travel_guide：单次调用约 30-50 秒，建议先告知用户稍候；返回的 output_markdown 是成品攻略文件，请用 Read 读取后将文件内容完整作为回复——其中包含行程正文与小程序二维码图片，需整段原样呈现，不要改写、转述或省略其中的图片。呈现后可在末尾轻…
3. 3query：包含明确目的地，建议带天数（如"X 天 / X 日游"）。
4. 4可视化：多 POI 对比 / 路线 / 多天行程等场景适合生成 HTML 网页地图；单点查询直接返回结构化数据。

What it can do on your machine

Read from SKILL.md and the folder at commit 75a5ad9. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 1 file in scripts/, which the agent can run.

  Shell commands in SKILL.md call:

  • pip

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tencentmap Map Assistant loads about 1.7k tokens when it runs, and up to ~238k if it reads all its reference files. Until then it costs about 52 tokens; SKILL.md has 446 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~52

When it runs · the whole SKILL.md, loaded when a task matches

~1.7k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~238k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NoteMentions a .env fileSKILL.md:58

  配置自己的腾讯位置服务 Key（持久化到 skill 包内 `.env`，之后自动启用）：

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from infometa/workbuddyskills at commit 75a5ad9, republished under its MIT licence (© infometa). 446 words, ~1,706 tokens.

name

tencentmap-map-assistant

description

腾讯位置服务·地图助手 Skill，一句自然语言调用腾讯地图全套能力，无需开发者账号、开箱即用。提供 AI 旅游攻略、地点搜索（含评分/人均/营业时间）、关键词提示、路线规划（驾车/步行/公交/骑行）、地址解析与逆解析、行政区划、IP 定位、距离计算、天气查询，并可将行程或多 POI 渲染成网页地图。涉及找地点、规划路线、旅游行程、查天气、坐标转换等出行场景时使用。

version

1.4.4

license

MIT

display_name

腾讯位置服务·地图助手

display_name_en

Tencent Map Assistant

description_zh

腾讯位置服务出品的地图助手 Skill。一句自然语言即可调用腾讯地图全套能力：AI 旅游攻略生成、POI 搜索（含评分/人均/营业时间）、路线规划（驾车/步行/公交/骑行）、地址坐标互转、行政区划查询、天气查询，并可将行程或 POI 渲染为网页地图。零配置开箱即用，支持配置正式 Key 提升稳定性。

description_en

A map assistant powered by Tencent Location Services. Call the full suite of Tencent Maps with natural language: AI travel guides, POI search with ratings and…

visibility

public

icon

https://codebuddy-platform-1258344699.cos.accelerate.myqcloud.com/public/803d2199-f921-4b57-83b7-95ffefb69248/avatar/skill/au_3e746d31-4d9.png

pip install requests

import sys, os
sys.path.insert(0, os.path.expanduser('~/.workbuddy/skills/TencentMap_map-assistant/scripts'))
from tmap_client import TmapClient

client = TmapClient()

result = client.travel_guide("武汉5天攻略")
pois   = client.poi_search("黄鹤楼", region="武汉")
addr   = client.geocoder("深圳市腾讯滨海大厦")

from tmap_client import save_key_to_dotenv
save_key_to_dotenv("你的 Key")

district_list()                  # 全国省级列表
district_children(parent_id)     # 下级区划（parent_id="110000" → 北京下属）
district_search(keyword)         # 关键词搜区划

client = TmapClient()

# 旅游攻略（返回 output_markdown 成品文件，Read 后作为回复）
r = client.travel_guide("成都3天美食游")

# POI 搜索
pois = client.poi_search("咖啡馆", location="22.540601,113.93397", page_size=5)

# 路线规划
route = client.direction("深圳北站", "深圳湾口岸", mode="driving")

© infometa, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 219 other files (scripts, references) in skills/tencentmap-map-assistant of infometa/workbuddyskills.

• SKILL.md
• .env.example
• references/agent-notes.md
• references/jsapi-guide/README.md
• references/jsapi-guide/jsapigl/demos/┬╡├¿├┐╧äΓòæΓöÉ_┬╡├¿├┐╧äΓòæΓöÉ-╧âΓò£ΓîÉ╬ª├ûΓòú╧äΓòæΓöÉ.html
• references/jsapi-guide/jsapigl/demos/┬╡├¿├┐╧äΓòæΓöÉ_┬╡├¿├┐╧äΓòæΓöÉ-╧â├¿┬┐┬╡├ç├╝╧ä┬½┬í╧â├▒Γöñ.html
• references/jsapi-guide/jsapigl/demos/┬╡├¿├┐╧äΓòæΓöÉ_┬╡├¿├┐╧äΓòæΓöÉ-╧â├▒┬║╧â┬ú├Ñ╬ª├¬┬¼╧äΓòæΓöÉ.html
• references/jsapi-guide/jsapigl/demos/┬╡├¿├┐╧äΓòæΓöÉ_┬╡├¿├┐╧äΓòæΓöÉ-╬ª├û├£╧äΓòæΓöÉ┬╡├íΓòû╧âΓò¥├à.html
• references/jsapi-guide/jsapigl/demos/┬╡├¿├┐╧äΓòæΓöÉ_┬╡├¿├┐╧äΓòæΓöÉ┬╡├íΓòû╧âΓò¥├à╬ª├º┬¼╧â┬½├£╬úΓòú├½.html
• references/jsapi-guide/jsapigl/demos/┬╡├¿├┐╧äΓòæΓöÉ_┬╡├¿├┐╧äΓòæΓöÉ╧âΓòæ├╢╧ä├╢┬┐
• references/jsapi-guide/jsapigl/demos/┬╡├¿├┐╧äΓòæΓöÉ_┬╡├¿├┐╧äΓòæΓöÉ╧ä├⌐Γòú╧â├ºΓòù╬úΓòæ├»╬úΓòùΓòó.html
• references/jsapi-guide/jsapigl/demos/┬╡├¿├┐╧äΓòæΓöÉ_╧äΓòæΓöÉ┬╡┬Ñ├¡┬╡Γöé┬ó╧â├á├½┬╡├▓├¬┬╡Γéº┬ú.html
• references/jsapi-guide/jsapigl/demos/┬╡├¿├┐╧äΓòæΓöÉ_╧ä┬½├¡╬ÿ├╝├┤╧äΓòæΓöÉ.html
• references/jsapi-guide/jsapigl/demos/┬╡├¿├┐╧äΓòæΓöÉ_╧ä┬½├ç╧â├¼├▓┬╡├¿├┐╧äΓòæΓöÉ.html
• references/jsapi-guide/jsapigl/demos/┬╡┬ú├¼╧â├¿├¡╧äΓûÆΓòù╧âΓòæ├┤_IP╧â┬½├£╬úΓò£├¼.html
• references/jsapi-guide/jsapigl/demos/┬╡┬ú├¼╧â├¿├¡╧äΓûÆΓòù╧âΓòæ├┤_╧â├áΓöé╬ÿ├╢┬½╧â┬í├╣┬╡├ë┬ú╧äΓöñ├│.html
• references/jsapi-guide/jsapigl/demos/┬╡┬ú├¼╧â├¿├¡╧äΓûÆΓòù╧âΓòæ├┤_╧â├áΓöé╬ÿ├╢┬½╧â┬í├╣╬ªΓò¢├┤╧â├á├æ┬╡├à├ë╧ä├▒Γòæ.html
• … and 203 more

Open the folder on GitHubat commit 75a5ad9