SuperAPI AI 工具集

soku-cli-integration

智能体与模型

查看项目

更新于 10-16 07:27

技能介绍

用途:该技能用于安装并使用 Soku CLI,为 AI 智能体提供对增长技术栈的安全、带类型命令行访问,避免在提示词中暴露 API 密钥,也无需 MCP 主机。

主要能力:跨广告平台(Google、Meta、TikTok、ChatGPT Ads)查询归一化报告;访问 GA4 与 PostHog 分析;创建和管理广告活动(需人工审批);发布 SEO 内容;创建定时自动化任务;管理工作区上下文文件。命令自文档化,返回稳定 JSON 信封,便于智能体可靠解析。所有影响投放的写入操作(如创建活动)都经人工审核关卡。

安装与使用:需 Node.js 20+ 及 npm/npx。全局安装:npm install -g @soku-ai/cli;免安装:npx @soku-ai/cli --help;验证:soku --version。认证:soku auth login(浏览器 OAuth),soku auth status,soku auth logout。工作区:soku workspace resolve <brand-name>、soku workspace use-brand <brand-name>、soku workspace status。命令结构:soku <namespace> <action> [options],命名空间包括 auth、workspace、ads、ga4、posthog、seo-hosting、automation、context、egress、review、skill。

常用示例:soku ads list-ad-accounts --platform google;soku ads query-single-dimension --platform google --account-id 123-456-7890 --dimension campaign --date-start 2026-06-01 --date-end 2026-06-30;soku ads meta campaign create ... 返回 review_id,再用 soku review show/approve/reject 处理;GA4 如 soku ga4 list-properties;PostHog 如 soku posthog query --project-id 12345 --tool execute-sql;SEO 如 soku seo-hosting pages put/publish;自动化如 soku automation create --name ... --prompt ... --cron ... --timezone ...;上下文如 soku context upload/list;技能如 soku skill install --all --global。未覆盖的能力可用 soku call <namespace> <action> -p key=value。

JSON 输出:非交互环境下命令返回 {"ok": true, "data": {...}} 或 {"ok": false, "error": {"code": ..., "message": ...}};脚本中先解析 JSON 并检查 ok 再访问 data。

环境变量:NODE_ENV、CI、NO_COLOR、SOKU_API_URL。

限制:写入操作必须经 review 审批,不可假设自动通过;部分能力依赖特定 Soku 套餐,权限不足会返回 FORBIDDEN;可能遇到 RATE_LIMIT_EXCEEDED,需在批量操作间加延迟;交互模式可能干扰 JSON 输出,建议设置 CI 或重定向 stderr。认证失败需重新 soku auth login。

其他:npm 包为 @soku-ai/cli,仓库见 github.com/About-Intelligence/soku-cli。