English Français العربية

io.github.tuckerschreiber/fullrun

السجل الرسمي التسويق والمبيعات

Google Ads management for AI agents — diagnose, optimize, and manage campaigns.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @fullrun/mcp
Claude Code 
claude mcp add fullrun -e 'FULLRUN_API_KEY=<your fullrun_api_key>' -- npx -y @fullrun/mcp@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "fullrun": {
            "command": "npx",
            "args": [
                "-y",
                "@fullrun/mcp@0.1.1"
            ],
            "env": {
                "FULLRUN_API_KEY": "<your fullrun_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • FULLRUN_API_KEY إلزامي سري Your Fullrun API key for authenticating with the Fullrun API

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Commands
  2. Agent integration
  3. Getting an API key
  4. How it works
  5. Development
  6. License

Google Ads management CLI for AI agents.

Works with OpenClaw, Claude, and any agent that can run shell commands.

Fullrun 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.

This 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.

npm install -g fullrun
fullrun login frun_YOUR_API_KEY
fullrun triage
What an agent can do
  1. Diagnose — Run fullrun triage to get a prioritized health report (CRITICAL → HIGH → MEDIUM → LOW)
  2. Inspect — List campaigns, keywords, and performance metrics
  3. Optimize — Trigger fullrun run to let the AI agent fix the highest-priority issues
  4. Repeat — Triage again to confirm the fixes worked

All 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.

Commands

CommandDescription
fullrun login <key>Authenticate with your API key
fullrun triageAccount health report with prioritized issues
fullrun campaigns:listList campaigns with status, budget, and metrics
fullrun performanceAccount metrics — clicks, conversions, CPA
fullrun keywords:listKeywords with performance data
fullrun runTrigger a full AI-powered optimization run
Options
  • --format json — Force JSON output (default when piped)
  • --format human — Force colored terminal output (default in TTY)
  • --days <n> — Look-back period for performance data (default 7, max 90)
  • --campaign <id> — Filter keywords by campaign

Agent integration

OpenClaw

Install the CLI globally and OpenClaw auto-discovers it via the bundled SKILL.md:

npm install -g fullrun

Then tell your agent: "Check my Google Ads and fix anything that's underperforming."

Claude Code

The SKILL.md works as a Claude Code skill. The agent reads it and knows how to use every command.

MCP (Claude Desktop / Cursor)
{
  "mcpServers": {
    "fullrun": {
      "command": "npx",
      "args": ["@fullrun/mcp"],
      "env": {
        "FULLRUN_API_KEY": "frun_..."
      }
    }
  }
}
Any agent

Any agent that can execute shell commands can use Fullrun. Output is auto-detected — JSON when piped, human-readable in a terminal.

Getting an API key

  1. Sign up at fullrun.app
  2. Connect your Google Ads account
  3. Go to Settings > API Keys
  4. Create a key and copy it

How it works

CLI / MCP / Agent
      │
      ▼
  Fullrun API (api key auth)
      │
      ▼
  Triage engine → Google Ads API
  Guardrails, bid caps, PPC rules

The 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.

Development

git clone https://github.com/tuckerschreiber/fullrun-cli
cd fullrun-cli
npm install
npx tsx src/bin/fullrun.ts --help

License

MIT

الأسئلة الشائعة

ما هو io.github.tuckerschreiber/fullrun؟

Google Ads management for AI agents — diagnose, optimize, and manage campaigns.

كيف أثبّت io.github.tuckerschreiber/fullrun؟

يعمل على جهازك. في Claude Code: claude mcp add fullrun -e 'FULLRUN_API_KEY=<your fullrun_api_key>' -- npx -y @fullrun/mcp@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.tuckerschreiber/fullrun إلى مفتاح API؟

نعم. يتطلب FULLRUN_API_KEY، وتضبطها في إعداداته.

هل io.github.tuckerschreiber/fullrun مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.tuckerschreiber/fullrun؟

ينشره tuckerschreiber. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.