Siluzan TSO

Security

通过 siluzan-tso-cli 操作丝路赞 TSO 广告账户(Google/Bing/Yandex/TikTok/Kwai/MetaAd)。(账户)列表、余额、统计、消耗、激活账单、历史、余额扫描 P2、账户摘要 P3、共享/取消共享、解绑、OAuth、MCC/BC/BM 绑定解绑、邮件邀请、TikTok 关闭、暂停撤回;(开户)六大媒体申请;(Google Ads)系列/广告组/广告/关键词 CRUD、附加信息、地理位置、PMax、搜索投放方案校验/创建、批量异步创建;(分析)google-analysis、google-analysis-batch P5、facebook-analysis P4-FB、网站诊断 P8、市场分析 P9、广告诊断;P1 账户画像、P4 周期报告、P6 OKKI 周报、P7 询盘分析;Google关键词推荐、RAG 检索、TSO 报告列表/创建/推送、智能预警、TikTok/Meta 线索、转账/发票/发票资料、审计恢复。当用户提及广告账户、余额、消耗、投放、关键词、开户、MCC/BC、报告、诊断、市场分析、开票或 TSO 时使用。

Install

openclaw skills install siluzan-tso
<!-- AUTO-GENERATED from SKILL.md.tmpl — edit .tmpl or snippets/, then: node scripts/gen-skill-docs.mjs -->

Siluzan TSO Skill

