前言¶
投放同學每天要在三連後臺看餘額、覈對日預算和次日預算，財務或運營還要翻賬戶流水。若你已經用 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
