Voyage Digital
    Tools· Marketing & Campaigns

    claude-ads

    Paid media audit suite for Claude Code across twelve advertising platforms (Google, Meta, TikTok, LinkedIn, Microsoft, YouTube and more), built from skills and audit agents, read-only by default, open source.

    reviewinganalyticalexecutableOpen Source
    Source code
    Recommended: /plugin marketplace add AgriciDaniel/claude-ads, or after cloning, bash install.sh --source=local (Windows: install.ps1 -Source local). No manual copying of individual files.
    Open provider
    claude-ads

    Description

    claude-ads covers twelve advertising platforms, including Google Ads, Meta Ads, YouTube Ads, LinkedIn Ads, TikTok Ads, Microsoft Advertising, Reddit Ads, Snapchat Ads, X Ads, Apple Ads, Amazon Ads, and Pinterest Ads. Commands such as /ads audit, /ads plan, /ads create, /ads monitor, and /ads report produce source-based audits, campaign and budget plans, text, image, and video creatives, and versioned reports in Markdown, HTML, and optionally PDF. The system is read-only by default; live changes to the account stay disabled until approval, idempotency, verification, logging, and rollback have been cleared for the specific platform and operation.

    A central coordinator bundles scope, policies, and the final artifacts, while individual worker agents analyze limited slices and return structured findings. If a required worker is missing, the run is marked incomplete rather than silently presented as a full audit. According to the project, credentials belong exclusively in environment variables or a secret manager, never in the repository, profiles, or reports.

    For Voyage Digital, claude-ads is a possible addition for paid media audits across multiple platforms, particularly where a structured, source-based process is preferred over a manual platform-by-platform review.

    Strengths

    Separate scoring axes
    Health, evidence coverage, regulatory exposure, and opportunities are reported separately instead of being merged into a single score.
    Honestly flagged incomplete runs
    If a required worker is missing, the run is marked incomplete rather than silently presented as a complete audit.
    Six-step approval gate for account changes
    Applying a change needs a tested capability, explicit IDs, a before/after diff with blast radius, owner approval, an idempotency key with rollback, and a final state verification.
    Consistent structure across platforms
    Each of the twelve advertising platforms gets its own skill, audit worker, control reference, and capability declaration, built to the same pattern.
    One rule set, several hosts
    Claude Code is the intended runtime, and according to the project the same skill files can also run under Codex, Gemini, Cursor, Windsurf, and Goose where the host supports it.

    Assessment

    AI features

    • Audit with dated evidence Evaluates ad accounts and returns findings with a date and explicit confidence instead of a blanket assessment.
    • Campaign and budget planning Plans channels, budgets, measurement, and experiments for paid media campaigns.
    • Creative briefs and assets Produces briefs and assets for copy, image, video, and product photos.
    • Ongoing monitoring Tracks pacing, delivery, tracking, ad fatigue, policy compliance, and performance.
    • Versioned reports The canonical result is validated JSON, from which Markdown, HTML, and optionally PDF are rendered.
    • Drafted account changes Drafts safe changes to ad accounts but does not apply them by default.

    Suitable for

    • Agencies and inhouse performance teams who want to audit ad accounts consistently across multiple platforms
    • Teams who want to produce campaign creatives in text, image, and video from skills in a structured way rather than manually
    • People who need an explicit approval and rollback process before any account change
    • Less suitable for Less suitable for immediate, automated live optimization without human sign-off; the system is deliberately conservative

    Limitations and notes

    • No live writes without the full approval chain Without a tested capability, explicit IDs, a diff, approval, an idempotency key, and verification, every change stays blocked; missing ceilings always mean no write.
    • Permanent deletion not supported According to the project, permanently deleting objects is not supported in v2.
    • Extra system dependencies for browser and PDF Screen capture requires an operator-installed Playwright browser payload, PDF output requires the system libraries WeasyPrint and Pango.
    • Limited Python support The managed dependencies are built for CPython 3.11 and 3.12 on the documented Linux, macOS, and Windows wheel matrix; other interpreters are rejected before any change is made.
    • Two distribution paths with different access The public version at AgriciDaniel/claude-ads is free under the MIT license, a community mirror with earlier access runs through the paid AI Marketing Hub Pro membership.

    Quick start

    1. Install via the native plugin flow: /plugin marketplace add AgriciDaniel/claude-ads, then /plugin install claude-ads@ai-marketing-hub-claude-ads.
    2. Alternatively clone locally with git clone https://github.com/AgriciDaniel/claude-ads.git and run bash install.sh --source=local, on Windows .\install.ps1 -Source local.
    3. Store credentials for the desired advertising platforms in environment variables, an OS keychain, or an approved secret manager, not in the repository.
    4. For screen capture, install a Playwright browser payload; for PDF export, provide the system libraries WeasyPrint and Pango.
    5. Start a first audit via the platform-specific command, for example /ads google on a standalone install or /claude-ads:ads google as a Claude Code plugin.

    Tips

    • Before every run, check that credentials sit in environment variables or a secret manager and not in the repository or in reports.
    • On a run flagged as incomplete, check which worker failed before passing the finding along as a complete audit.
    • Keep an eye on evidence coverage in the report; values below 60 percent count as insufficient evidence, 60 to 79 percent only as provisional.
    • For a skill-only install without managed dependencies, run the installer with --no-deps or -NoDeps.
    • Before removing the tool, use bash uninstall.sh --target=claude or uninstall.ps1 so only the manifest-owned files get deleted.

    Access

    claude-ads is open source under the MIT license for its own code and available free of charge on GitHub at https://github.com/AgriciDaniel/claude-ads; third-party APIs and brands remain subject to their own terms. According to the README, the recommended path is the plugin marketplace (/plugin marketplace add AgriciDaniel/claude-ads), or, after cloning, the bundled installation script (bash install.sh --source=local, on Windows install.ps1 -Source local). The project explicitly advises against manually copying individual files into ~/.claude/.

    Last reviewed: · Pricing, plans and features are a snapshot in time. Check the provider's own page before deciding.

    In the workshop this becomes your method.

    Whoever sees this process run once wants the agent behind it next. We build that in the workshop From Process to Agent.

    View workshops

    Related resources

    Browse all resources
    CO
    Tools

    conversion-copywriting

    conversion-copywriting packages Harry Dry's publicly documented Marketing Examples playbook on page structure and copy craft for higher conversion.

    Learn more
    MA
    Tools

    marketingskills

    Open collection of 47 AI agent skills for technical marketing: copywriting, conversion optimization, SEO, paid ads, pricing and revenue operations, open source.

    Learn more
    Assistants

    The Ad Copy Writer

    The Ad Copy Writer analyzes an existing ad text for Google Ads, Meta Ads or LinkedIn and returns three to five optimized, platform-compliant variants, each with a rationale for the change.

    Learn more
    BooSend
    Tools

    BooSend

    AI agents for Instagram direct messages that recognize buying intent, carry out multi-step sales conversations, and automatically sync leads with a connected CRM.

    Learn more
    Brevo
    Tools

    Brevo

    Brevo is an all-in-one platform for email marketing, transactional email and CRM that bills by sending volume rather than contact count.

    Learn more
    Inro
    Tools

    Inro

    AI-powered automation platform for Instagram direct messages that turns comments, Story interactions, and DMs into sales and support conversations through an AI agent, multi-step DM campaigns, and a shared inbox with CRM.

    Learn more
    Manychat
    Tools

    Manychat

    Chat marketing automation platform with a no-code flow builder for Instagram, WhatsApp, TikTok, and Facebook Messenger, from comment triggers to email and phone number lead capture.

    Learn more
    Google Search Console
    Tools

    Google Search Console

    Google's free diagnostic tool for tracking search performance, managing sitemaps, and diagnosing indexing issues to monitor a website's visibility in Google Search.

    Learn more
    Skills

    The Persona Grid

    The Persona Grid turns your customer segments into two to three fully developed buyer personas, each complete with goals, pain points and a concrete messaging recommendation.

    Learn more
    Workflows

    The Contract Risk Chain

    An automation workflow that reads new contracts on arrival, extracts key terms, and files a structured high, medium and low risk assessment for the responsible team to review.

    Learn more

    Conversation, not pitch

    Understand first, then decide. We take time for an initial conversation, without sales pressure, without obligation.

    Schedule a call