本 Skill 只做 任务路由:用一张「意图 → 工作流」表把用户需求映射到唯一的线性工作流。

  • 每个业务都有一条线性工作流(编号步骤):
    • 分析 / 报告类(拉数 → 脚本 → 交付)→ references/core/playbooks.md(P1–P9)
    • 操作 / 管理类(开户、广告 CRUD、优化、预警、推送、线索、财务、权限、巡检)→ references/core/workflows.md(W1–W12)
  • 业务细节、命令参数、字段口径以各域 references/*.md 为准(被工作流卡片引用,不在本文件重复)。
<!-- 注入到 SKILL.md.tmpl 的 {{AGENT_PREAMBLE}};构建时由 gen-skill-docs.mjs 合并 -->

Agent 纪律(每个新任务必读):Read references/core/agent-conventions.md,再按 SKILL.md 路由表 Read「必读文档」与对应工作流卡片(core/playbooks.md P1–P9 或 core/workflows.md W1–W12)。禁止跨话题复用参数记忆;数据类任务一律 --json-out + 仅用代码读落盘 JSON(见 references/core/tips.md)——禁止用 Read 工具打开 writtenFiles 里的完整 *.json

报告/Excel 交付前:Read references/core/deliverable-preflight.mdRead 最终产物并按自检表确认币种与章节完整;币种只认当次 list-accountscurrencyCode

HTML 终稿类报告(用户未指定格式时默认 HTML):网站诊断 P8(website-diagnosis render)、Meta 周期 P4-FB(facebook-analysis render)、战略市场 P9(market-analysis render)。Agent 只写 JSON,禁止仅交付 Markdown 摘要或纯 JSON 充当终稿。

开户:首次进入开户话题须先向用户罗列该媒体(或未指明媒体时六平台)全部必填项,见 references/accounts/open-account-by-media.md §「首次响应硬规范」。

Subagent(可选):若宿主支持 Task / 子会话,复杂报告(P5/P6/P7)或长 CLI 输出前 Read references/core/subagent-orchestration.md自行决定是否委派;写操作确认与对用户的最终交付留在主 Agent。


一键安装

  • macOS / Linux / WSL:
    bash <(curl -fsSL https://unpkg.com/siluzan-tso-cli@latest/dist/skill/scripts/install.sh)
    
  • Windows PowerShell:
    irm https://unpkg.com/siluzan-tso-cli@latest/dist/skill/scripts/install.ps1 | iex
    

Windows:部分 Agent 通过 PowerShell 代执行时可能失败,改在 Git Bash 运行 Bash 版安装命令。

登录与配置见 references/core/setup.md401 换凭据时优先「手机号 + 验证码」send-login-codelogin --phone --code


基本使用

siluzan-tso-cli 只是包名,安装后可执行命令为 siluzan-tso

siluzan-tso -h   # 查看帮助

Agent 三步法:① 在下方路由表按用户意图找到对应行 → ② Read 该行「必读文档」与对应工作流卡片 → ③ 按卡片编号步骤逐步执行,写操作前先与用户确认。


路由表(意图 → 工作流 → 必读文档)

首次进入任意任务前先 Read references/core/agent-conventions.md。下表每行指向唯一工作流;找不到时查 references/README.md

账户与财务

用户意图(关键词)工作流必读文档
账户列表 / 有哪些 / 有多少 / 列出全部某媒体W1accounts/accounts.md(§ list-accounts 意图速查:-m <媒体> --page-size 999 --json-out
单户实时余额W1accounts/accounts.md(balance)+ accounts/currency.md
多账户余额 / 续航不足预警P2accounts/accounts.md(balance-scan)+ accounts/currency.md
单户消耗 / 投放数据W1 / P1accounts/accounts.md(stats)+ accounts/currency.md
多账户消耗/对比汇总P3accounts/accounts.md(accounts-digest)+ accounts/currency.md
激活/充值账单明细W1accounts/accounts.md(account-active-bills)
开户(六大媒体)/ 开户进度W2accounts/open-account-by-media.md首次须列全必填项;Google 加 accounts/open-account-google-ui.md
账户权限:分享/取消/解绑/重授权/MCC/BC/BM/关闭/提现/邮箱授权W9accounts/accounts.md(account 子命令)
充值 / 钱包W8accounts/finance.md(recharge 引导网页)
转账记录 / 账户间转账W8accounts/finance.md(transfer)
发票 / 开票 / 发票抬头W8accounts/finance.md(invoice / invoice-info)
审计 / 误操作恢复accounts/write-audit-restore.md

Google 广告投放

用户意图(关键词)工作流必读文档
新建搜索系列 / 出投放方案W3google-ads/google-ads-campaign-plan.md + assets/campaign-create-template.md
广告系列/组/广告/关键词 CRUD / 拒审W3google-ads/google-ads.md
PMax 系列W3assets/pmax-create-template.md + google-ads/pmax-api.md
AI 智投草稿 list/get/update/publishW4google-ads/google-ads.md(§ ad batch)
拓词 / keyword / 关键词规划W5analytics/keyword-planner-workflows.md(客户背景先 analytics/rag.md
AI 广告优化记录 / 建议W6operations/optimize.md
优化/合规 SOPW3 / W6google-ads/rules/README.md

分析与报告(CLI 拉数 + Agent 撰稿)

用户意图(关键词)工作流必读文档
单账户投放画像 / 诊断P1analytics/account-analytics.md + core/tips.md + core/deliverable-preflight.md
Google 账户周期报告P4report-templates/google-period-report.md + analytics/account-analytics.md + core/deliverable-preflight.md
Meta/Facebook 周期或诊断报告P4-FBreport-templates/meta-period-report.md + assets/meta-period-report-rules.md + analytics/facebook-analysis-guide.md;要 Excel 加 meta-period-report-excel.md
TikTok / Bing 周期报告P4analytics/account-analytics.md(report tiktok-/bing-)+ 对应 report-templates/*-period-report.md
多账户 × 多维度批处理P5analytics/google-analysis-batch.md + analytics/account-analytics.md
OKKI 周报P6report-templates/okki-weekly-google-client.md(全文)
Google 询盘分析P7report-templates/google-inquiry-analysis.md(全文)+ analytics/geo-continents.json
网站诊断 / 落地页评分P8analytics/website-diagnosis-guide.md + assets/website-diagnosis-rules.md默认交付 HTML
市场分析 / 行业 / 战略市场报告P9analytics/market-analysis-guide.md + assets/market-analysis-rules.md默认交付 HTML
Google 广告诊断 / 账户健康检查P1report-templates/google-ads-diagnosis.md + report-templates/google-account-diagnosis-report.md
TSO 平台优化报告:列表/生成/推送W7analytics/reporting.md
RAG 知识库检索W5analytics/rag.md

工具与运营

用户意图(关键词)工作流必读文档
智能预警:创建/查询/启停/触发记录W10operations/forewarning.md
TikTok / Meta 线索表单W11operations/clue.md
日/周巡检W12core/workflows.md(W12)+ accounts/accounts.md
宿主编排 / 投放自控 / 异常监控 / 自动优化operations/hosted-automation-user-catalog.md(索引)→ operations/hosted-automation-*.md

数据/报告类任务通用纪律:一律 --json-out 落盘 + 仅用脚本读 JSON(见 core/tips.md);交付前 Read 最终产物按 core/deliverable-preflight.md 自检(币种/章节)。


Subagent 自主委派(可选)

宿主具备 Task / subagent 时:复杂报告或批处理(P5 / P6 / P7)、预计 CLI 输出很长 → 先 Read references/core/subagent-orchestration.md,按决策矩阵决定是否委派;handoff 模板在 snippets/handoff-p{5,6,7}-*.md写操作确认、--commit、401/resume 策略与对用户的最终交付始终留在主 Agent。无此能力则跳过,按工作流卡片在主会话执行。


职责划分

本 Skill + CLI 保证宿主客户端 / 外部调度 负责
结构化字段拉取(--json-out何时触发检查(cron、对话)
写命令语义与读命令复核文档IF 条件计算与决策
金额、ID、字段口径一致触达(钉钉/飞书)与工单
references 与命令对齐批处理循环、限速、重试;可选 subagent 并行

详见 operations/hosted-automation-self-control.mdoperations/hosted-automation-monitoring-json.mdoperations/hosted-automation-optimize-index.md


维护者

  • references/core/skill-authoring.md — 规范与检查清单
  • docs/skill-guide.md — 人类导读