← Files Google Ads | LoomaScaleARCHIVED FILE

README.md

8.38 KB · Nov 19, 2026 · 06:09 UTC

↓ Download file

See the change to this file →

# Google Ads by LoomaScale

`loomascale` is an agent plugin that connects Claude Code, Codex and Grok Build to your Google Ads, Meta Ads, LinkedIn Ads, Google Analytics 4, Google Tag Manager, Google Search Console and Google Merchant Center accounts through one LoomaScale MCP server.

Audit and manage Google Ads and Meta Ads, analyze marketing data, and research competitors' ads with LoomaScale.

The plugin connects your AI assistant to the LoomaScale MCP server at `https://api.loomascale.com/mcp` and
ships skills that tell the model how to use its tools safely.

## What it does

- Audit Google Ads campaigns, search terms and conversion tracking; find wasted spend and negative keywords
- Manage Google Ads Search, Shopping and Performance Max campaigns, ads, keywords, bids and budgets after approval
- Research Google Ads keyword ideas, search volume, competition and bid estimates
- Analyze competitors' public Google Ads and Meta Ads creatives, messaging, offers and disclosed landing pages with [competitor-ad-research](skills/competitor-ad-research/SKILL.md)
- Meta Ads audits, creative performance and campaign management for Facebook Ads and Instagram Ads
- Meta Pixel (Facebook Pixel) event activity, Event Match Quality and Conversions API diagnostics (read-only)
- LinkedIn Ads performance and demographics reporting
- Google Analytics 4 (GA4) traffic, conversion and funnel analysis
- Google Search Console (GSC) search analytics, URL indexing inspection, and sitemap and property management on request
- Google Merchant Center (GMC) product issues and performance reporting
- Google Tag Manager (GTM) tracking audits
- Cross-source performance analysis, attribution diagnostics and budget recommendations

## How do I get started with LoomaScale?

Use [getting-started](skills/getting-started/SKILL.md) to find practical ways
LoomaScale can help your business. The skill checks connected sources, learns your
goal and daily challenges, and runs a focused read when the target and access are
clear. You get a first insight, tailored prompts for useful daily or weekly work,
and a next step beyond the initial audit. It also suggests relevant sources you
already use that could answer questions your current connections cannot.

For example, a shop could review product issues and purchase funnel changes; a
service business could investigate enquiry trends; an agency could repeat a
client performance brief. Suggestions depend on your connected data and goals.
Getting started does not change campaigns, settings or connections, or schedule
background work.

In Codex, invoke `$getting-started`, or use the first suggested prompt. In Claude
Code or Grok Build, ask: "Help me get started with LoomaScale for my business."

## Example prompts

- "Use $getting-started to tailor a first insight, repeatable workflows and useful data connections to my business goals and daily challenges. Keep it read-only."
- "Find negative keyword opportunities in my Google Ads search terms. Explain each recommendation. Keep it read-only."
- "Draft a Google Ads Search campaign with keyword ideas and ad copy. Show the plan for approval before creating anything."
- "Research example.com's Google ads in the US and compare its messaging with the Meta ads from the competitor's official Page. Cite examples and explain any coverage limits."
- "Analyze this competitor's active Facebook and Instagram ads in the UK. Compare offers and calls to action, with source links."

## How can I analyze competitors' ads?

Use [competitor-ad-research](skills/competitor-ad-research/SKILL.md) to find advertisers
in Google Ads Transparency Center and Meta Ad Library (Facebook and Instagram).
Compare public ad creatives, messaging, offers, calls to action and disclosed landing
pages. Results include source links, dates and coverage limits. Sign in to LoomaScale;
you do not need to connect your own ad account.

Public ad records do not reveal private campaign budgets, conversions or ROAS.
Available tools and historical coverage depend on the client's current connection
and the public library. The skill includes separate guides for
[Google Ads competitor research](skills/competitor-ad-research/references/google-ads.md)
and [Meta Ads competitor research](skills/competitor-ad-research/references/meta-ads.md).

