前言¶

售前、解决方案或内部成本评估时，经常要在控制台和价目页之间来回切换，把「几核几 G、哪个地域、包年还是按量」翻译成询价参数。手工查一轮 CVM，再换产品查 CDB、Redis，容易漏项，也不方便把结果整理成给客户看的报价单。

下面介绍 SkillHub 上的社区技能 腾讯云价格查询（坐标 @user_2211ee67/tencent-cloud-product）。它把多类腾讯云产品的中文描述解析成结构化参数，调用本地 Python 脚本或打包好的价格数据完成询价，并支持生成 Excel 报价单。与单纯让模型去搜网页价目相比，技能文档要求 Agent 优先走本地脚本，减少幻觉和过时报价。

这是什么¶

腾讯云价格查询 是基于通用 SKILL.md 格式的 Agent Skill，发布在 SkillHub，来源为 community，分类 business-ops，当前页面版本 1.0.9，发布者 user_2211ee67。SkillHub 标注 requires_api_key=true（需配置腾讯云 API 密钥）。页面显示评分 100000，下载 1082 次（数据取自 SkillHub 技能页，会随时间变化）。

技能包内 SKILL.md 作者字段为 Blacknoisy。定位是：用自然语言或结构化输入查询腾讯云多产品价格，并可生成报价单。

核心功能¶

已核实支持的产品与能力如下（与官方简介一致）：

共性能力：

1. 自然语言解析：各产品有对应的 scripts/parse_*_input.py，例如 CVM 用 parse_input.py，CDB 用 parse_cdb_input.py。
2. 数量：全产品支持解析「几台 / 几套 / 数量 n」，并按数量汇总总价。
3. 报价单：scripts/generate_quote.py 可根据查询结果生成 Excel；客户公司、客户经理等字段可按 SKILL.md 说明填写或留空。
4. 密钥配置：复制 credentials.example.json 为 credentials.json 填入 secretId、secretKey，或使用环境变量 TCC_SECRET_ID、TCC_SECRET_KEY，也可兼容 TCCLI 配置。

执行策略（技能内「强制执行规则」）：

• 命中覆盖范围时，优先调用本地脚本，不要先联网搜索。
• TRTC、IM、Push、CDN、COS 默认读取技能包内 outputs/ 下的 JSON 价格文件，而非实时抓网页；仅当本地数据缺失或损坏时再提示补文件或确认是否兜底。
• CVM、CDB、Redis、Lighthouse、SQL Server 等通过腾讯云 Python SDK 调用对应询价接口（如 CVM 的 InquiryPriceRunInstances），需有效密钥与相应产品权限。

安装与启用¶

1. 安装 SkillHub CLI（如尚未安装）¶

command -v skillhub && skillhub --version

未安装时可按 SkillHub 安装文档执行（完整安装示例）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

文档地址：https://skillhub.cn/install/skillhub.md

2. 安装技能到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向当前客户端识别的 skills 目录。SkillHub 文档给出的常见路径：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装命令（与 skillhub search 输出一致）：

skillhub install tencent-cloud-product --namespace user_2211ee67 --dir ~/.cursor/skills

也可在对话中让 AI 按安装说明执行：请根据 https://skillhub.cn/install/skillhub.md，安装 @user_2211ee67/tencent-cloud-product。

安装完成后，一般需要重启或重新加载当前 Agent，才能识别新技能。

3. 安装 Python 依赖与密钥¶

进入技能安装目录后：

pip install tencentcloud-sdk-python

复制并编辑密钥文件：

cp credentials.example.json credentials.json

credentials.json 示例结构：

{
  "secretId": "AKIDxxxxxxxxxxxxxxxx",
  "secretKey": "xxxxxxxxxxxxxxxx"
}

请勿将真实密钥提交到版本库；技能说明中已将 credentials.json 列入忽略项。

典型用法¶

在对话中直接询价¶

技能 trigger 列表包含多种中文表述，例如「南京地区 4 核 8g」「查询 CVM 价格」「CDN 价格查询」「生成报价单」等。启用技能后，用自然语言描述地域、规格、时长即可；Agent 应按 SKILL.md 中的产品路由选择脚本（CVM：parse_input.py + query_cvm_price.py；CDN：parse_cdn_input.py + query_cdn_price.py，其余产品同理）。

询价结束后，可追问「是否需要生成报价单？」，或直接输入类似：报价单：云服务器 4 核 8G 一年。

命令行复现（CVM）¶

在技能目录下，先解析再询价：

python3 scripts/parse_input.py "南京，SA5，4核8g，50g通用型ssd云盘，1M包年包月带宽，时长为1年"
python3 scripts/query_cvm_price.py '{"region":"ap-nanjing","instance_type":"SA3.LARGE8","disk_size":50,"disk_type":"CLOUD_BSSD","bandwidth":1,"period":12,"charge_type":"PREPAID"}'

解析脚本会输出地域、实例类型、磁盘类型、带宽计费方式、period（月）等字段；缺参时技能要求向用户补问硬盘、带宽、时长等。

命令行复现（CDB）¶

python3 scripts/parse_cdb_input.py "南京 MySQL云数据库 4核8g 150g硬盘 一年多少钱"
python3 scripts/query_cdb_price.py tmp_params.json

命令行复现（Redis）¶

python3 scripts/parse_redis_input.py "查询广州地区 Redis 3个分片 分片容量4g 2个副本 1年的价格"
python3 scripts/query_redis_price.py '{"region":"ap-guangzhou","type_id":16,"mem_size":4096,"goods_num":1,"period":12,"billing_mode":1,"redis_shard_num":3,"redis_replicas_num":2,"product_version":"local"}'

报价单¶

在已有查询结果的前提下，由 Agent 调用：

python3 scripts/generate_quote.py

（具体入参以技能目录内脚本帮助或 SKILL.md 为准；生成逻辑内置在脚本中，发布包不依赖外部 Excel 模板。）

适用场景与注意¶

适合谁

• 需要在 Cursor、Claude Code、Codex 等环境中快速做腾讯云多产品组合询价的售前、架构师、运维或开发者。
• 希望用统一的中文话术驱动询价，并偶尔导出报价单 Excel 的团队。

限制与注意

1. 密钥与权限：未配置 credentials.json 或环境变量时，依赖 API 的产品无法询价；子账号需具备对应产品 API 权限。CVM 使用前需已开通服务并完成实名认证（见 SKILL.md「账户要求」）。
2. 价格数据来源：CDN/COS/IM/Push/TRTC 依赖包内 outputs/ 快照，不等于官网实时价；CVM 等走 API 的结果也仅供参考，以控制台下单为准。
3. API 频率：文档提到默认约 10 次/秒 限制，批量比价需控制调用节奏。
4. 计费语义：技能对「一年」与「带宽按量」有明确规则（例如默认「一年」为实例与带宽均包年包月，除非用户单独说明带宽按量），避免 Agent 误读为全按量。
5. 机型与可用区：CVM 须通过接口校验可用区与机型可售性，技能不会自动替用户改机型；失败时应按提示换机型或地域。

结尾¶

经过上面的步骤，你可以在 Agent 里用一句话覆盖 CVM 到 TRTC 等多类腾讯云询价，并在需要时落到脚本与报价单。官方 SkillHub 页面与 API 入口：

• 技能页：https://www.skillhub.cn/skills/user_2211ee67/tencent-cloud-product
• API 坐标：https://api.skillhub.cn/user_2211ee67/tencent-cloud-product

安装与 skills 目录说明：https://skillhub.cn/install/skillhub.md