← Plugin catalog
Data & Analytics

Soku

About Intelligence v0.1.0-alpha.18

AI agent for ads and creatives

Create a free account to save this plugin.

From the developer

Declared capabilities

  • Interactive
  • Read
  • Write

Not specified in the available declarations: limitations, pricing & account requirements.

Onboarding example

Install the Soku CLI, sign in, and run a read-only 30-day performance health check on my Google Ads account
Sources & dates

Developer declarations; not independently tested. Listing last checked Nov 20, 2026. Package observed Nov 20, 2026.

View package source →

Description

From the marketplace listing

Soku is the AI marketing agent for ads and creatives. This plugin brings it into your coding agent through the Soku CLI. What it can do: - Analyze performance across Google, Meta, TikTok and ChatGPT Ads, GA4 and PostHog, and explain what changed and why. - Audit accounts, find wasted spend, compare ad spend with real conversions, and build media plans. - Research competitors' ads, keywords and landing pages. - Draft and publish SEO pages, and schedule recurring marketing reports. - Prepare campaign changes for your approval; nothing goes live until you say so. One agent, every growth channel. Your accounts stay yours: Soku works on the data you already own and never asks for platform credentials. Built for marketers and agencies managing many brands.

Language: English · Automatically detected from descriptions.

What changed

Similar plugins

Finding similar plugins… Results will appear here automatically.

Browse plugins →

Keywords

Files & skills

File archives

Plugin package17 files · 113 KBBrowse files →
Skill instructions
soku7.34 KB

View saved version →

---
name: soku
description: >-
  Use when calling Soku CLI capabilities from a shell: auth, workspace
  selection, ads/GA4/PostHog data reads, typed ads writes, SEO Hosting,
  automations, Context Hub files, temporary file publishing, brand skills,
  third-party egress,
  review-gated writes, skill installation, or CLI updates.
license: MIT
---

# Soku CLI

Written against Soku CLI release 0.1.0-alpha.18. If `soku --version` reports a
newer release, run `soku changelog --since` that release before relying on
details here.

The `soku` CLI is the shell-native way for an AI agent to use Soku from your
coding agent or any terminal. It talks to Soku over `/api/cli/*`; no MCP
host is required. Treat this file as the router. Load the relevant reference
file before acting on a detailed workflow.

## Reference Router

Read only the reference files needed for the user's task:

| Task | Read |
| --- | --- |
| First-time setup, expired token, workspace selection, org/brand ambiguity | `references/auth-workspace.md` |
| Ads, GA4, or PostHog reads; raw `soku call`; command discovery | `references/data-capabilities.md` and `references/capability-flow.md` |
| Meta/Google/ChatGPT Ads writes, uploads, bulk create, review-gated approval | `references/ads-write.md` |
| SEO Hosting, automations, Context Hub files, temporary public file URLs | `references/seo-automation-files.md` |
| Third-party APIs through server-side credential injection; security rules | `references/egress-security.md` |
| Installing, updating, or removing Soku-managed local skills; finding out what an upgrade changed | `references/skills-updates.md` |

For an installed business skill such as `soku-ads-report`, read that skill too.
Business skills carry their own "Running this skill with the Soku CLI" section.

## Prerequisite: The CLI Must Be Installed

This skill only describes the `soku` command; it does not contain it. Check
first:

```bash
soku --version
```

If the command is missing, install it (Node.js 20 or newer is required) and
check again:

```bash
npm i -g @soku-ai/cli
soku --version
```

If npm says `@soku-ai/cli` is not found, report that the official package is
unavailable. Do not invent an unofficial package name.

When this skill arrived as a marketplace plugin, the CLI may also have
installed its own copy under `~/.claude/skills/soku/`,
`~/.codex/skills/soku/`, or `~/.cursor/skills/soku/`. Both copies are the same
document at possibly different versions. The copy the CLI installed is refreshed
together with the binary, so when the two disagree, prefer that one, and treat
`soku --help` and `soku changelog` as the authority over either copy.

## Default Flow

1. Check auth/workspace state:

```bash
soku auth status
soku workspace status
```

2. If auth is missing or expired, use the agent split-flow from
`references/auth-workspace.md`.

3. If the workspace is not ready, resolve and select the remote Soku brand:

```bash
soku workspace resolve <brand>
soku workspace use-brand <brand>
```

4. Pick the reference for the task. Do not infer Soku org/brand from the current
local repo directory.

5. Inspect command help before unfamiliar calls:

```bash
soku --help
soku <namespace> --help
soku <namespace> <action> --help
```

6. Run the command and parse JSON output. In non-TTY contexts, success is
`{"ok":true,"data":...}` and errors are `{"ok":false,"error":...}`.

## Non-Negotiable Rules

- **Confirm the target brand immediately before any write, and read it back
  after.** Run `soku workspace status` in the same turn as the write — not
  earlier in the session — and check the reported brand is the one the user
  named (its `source` field tells you whether saved config or a `SOKU_BRAND_ID`
  environment variable decided it, which is what you would have to change). The
  CLI keeps whatever brand was selected last, and it does not follow the brand
  the user is looking at in the web app, so a brand confirmed three turns ago
  proves nothing about this write. After the

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 8 — file references are metadata, not package contents.

Package details

Publisher declarations from the archived package. These are separate from our research and the live service's terms.

Package license
MIT
Package author
About Intelligence
Keywords
See keywords

Declared capabilities

  • Interactive
  • Read
  • Write

Package observed Nov 20, 2026.

Technical details
First seen
Sep 30, 2026 · 22:02 UTC
Last seen
Nov 20, 2026 · 06:00 UTC
Collection status
Collected

plugins_6aabc90f6f948191954d8eb418d56e91

Download plugin data (JSON)

Plugin details: served from cache. Prepared . Refreshed when plugin data changes or after 6 hours. Your account and Follow status are live.