In Codex, invoke `$competitor-ad-research` with the competitor and market, or ask
the research question directly. The plugin also includes
[integration workflows](skills/loomascale/SKILL.md) for your own accounts and
[cross-source insights](skills/cross-source-insights/SKILL.md) for performance analysis.

## Install

You need a [LoomaScale](https://loomascale.com) account. Public competitor ad research
does not require an ad-account connection. Connect the relevant ad account or data
source when you want to inspect or manage your own resources.

Claude Code:

```text
/plugin marketplace add loomascale/agent-plugin
/plugin install loomascale@loomascale
```

Codex CLI:

```text
codex plugin marketplace add loomascale/agent-plugin
codex plugin add loomascale@loomascale
codex mcp login loomascale
```

Grok Build: open `/plugin`, search for **LoomaScale**, and install.

On first use, the client opens LoomaScale sign-in in your browser. Approve access there.
No API key is needed.

## Skills

| Skill | What it covers |
|---|---|
| [`getting-started`](skills/getting-started/SKILL.md) | Turn business goals and daily challenges into a first insight, repeatable workflows, tailored prompts and relevant connection suggestions. |
| [`competitor-ad-research`](skills/competitor-ad-research/SKILL.md) | Analyze competitors' public Google Ads and Meta Ads creatives, messaging, offers, calls to action and disclosed landing pages, with source links and coverage limits. |
| `cross-source-insights` | Explain marketing performance using relevant connected Google Ads, Meta Ads (Facebook Ads and Instagram Ads), LinkedIn Ads, Google Analytics 4 (GA4), Google Tag Manager (GTM), Google Search Console (GSC) and Google Merchant Center (GMC) evidence. |
| `loomascale` | Work with connected LoomaScale integrations for Google Ads, Meta Ads (Facebook Ads and Instagram Ads), LinkedIn Ads, Google Analytics 4 (GA4), Google Tag Manager (GTM), Google Search Console (GSC) and Google Merchant Center (GMC). |

## Questions

### Can the model spend money without asking?

No. Every budget change, status change, activation and campaign creation is shown to you first and runs only after you confirm it. The server then checks it against the daily spend cap you set in LoomaScale. New campaigns are created paused.

### Should I install this or a single-integration plugin?

Install `loomascale` if you work across ads and analytics: it covers every integration on one connection. The single-integration plugins ([GA4](../loomascale-ga4), [GTM](../loomascale-gtm), [Search Console](../loomascale-gsc), [Merchant Center](../loomascale-gmc)) expose only that product's tools, which keeps the model focused when you need nothing else.

## Authentication and network

The plugin holds no credentials. The server uses OAuth 2.1 with PKCE and dynamic client
registration: the client finds the authorization server from the first `401`, registers
itself, opens the browser for consent, and stores the token.

Network endpoints:

- `https://api.loomascale.com/mcp`: MCP server (Streamable HTTP)
- `https://api.loomascale.com/oauth/authorize`, `/oauth/token`, `/oauth/register`: OAuth 2.1 and dynamic client registration
- `https://api.loomascale.com/.well-known/oauth-authorization-server` and `/.well-known/oauth-protected-resource`: discovery metadata
- `https://loomascale.com/oauth-consent`: sign-in and consent screen

Your Google, Meta and LinkedIn connections live in the LoomaScale dashboard, not in
this plugin. Changes run only after you approve them.

## Files

```text
.claude-plugin/plugin.json   Claude Code manifest
.grok-plugin/plugin.json     Grok Build manifest
.codex-plugin/plugin.json    Codex manifest
.mcp.json                    MCP server (Claude Code, Grok Build)
mcp.json                     MCP server (Codex)
skills/                      Agent Skills
assets/                      logo
```

Part of [LoomaScale agent plugins](https://github.com/loomascale/agent-plugin), built by
[LoomaScale](https://loomascale.com). LoomaScale is an independent product, not affiliated with or endorsed by Google, Meta or
LinkedIn. [Privacy](https://loomascale.com/privacy), [terms](https://loomascale.com/terms),
[contact](https://loomascale.com/contact). MIT licensed.

SHA-256: c7d662c0ab55d2627b2585c4b068b4b9e2590148dd455da78d1c6ef912041676