{
  "markdown": "<p align=\"center\">\n  <img src=\"logo.svg\" alt=\"Fullrun\" width=\"400\" />\n</p>\n\n<p align=\"center\">\n  Google Ads management CLI for AI agents.<br/>\n  Works with <a href=\"https://openclaw.ai\">OpenClaw</a>, <a href=\"https://claude.ai/claude-code\">Claude</a>, and any agent that can run shell commands.\n</p>\n\n---\n\n[Fullrun](https://www.fullrun.app) is an AI agent that manages Google Ads for you. It monitors your campaigns around the clock, diagnoses problems, adjusts bids, adds missing ad extensions, pauses wasteful keywords, and creates new campaigns — all autonomously.\n\nThis CLI brings that same engine to your terminal. Instead of using the Fullrun dashboard, you (or your AI agent) can manage Google Ads with simple commands. Every command auto-detects your environment — colored output in a terminal, structured JSON when piped to another program.\n\n```bash\nnpm install -g fullrun\nfullrun login frun_YOUR_API_KEY\nfullrun triage\n```\n\n### What an agent can do\n\n1. **Diagnose** — Run `fullrun triage` to get a prioritized health report (CRITICAL → HIGH → MEDIUM → LOW)\n2. **Inspect** — List campaigns, keywords, and performance metrics\n3. **Optimize** — Trigger `fullrun run` to let the AI agent fix the highest-priority issues\n4. **Repeat** — Triage again to confirm the fixes worked\n\nAll the hard stuff — Google Ads API calls, bid calculations, budget guardrails, PPC best practices — happens server-side. The CLI is a thin client. No credentials stored on your machine.\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `fullrun login <key>` | Authenticate with your API key |\n| `fullrun triage` | Account health report with prioritized issues |\n| `fullrun campaigns:list` | List campaigns with status, budget, and metrics |\n| `fullrun performance` | Account metrics — clicks, conversions, CPA |\n| `fullrun keywords:list` | Keywords with performance data |\n| `fullrun run` | Trigger a full AI-powered optimization run |\n\n### Options\n\n- `--format json` — Force JSON output (default when piped)\n- `--format human` — Force colored terminal output (default in TTY)\n- `--days <n>` — Look-back period for performance data (default 7, max 90)\n- `--campaign <id>` — Filter keywords by campaign\n\n## Agent integration\n\n### OpenClaw\n\nInstall the CLI globally and OpenClaw auto-discovers it via the bundled `SKILL.md`:\n\n```bash\nnpm install -g fullrun\n```\n\nThen tell your agent: *\"Check my Google Ads and fix anything that's underperforming.\"*\n\n### Claude Code\n\nThe `SKILL.md` works as a Claude Code skill. The agent reads it and knows how to use every command.\n\n### MCP (Claude Desktop / Cursor)\n\n```json\n{\n  \"mcpServers\": {\n    \"fullrun\": {\n      \"command\": \"npx\",\n      \"args\": [\"@fullrun/mcp\"],\n      \"env\": {\n        \"FULLRUN_API_KEY\": \"frun_...\"\n      }\n    }\n  }\n}\n```\n\n### Any agent\n\nAny agent that can execute shell commands can use Fullrun. Output is auto-detected — JSON when piped, human-readable in a terminal.\n\n## Getting an API key\n\n1. Sign up at [fullrun.app](https://www.fullrun.app)\n2. Connect your Google Ads account\n3. Go to **Settings > API Keys**\n4. Create a key and copy it\n\n## How it works\n\n```\nCLI / MCP / Agent\n      │\n      ▼\n  Fullrun API (api key auth)\n      │\n      ▼\n  Triage engine → Google Ads API\n  Guardrails, bid caps, PPC rules\n```\n\nThe CLI never touches Google Ads directly. It calls the Fullrun API, which runs the same triage and optimization engine that powers the web dashboard. All guardrails (mutation limits, bid caps, budget safety) are enforced server-side.\n\n## Development\n\n```bash\ngit clone https://github.com/tuckerschreiber/fullrun-cli\ncd fullrun-cli\nnpm install\nnpx tsx src/bin/fullrun.ts --help\n```\n\n## License\n\nMIT",
  "bytes": 3674,
  "sha": "0060b67b6d83fca9c7a6a9a4cfab3e58e5549b582531080175e6c6e8b907e153",
  "repo_slug": "tuckerschreiber/fullrun-cli",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_tuckerschreiber_fullrun_6f88aa86/readme"
}