byted-volcengine-finops

byted-volcengine-finops is a skill for Claude Code, Codex from bytedance/agentkit-samples. It costs 82 tokens per session (4,120 once invoked), scanned A, original, Apache-2.0.

A billing analysis tool for Volcengine, a cloud provider. It queries account, product, instance, allocation, and detailed cost records for selected billing periods and dates.

In plain words
What is it for?
It helps review account spending, compare product costs, inspect individual charges, and analyze amortized or split billing records.
Why use it?
It removes the need to assemble cloud spending data manually from several billing views. It helps separate overall costs from product, account, instance, and allocation details.

Skill for Claude CodeCodex ✓ vendor

Which agent this was written for is unclear — built for openclaw. Also seen: built for openclaw.

Good fit It helps review account spending, compare product costs, inspect individual charges, and analyze amortized or split billing records.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/bytedance/agentkit-samples/byted-volcengine-finops
About the project

bytedance/agentkit-samples is a collection of examples and tutorials for Volcengine AgentKit, an AI-agent development platform for building, deploying, and operating agent applications. Developers use the samples to learn agent creation, multi-agent collaboration, memory, retrieval, MCP integrations, media generation, customer service, and other workflows. The catalogue skills provide agent workflows based on these examples.

bytedance/agentkit-samples · 449 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add bytedance/agentkit-samples --skill byted-volcengine-finops
Clone the repo
git clone --depth 1 https://github.com/bytedance/agentkit-samples

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for byted-volcengine-finops

README.md
[![agentmods](https://agentmods.dev/badge/skills/bytedance/agentkit-samples/byted-volcengine-finops.svg)](https://agentmods.dev/skills/bytedance/agentkit-samples/byted-volcengine-finops)
Your own site
<a href="https://agentmods.dev/skills/bytedance/agentkit-samples/byted-volcengine-finops"><img src="https://agentmods.dev/badge/skills/bytedance/agentkit-samples/byted-volcengine-finops.svg" alt="Measured on agentmods" height="20"></a>
Per session 82 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,120 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00082 $0.04120
Opus 5 $0.00041 $0.02060
Sonnet 5 $0.00016 $0.00824
Haiku 4.5 $0.00008 $0.00412

Measured 4d ago against content hash 3652222fdd04, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

byted-volcengine-finops scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

The scan reads SKILL.md. This mod also ships 6 executable files (scripts/common.py, scripts/list_amortized_cost_bill_detail.py, scripts/list_bill_detail.py, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/byted-volcengine-finops/SKILL.md · 458 lines

How it starts

The opening of the file, as written. The whole thing — 458 lines — stays where its author put it; the contents beside it link to each section on GitHub.

火山引擎账单 Skill

这个 Skill 用于通过火山引擎 Python SDK 查询费用中心账单数据,并围绕账期、分摊月、日期、实例、产品、账号、分账维度做汇总分析。

何时使用此 Skill

当用户要求:

  • 分析火山引擎账单、成本和消费趋势的时候
  • 查询账号维度账单总览信息的时候
  • 查询产品维度成本分布的时候
  • 核对账单明细、实例费用或账单类型的时候
  • 查询分摊后成本、摊销成本或成本账单明细的时候
  • 查询分账账单、分拆项费用或分摊结果的时候

主要功能

1. 账号账单总览查询

  • 使用 ListBillOverviewByCategory 查询账号维度账单总览
  • 适合先看整月整体账单金额和大盘趋势

2. 产品月度账单查询

  • 使用 ListBillOverviewByProd 查询单产品、多产品、全量产品月度账单
  • 支持分页获取完整产品列表
  • 适合识别高成本产品和主要费用来源

3. 账单明细与分账查询

  • 使用 ListBillDetail 查询账单明细
  • 使用 ListAmortizedCostBillDetail 查询成本账单明细
  • 使用 ListSplitBillDetail 查询分账账单
  • 支持按账期、分摊月、日期、产品、账号、实例、分拆项筛选

4. 配置与调用方式

  • 支持环境变量配置 AK/SK
  • 支持 .env 文件配置
  • 支持 Python 代码调用
  • 支持通过 scripts/ 下的独立脚本直接调用
  • 支持分页拉取与本地汇总分析
  • 支持 JSON 结构化结果处理

处理逻辑

账单查询处理流程

  1. 根据用户目标确定接口
    • 整体账单使用 ListBillOverviewByCategory
    • 产品月度账单使用 ListBillOverviewByProd
    • 明细核对使用 ListBillDetail
    • 成本明细使用 ListAmortizedCostBillDetail
    • 分账排查使用 ListSplitBillDetail
  2. 根据时间要求确定账期与日期范围
    • 优先确定 BillPeriod
    • 成本账单优先确定 AmortizedMonth
    • 需要单日细查时补充 ExpenseDate
    • 成本账单按日细查时补充 AmortizedDay
    • 跨月查询需要拆成多个账期分别查询
  3. 根据过滤条件组装 SDK 请求参数
    • 例如产品、账号、实例、账单类型、分拆项等
  4. 如为分页接口则循环查询
    • 使用 Offset + Limit + NeedRecordNum 分页拉全量
    • 可使用 common.py 中的 fetch_all_pages 工具函数自动翻页
  5. 对结果做汇总分析
    • 输出金额、排行、异常波动和待核对项

前置要求

需要安装火山引擎 Python SDK:

pip install --upgrade "volcengine-python-sdk>=5.0.30"

说明:

  • 建议使用 5.x 最新版本
  • 历史版本 4.0.1 ~ 4.0.42 存在 SDK 重试缺陷,尽量不要继续使用

配置方式

需要配置火山引擎的 Access Key 和 Secret Key。推荐使用以下两种方式之一:

方式 1:环境变量

export VOLCENGINE_AK="your-ak"
export VOLCENGINE_SK="your-sk"
export VOLCENGINE_REGION="cn-beijing"

方式 2:.env 文件

~/.openclaw/workspace/.env 中配置:

VOLCENGINE_AK=your-ak
VOLCENGINE_SK=your-sk
VOLCENGINE_REGION=cn-beijing

账单参数说明

账单查询核心参数

  • BillPeriod: 账务账期,格式为 YYYY-MM
  • ExpenseDate: 账单日期,格式为 YYYY-MM-DD
  • AmortizedMonth: 分摊月,格式为 YYYY-MM
  • AmortizedDay: 分摊日,格式为 YYYY-MM-DD
  • Offset: 分页偏移量
  • Limit: 单页数量,范围 [1,300]
  • NeedRecordNum: 是否返回总记录数,1 返回 Total,否则常为 -1
  • IgnoreZero: 是否忽略折后价为 0 的数据,0 不忽略、1 忽略
  • Product: 产品筛选条件。可选的产品 Code 请参考 references/product-code.md

Read the full file on GitHub · 458 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 458 lines · 82 tokens per session scan A 3652222fdd04

Subscribe to this mod's changes

byted-volcengine-finops is a skill published in the GitHub repository bytedance/agentkit-samples (449 stars, last pushed 3d ago), licensed Apache-2.0. It adds 82 tokens to every session and 4,120 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.