/ Каталог / Песочница / claude-ads
● Сообщество AgriciDaniel ⚡ Сразу

claude-ads

автор AgriciDaniel · AgriciDaniel/claude-ads

Runs 250+ paid-ads audit checks across Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, and Apple — with scoring, creative review, and PDF reports.

A Claude Code skill for paid-advertising audits and optimization. Feed it campaign exports or screenshots and it produces a weighted 0-100 Ads Health Score, platform-specific findings, creative quality review, privacy-infra verification (Consent Mode V2, CAPI, Events API), and a client-ready PDF. Parallel subagents run per-platform analyses simultaneously.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

claude-ads-skill.replay ▶ готово
0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "claude-ads-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-ads",
        "~/.claude/skills/claude-ads"
      ],
      "_inferred": true
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "claude-ads-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-ads",
        "~/.claude/skills/claude-ads"
      ],
      "_inferred": true
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "claude-ads-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-ads",
        "~/.claude/skills/claude-ads"
      ],
      "_inferred": true
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "claude-ads-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-ads",
        "~/.claude/skills/claude-ads"
      ],
      "_inferred": true
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "claude-ads-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-ads",
        "~/.claude/skills/claude-ads"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json
{
  "context_servers": {
    "claude-ads-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/AgriciDaniel/claude-ads",
          "~/.claude/skills/claude-ads"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add claude-ads-skill -- git clone https://github.com/AgriciDaniel/claude-ads ~/.claude/skills/claude-ads

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: claude-ads

Audit a Google Ads account before taking it over

👤 Agencies onboarding a new paid-search client ⏱ ~45 min intermediate

Когда использовать: You're bidding for the account and need to show concrete gaps in week one.

Предварительные требования
  • Exported account data or screenshots — Google Ads Editor export or the standard 'all campaigns' CSV
Поток
  1. Feed the skill the export
    Run the claude-ads skill on this Google Ads export. Focus on Search + PMax. Give me the health score and top 10 issues.✓ Скопировано
    → Score with breakdown by category (structure, bidding, creative, tracking)
  2. Drill into PMax specifically
    Now deep-dive PMax — asset quality, audience signals, brand-exclusion list. What's the quick-win?✓ Скопировано
    → Platform-specific findings with remediation priority
  3. Generate the PDF
    Export to a client PDF with the score dashboard on page 1 and the remediation roadmap at the end.✓ Скопировано
    → Polished PDF ready to send

Итог: A deliverable audit that wins the pitch.

Подводные камни
  • Audit based on incomplete data gives wrong conclusions — Include 90 days of performance plus settings export, not just a screenshot

Verify Meta Advantage+ privacy infrastructure before iOS 18

👤 In-house paid-social managers ⏱ ~30 min advanced

Когда использовать: Attribution is drifting and you suspect CAPI or Events API isn't firing cleanly.

Поток
  1. Run the privacy-infra check
    Use claude-ads to audit our Meta setup for CAPI completeness, event match quality, and Consent Mode V2.✓ Скопировано
    → Per-event pass/fail with remediation
  2. Get the fix plan
    Prioritize fixes by attribution-loss impact.✓ Скопировано
    → Ordered list tied to revenue impact

Итог: A concrete privacy-infrastructure punch-list.

Подводные камни
  • Matching Match Quality fixes without GTM changes — The skill flags when GTM/server-side tag config is also required

Generate 10 new ad creative variants for a failing ad set

👤 Performance marketers in creative refresh ⏱ ~30 min intermediate

Когда использовать: CPMs are climbing and your creatives are fatigued.

Поток
  1. Provide the winning ad + brief
    Here's our best-performing Meta ad. Use claude-ads creative agents to generate 10 variants that test different hooks.✓ Скопировано
    → 10 copy + visual-brief pairs, each with a stated hypothesis
  2. Score the variants
    Which 3 should we ship first based on policy safety and hypothesis strength?✓ Скопировано
    → Short list with reasoning

Итог: A creative batch with clear hypotheses to test.

Подводные камни
  • Generated copy violates platform policy — The skill's compliance check catches most issues — but have a human final-check on regulated verticals

Комбинации

Сочетайте с другими MCP — эффект x10

After creative-agents propose variants, generate image prompts for each

For each of the 10 creative variants, use Nano Banana to propose an image prompt.✓ Скопировано
claude-ads-skill + claude-seo-skill

Align paid landing pages with SEO best practices from /seo audit

Run /seo audit on the landing pages paid traffic is hitting, then cross-reference with claude-ads landing-page quality findings.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
Platform audit exported campaign data Full or partial account review 0
Ads Health Score audit results At the end of each audit 0
Privacy infrastructure check tag config or screenshots Attribution or policy review 0
Creative generation agents winning ad + brief Creative refresh 0
Financial modeling conversion rate, AOV, margin Budget planning 0

Стоимость и лимиты

Во что обходится

Квота API
None for the skill
Токенов на вызов
Full audit: 15-40k tokens; single-platform: 5-10k
Деньги
Free — skill is local; you still pay for the ad spend it's auditing
Совет
Run platform-by-platform for ongoing clients; full-account audits are best for onboarding and quarterly reviews.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: No credentials — skill reads exports you paste in. Campaign data stays on your machine.
Исходящий трафик: None from the skill itself

Устранение неполадок

Частые ошибки и исправления

Score seems too low/high for the account

Check the export completeness — missing conversion data skews the score.

Creative agents miss brand voice

Include a brand voice doc or 3 winning ads as style anchors in the prompt.

PDF export fails

The skill needs a markdown-to-PDF runtime; check the skill's setup section for the required dependency.

Альтернативы

claude-ads в сравнении

АльтернативаКогда использоватьКомпромисс
Manual audits via platform UIsYou only manage one account and have timeThorough but slow; doesn't scale
claude-seo-skillYou need organic / technical SEO instead of paidDifferent side of the acquisition funnel

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills