前言¶
投放同学每天要在三连后台看余额、核对日预算和次日预算，财务或运营还要翻账户流水。若你已经用 MAPI 或脚本接了三连，预算查询、改预算、删次日预算往往要对着开发者文档拼不同 HTTP 方法；问「今天花了多少」时，还容易把账户流水和投放报表混在一起。
下面介绍 SkillHub 上的 B站三连广告-账户资金相关（内部标识 bilibili-sanlian-ads-account-finance）。它把账户级预算与资金流水封装成 Agent 可执行的 Skill，与同系列的授权入口、投放报表 Skill 分工明确，避免在对话里误用接口。
这是什么¶
B站三连广告-账户资金相关 面向哔哩哔哩三连推广（Sanlian Ads）广告主账户的资金侧能力：当日/次日账户预算及重复设置、余额相关流水查询。作者为 Benjamin，当前技能包版本 3.0.4（MIT），在 SkillHub 归类为 business-ops，评分约 98906，下载约 2441 次（数据来自 SkillHub 列表页信息）。
账户预算与计划、单元预算不同：后者在「B站三连广告-广告管理」Skill 中处理。本 Skill 只覆盖账户维度的预算与流水，不替代投放效果报表。
官方入口：
- https://api.skillhub.cn/user_b0010d5c/sanlian-ads-account-finance
- 站内 canonical：https://skillhub.cn/skills/sanlian-ads-account-finance
核心功能¶
依据技能包 SKILL.md 与内置 reference，已核实能力如下。
| 目标 | 说明 |
|---|---|
| 查询账户预算 | 当日预算、次日预算、次日是否每日重复（is_repeat） |
| 设置账户预算 | 指定金额或不限预算；生效日为当日或次日；可配置次日预算是否循环 |
| 删除次日预算 | 仅清除次日配置，不影响当日预算 |
| 查询账户流水 | 按天查看资金变动台账（充值、转出、消耗等汇总维度） |
对应 MAPI 路径（域名均为 https://cm.bilibili.com/takumi/api）：
GET /open_api/cpc/v3/account/budget— 预算查询POST /open_api/cpc/v3/account/budget— 预算设置DELETE /open_api/cpc/v3/account/nextday_budget— 删除次日预算GET /open_api/report/v3/cash_flow— 账户流水
中文触发词（写在技能描述中，便于对话唤起）：账户预算、日预算、次日预算、余额、账户流水、充值、资金、钱包。
关联技能：bilibili-sanlian-ads（OAuth 与 access_token）、bilibili-sanlian-ads-reporting（投放消耗与效果指标）。
安装与启用¶
- 在 SkillHub 打开上述官方地址，按页面指引将技能安装到当前 Agent 环境（与同站其他三连广告技能一致，发布命名空间为 indiv-benjamin，slug 为 sanlian-ads-account-finance）。
- 先安装并配置 B站三连广告-授权与主流程（
bilibili-sanlian-ads），完成 OAuth，保证目标广告主account_id在 token 授权范围内。 - 本技能自带
scripts/mapi.sh（Windows 下用py -3 scripts/mapi_client.py）。需要 Python 3.8+；可通过环境变量SANLIAN_PYTHON指定解释器路径。
技能包直链（与 SkillHub 下载 API 一致，便于核对版本）：
https://api.skillhub.cn/api/v1/download?slug=sanlian-ads-account-finance&namespace=indiv-benjamin
调用约定（技能内强制）：
- 所有 MAPI 请求经
mapi.sh/mapi_client.py的call子命令发起，不要手写curl或并行多账户刷接口。 - 请求头需包含
Authorization: Bearer {access_token}、X-Call-Source: sanlian-skills、X-Sanlian-Skills-Version: 3.0.4；JSON 体接口另加Content-Type: application/json。 - 预算查询为 GET，设置为 POST，删除次日预算为 DELETE，路径相似，拼错方法会直接失败。
各 Agent 产品（Cursor、Codex CLI、Claude Code 等）的安装入口以 SkillHub 页面与各自「Skills」配置为准；未在官方页单独说明的差异，本文不展开。
典型用法¶
用自然语言驱动¶
在已启用技能的前提下，可直接描述意图，例如：
- 「查一下账户 123456 今天的日预算和次日预算，次日是不是每天重复。」
- 「把账户 123456 的次日预算改成 1000 元，每天循环生效，先给我看改前改后。」
- 「列一下这个账户 6 月的账户流水，看充值和余额变动。」
Agent 应按技能要求：先确认 access_token 与 account_id，改预算前 查询现状 → 展示前后对比并征得确认 → 写入 → 再查询核对。
通过 mapi 客户端调用（技能推荐路径）¶
在技能目录下，用 JSON 文件传 query 或 body。查询当日/次日预算示例：
# q.json 内容示例：{"account_id": 123456}
./scripts/mapi.sh call GET /open_api/cpc/v3/account/budget --query-file q.json
设置次日指定预算并每日重复（字段含义见 reference 1879）：
# body.json 示例
# {
# "account_id": 123456,
# "budget_limit_type": 1,
# "budget": 800.00,
# "effect_type": 2,
# "is_repeat": 1
# }
./scripts/mapi.sh call POST /open_api/cpc/v3/account/budget --body-file body.json
查询账户流水（按天聚合，分页参数见 reference 1787）：
# q.json 示例：
# {"account_id": 123456, "start_date": "2026-06-01", "end_date": "2026-06-15", "page": 1, "size": 20}
./scripts/mapi.sh call GET /open_api/report/v3/cash_flow --query-file q.json
业务成败以响应体中的 status、error_code、error_msg 为准，不能只看 HTTP 状态码。
适用场景与注意¶
适合谁
- 已接入或计划接入三连 MAPI 的投放、运营、财务自动化；希望在对话里完成「看预算 / 改预算 / 对流水」，而不是每次翻后台或临时拼请求。
- 与广告管理、报表、素材等三连 Skill 组合使用时，按主技能路由表选用本 Skill 处理资金与账户预算问题。
限制与坑
- 投放消耗 ≠ 账户流水：用户问「花了多少钱」「曝光点击转化」应走
bilibili-sanlian-ads-reporting自定义报表；流水接口说明中亦指出「三连投放总消耗」需走报表接口。 - 预算单位为元；
budget_limit_type=1时必须带正数budget，且会校验最低预算与当日已消耗，低于已消耗可能被拒——以接口返回为准，不要用试探性多次改预算去「撞」限额。 - 次日预算的
is_repeat：单次生效与每日循环在提交瞬间不易区分，设置后应读回配置；不需要次日预算时应调用删除接口，避免循环预算持续生效。 - 流水查询范围：仅支持 2023-10-01 及之后数据，单次跨度不超过 184 天；暂不支持激励券消耗查询。
- 须遵守主技能中的顺序调用、限频与写操作确认规则；预算变更直接影响在投账户，超时或结果不明时先查询现状再决定是否重试。
结尾¶
B站三连广告-账户资金相关 把账户预算的读、写、删与资金流水查询收敛到同一套 Skill 与 reference，并与授权、报表技能边界清晰。若你正在搭建三连广告的 Agent 工作流，可在 SkillHub 安装并搭配 bilibili-sanlian-ads 使用：
https://api.skillhub.cn/user_b0010d5c/sanlian-ads-account-finance
