aliyun-price-excel-maker
阿里云报价单生成
17 次下载热度 24更新 2026-09-08 1 个文件
5.2 KB
MIT 许可
描述
通过阿里云 OpenAPI MCP (aliyun-openapi-mcp-core) 实时查询任意阿里云产品的官方牌价/计费规则,并生成结构化 Excel 配置报价单(含组件功能简介、月租牌价、数量、折扣、折扣月租价、SUM 合计公式)。覆盖计算、存储、网络、数据库、大数据、AI/大模型、安全、容器、中间件、CDN、视频、IoT 等阿里云全产品线。当用户要求"做阿里云报价单"、"阿里云配置清单"、"云资源询价"、"客户方案报价"、"阿里云成本估算 Excel"、"TCO 估算"、"上云预算表"时触发。所有方案、价格、计费规则以 https://help.aliyun.com/zh 官方文档为唯一权威来源。
SKILL.md 正文
aliyun-price-excel-maker
阿里云通用报价单生成器:把"需求描述 → 阿里云资源清单 → 实时官方牌价 → 标准化 Excel 报价单"做成一次性流水线,不限定产品域。
适用场景(产品无关)
- 销售/解决方案输出阿里云配置清单与月度费用预估
- 任意组合询价:计算(ECS/ECI/弹性裸金属/HPC/GPU)、存储(OSS/NAS/CPFS/云盘)、网络(VPC/EIP/CEN/NAT/SLB-NLB-ALB/共享带宽/全球加速)、数据库(RDS/PolarDB/Lindorm/Tair/MongoDB/ADB)、大数据(MaxCompute/Hologres/DataWorks/Flink/EMR)、AI/大模型(百炼/PAI/灵积/通义听悟/向量检索)、容器(ACK/ACR/SAE)、中间件(MSE/RocketMQ/Kafka/Notifications)、安全(WAF/DDoS/堡垒机/KMS)、CDN/DCDN/EdgeRoutine、视频云、IoT、混合云、专有云外延等
- TCO / 上云预算 / 续费报价 / 折扣商务谈判表
强制原则
- 官方文档唯一源:方案、计费规则、产品能力一律引用 https://help.aliyun.com/zh 下页面;不采纳第三方价格;备注块必须放至少一个该域链接。
- 实时询价优先:优先用
AlibabaCloud___CallCLI调用对应产品的 DescribePrice / GetPayAsYouGoPrice / DescribeRenewalPrice 等定价 API。无定价 API 时回退到SearchDocuments+GetDocument抓官方定价表。 - 公式留接口:折扣列默认
100%(数值 1,格式0%),折扣月租价列固定写=D{row}E{row}F{row};销售可现场改折扣,SUM 自动重算。 - 按量项必须列入但不并入 SUM:按量后付费组件(流量费、Token 用量费、API 调用费等)月租列写"按量后付费",G 列写"按量计费"占位,备注里写清单价与计算单位。
- 币种与精度:统一 CNY、保留两位小数;合计行
¥#,##0.00;跨境地域返回值已是 CNY,不要换汇。 - 时间戳:执行前用
date取当天日期写入备注块,标注"报价基于 YYYY-MM-DD 阿里云公开牌价"。
执行步骤
1. 需求澄清(必须,用 AskUserQuestion)
按产品类型问足下列要素,缺一就问:
- 通用:地域(中国内地 / 中国香港 / 亚太 / 欧洲 / 中东 / 北美)、计费方式(包年包月 / 按量付费 / 资源包 / Savings Plan)、商务折扣(默认 100%,或客户预设 0.x)
- 计算类:实例规格族、vCPU / 内存、镜像、系统盘 + 数据盘(类型 ESSD PL0/PL1/PL2/PL3、容量)、是否需公网带宽
- 存储类:类型(标准/低频/归档)、容量(GB/TB)、请求次数预估、地域间复制
- 网络类:带宽 Mbps、计费模式(按带宽/按流量/95峰值)、BGP 或精品、跨地域对、TR 数量
- 数据库类:引擎与版本、规格族、存储类型与容量、备份保留天数、是否多可用区/只读副本
- 大数据类:计算资源单位(CU/AU/Slot)、存储 GB、调度任务数
- AI/大模型:模型 ID(qwen3.x / qwen-mt / embedding 等)、输入/输出 Token 月预估、是否独占算力
- 容器类:集群类型(Pro/标准)、Worker 节点规格与数量、是否托管 etcd
- 安全类:防护实例规格、QPS、CC 防护带宽
- CDN/视频:流量预估 TB、回源带宽、点播分发地域
- 是否需要"按量后付费组件单独列示"
2. 实时询价(按产品域选择路径)
通用调用链:
AlibabaCloud___ListProducts确认产品 productCodeAlibabaCloud___ListApis/AlibabaCloud___SearchApis(prompt=…)找 DescribePrice 类 APIAlibabaCloud___GetApiDefinition取参数定义AlibabaCloud___GenerateCLICommand生成可执行 CLIAlibabaCloud___CallCLI实际询价- 若无询价 API →
AlibabaCloud___SearchDocuments(query=…)找官方定价文档 →GetDocument(doc_id=…)取定价表
已沉淀的常用片段:
- ECS 月租:
aliyun ecs DescribePrice --RegionId <r> --InstanceType <t> --PriceUnit Month --Period 1
--ResourceType instance --IoOptimized optimized --InstanceNetworkType vpc
--InternetChargeType PayByTraffic --InternetMaxBandwidthOut 0
--SystemDisk.Category cloud_essd --SystemDisk.Size <gb> --SystemDisk.PerformanceLevel <PLx>
返回 PriceInfo.Price.DetailInfos.DetailInfo[],instanceType 与 systemDisk 分两行列示。
- RDS:
aliyun rds DescribePrice --DBInstanceClass … --EngineVersion … --PayType Prepaid --UsedTime 1 --TimeType Month - PolarDB:
aliyun polardb DescribePrice --DBNodeClass … --DBType MySQL … - OSS / NAS 等存储:多为按量后付费,查 https://help.aliyun.com/zh/oss/product-overview/billing-overview 定价表
- 大模型(百炼 / 灵积):
SearchDocuments(query="qwen3.x 计费")取 doc,按 Token 单价×百万记入按量项 - EIP 包年包月(BGP多线,需公式计算 ≥6Mbps):
- 中国内地:
125 + (n-5)×80 - 中国香港:
150 + (n-5)×100 - 新加坡/法兰克福:
115 + (n-5)×80 - 1–5Mbps 段为阶梯固定值,查 https://help.aliyun.com/zh/eip/subscription
- CEN:跨地域带宽包(中国内地↔亚太 0-100Mbps 档 860 元/Mbps/月)+ TR 连接费(内地 0.35 / 境外 0.40 元/h,×730h)+ 流量处理费 0.13 元/GB(按量项),见 https://help.aliyun.com/zh/cen/product-overview/billing-rules
- SLB/NLB/ALB、NAT、共享带宽、全球加速:先 SearchApis 找 DescribePrice,没有则走 SearchDocuments
上述片段是示例非穷举。遇到新产品按"通用调用链"4 步走,永远先实时调用 API,不要拍脑袋写数字。
3. 生成 Excel(标准模板,与产品无关)
使用 openpyxl,固定 7 列结构:
| A 序号 | B 产品名称 | C 组件功能简介 | D 月租牌价(元) | E 数量 | F 折扣 | G 折扣月租价(元) |
|---|
- 标题行(merge A:G,深蓝底白字 14pt 加粗)
- 需求描述行(merge A:G,灰色斜体 9pt)
- 表头行(蓝底白字 11pt 加粗,居中)
- 分组小标题行(merge A:G,浅蓝底)按需自定义分类:如"一、计算资源"、"二、存储与备份"、"三、网络与互联"、"四、数据库"、"五、大模型与AI"、"六、安全与合规"、"七、容器与中间件"、"八、按量后付费组件"……
- 数据行:D 列右对齐
#,##0.00,F 列居中0%,G 列写=D{r}E{r}F{r} - 按量项:D 列写"按量后付费",G 列写"按量计费";备注里补充"<单价>/<计量单位>"
- 合计行:黄底红字加粗,
=SUM(G{start}:G{end}),格式¥#,##0.00,标签"固定月租合计 (含税·CNY) — 不含 X 项按量后付费" - 备注块:merge A:G,wrap_text;必须包含计费公式说明、所引用 help.aliyun.com/zh 链接、报价日期
- 列宽:A=6, B=22, C=56, D=16, E=8, F=10, G=18
- 冻结表头
ws.freeze_panes = "A5"
参考脚本骨架可基于 ~/.qoderwork/workspace/*/build_quote.py 复用并扩展产品分类。
4. 输出与交付
- 文件路径:
<workspace>/outputs/阿里云<场景关键词>报价单.xlsx - 用
present_files卡片交付 - 文本输出复述固定月租合计 + 按量后付费项列表
- 结尾 Sources 段附上所有引用的 help.aliyun.com 文档链接
常见坑(跨产品通用)
- MCP 参数名差异:
SearchApis用prompt,SearchDocuments用query,搞反报"Parameter is required and cannot be empty"。 - 并非所有产品都有 DescribePrice CLI:VPC、OSS、CDN、大模型等大量产品无询价 API,必须走文档。不要尝试不存在的 CLI 命令。
- ECS 公网带宽:
InternetMaxBandwidthOut=0表示不含公网(与单独购 EIP 解耦),避免双重计费。 - 多组件分行:DescribePrice 返回的 instanceType / systemDisk / dataDisk / bandwidth 等子项应分行列示,方便客户看结构。
- 按量项绝不并入 SUM:流量、Token、请求次数、CC包等按量项独立标注,避免假月租。
- 币种:跨境地域返回值默认 CNY,不要换汇。
- 时效:阿里云价格随时调整,每次执行都重新调用 API;执行前
date取实时日期写入备注;不要硬编码记忆中的数字。 - 资源包 vs 后付费:OSS/CDN/带宽等可购资源包预付优惠,需问清是否计入"包年包月"还是单独资源包行项。
- 限时折扣:百炼/灵积等存在阶段性折扣文档(如 doc_id=3042139 Qwen3.7 系列折扣),需在备注块单列。
- 多地域报价:同一产品不同地域价格不同,每个地域都得单独 DescribePrice。
验证
- 用
openpyxl.load_workbook(..., data_only=False)检查 G 列公式存在 - 用
data_only=True配合 LibreOffice 重算一次确认 SUM 与各行乘积一致 - 备注块至少包含一个
https://help.aliyun.com/zh/链接 - 至少一行按量后付费项目(如客户场景中确实没有按量项,备注块需写明"本次报价无按量后付费组件")