Fullrun

Manage Google Ads campaigns — diagnose, optimize, and create campaigns

MIT-0 · Free to use, modify, and redistribute. No attribution required.
0 · 27 · 0 current installs · 0 all-time installs
MIT-0
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
Purpose & Capability
The skill is an instruction-only wrapper around a 'fullrun' CLI for Google Ads. Declared requirements (the fullrun binary and FULLRUN_API_KEY) align with the described functionality of diagnosing and acting on ad accounts.
Instruction Scope
SKILL.md only instructs the agent to install/use the fullrun CLI, set the FULLRUN_API_KEY, and run specific fullrun commands (triage, campaigns:list, performance, run). All referenced actions are within the domain of managing Google Ads and do not request unrelated files, system paths, or extra environment variables.
Install Mechanism
There is no install spec in the registry (instruction-only skill). SKILL.md recommends 'npm install -g fullrun' which would pull code from the npm ecosystem — this is expected but means you should verify the npm package (publisher, version, code) before installing globally. No obscure download URLs are suggested.
Credentials
Only one env var is required (FULLRUN_API_KEY), which is proportionate and expected for a third‑party CLI that authenticates to its service. The instructions do not access other credentials or unrelated environment variables.
Persistence & Privilege
The skill is not forced-always, is user-invocable, and does not request to modify other skills or system-wide configs. Autonomous invocation is allowed by platform default but there are no additional elevated privileges requested by the skill itself.
Assessment
This skill appears coherent, but exercise normal caution before installing and granting credentials: 1) Verify the 'fullrun' npm package and its publisher (review package page, maintainers, and recent versions) before running npm install -g. 2) Prefer creating a least-privilege API key scoped only to the Ads account or actions required; do not reuse your Google account credentials. 3) Test on a non-production or sandbox Ads account first, since 'fullrun run' can make automated changes. 4) Monitor changes and logs after first runs and revoke the API key if behavior is unexpected.

Like a lobster shell, security has layers — review code before you run it.

Current versionv0.1.0
Download zip
latestvk97f90gtrzqpktg8eza0wcnj8s82z2y5

License

MIT-0
Free to use, modify, and redistribute. No attribution required.

Runtime requirements

Binsfullrun
EnvFULLRUN_API_KEY

SKILL.md

Fullrun — Google Ads Management for AI Agents

Manage Google Ads campaigns using the fullrun CLI. All commands return JSON by default.

Setup

npm install -g fullrun
fullrun login <YOUR_API_KEY>

Or set env: export FULLRUN_API_KEY=frun_...

Workflow

Always start with triage to understand account health:

  1. fullrun triage — see prioritized issues (CRITICAL > HIGH > MEDIUM > LOW)
  2. Fix the highest-priority issues using fullrun run
  3. fullrun triage — confirm issues resolved

Commands

Diagnose

  • fullrun triage — Account health report with prioritized issues
  • fullrun campaigns:list — All campaigns with status, budget, and metrics
  • fullrun performance --days 7 — Account metrics: clicks, impressions, conversions, CPA
  • fullrun keywords:list --campaign <id> — Keywords with performance data

Act

  • fullrun run — Trigger a full AI-powered optimization run. The agent triages the account and fixes the highest-priority issues automatically. Rate limited to 1 per hour.

Options

  • --format human — Readable output instead of JSON
  • --days <n> — Look-back period for performance data (default 7, max 90)
  • --campaign <id> — Filter keywords by campaign

Output

All commands return structured JSON by default for easy parsing by AI agents.

Exit codes:

  • 0 — Success
  • 1 — Error (check the error field in JSON output)
  • 2 — Guardrail blocked (the action was prevented to protect the ad account)

Rules

  • Always run fullrun triage before taking action
  • The fullrun run command is rate-limited to 1 per hour
  • Respect guardrail errors (exit code 2) — they protect the ad account from harmful changes
  • Never call fullrun run repeatedly — check triage first to see if action is needed
  • Don't increase daily budget more than 20% in one action
  • Don't pause campaigns without checking conversion data first

Files

1 total
Select a file
Select a file to preview.

Comments

Loading comments…