Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/nowork-studio/toprank

Open-source Claude Code skills for SEO, SEM, Google Ads
https://github.com/nowork-studio/toprank

Last synced: 28 days ago
JSON representation

Open-source Claude Code skills for SEO, SEM, Google Ads

Awesome Lists containing this project

README 

          
# Toprank



**SEO + Google Ads skills for Claude Code. Data-driven decisions, not dashboards.**



Toprank gives your AI agent direct access to Google Search Console and Google Ads. It analyzes your traffic, surfaces what's hurting your rankings, finds wasted ad spend, and tells you exactly what to fix. When you have access to the repo, it goes further: rewriting meta tags, fixing headings, adding structured data, and shipping the changes.



> *"Am I wasting money on ads right now?"*

> *"Why did my traffic drop and how do I fix it?"*

> *"How do I get more conversions without spending more?"*



Free, open-source. Install in 30 seconds.



---



## See It Work



### Google Ads



```

You:    /toprank:ads-audit



Claude: Connected to your Google Ads account (MyStore).



        3 campaigns active. $2,400 spent this month.



        Scorecard:

        โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”

        โ”‚ Dimension            โ”‚ Status   โ”‚ Summary                      โ”‚

        โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค

        โ”‚ Conversion tracking  โ”‚ OK       โ”‚ 3 actions firing correctly   โ”‚

        โ”‚ Keyword health       โ”‚ Critical โ”‚ 8 keywords burning cash      โ”‚

        โ”‚ Search term quality  โ”‚ Warning  โ”‚ 12 irrelevant queries        โ”‚

        โ”‚ Impression share     โ”‚ Warning  โ”‚ Losing 35% to rank           โ”‚

        โ”‚ Spend efficiency     โ”‚ Critical โ”‚ $340/mo wasted               โ”‚

        โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜



        Top 3 actions:

        1. Pause 3 keywords ($210/mo, zero conversions)

        2. Add 12 negative keywords ($130/mo wasted on irrelevant terms)

        3. Increase bids 15% on 2 high-converting keywords losing IS



        Business context saved โ€” /toprank:ads-copy and /toprank:ads will use it.



You:    Do it all.



        [paused 3 wasteful keywords โ€” saved $210/mo]

        [added 12 negative keywords โ€” saved $130/mo]

        [increased bids on 2 high-performers]



        Done. All changes are reversible within 7 days.

```



### SEO



```

You:    /toprank:seo-analysis



Claude: Found your site at mystore.com โ€” pulling Search Console data now.



        [90 days of real traffic data loaded]

        [pages crawled for technical issues]



        Three things hurting you most:



        Your homepage lives at two addresses. Google splits your ranking

        power between them. Easy fix.



        Two pages targeting the same search terms โ€” they compete against

        each other and neither wins.



        One page gets 400 monthly impressions but ranks #52. The title

        doesn't match what people actually search for.



        Here's your 30-day plan, most impactful first.

```



---



## Install



Toprank is a **Claude Code plugin**. One-time setup, automatic updates.



### Claude Code (recommended)



Run these two commands in Claude Code:



```

/plugin marketplace add nowork-studio/toprank

```



```

/plugin install toprank@nowork-studio

```



That's it. All skills are now available as `/toprank:*` commands.



**Google Ads (optional):** Connect your account at [adsagent.org](https://www.adsagent.org) (free API key) โ€” setup instructions are provided there.



### Manual Install



Prefer to edit settings.json directly?



Add the marketplace and enable the plugin in `~/.claude/settings.json`:



```json

{

  "extraKnownMarketplaces": {

    "nowork-studio": {

      "source": {

        "source": "github",

        "repo": "nowork-studio/toprank"

      }

    }

  },

  "enabledPlugins": {

    "toprank@nowork-studio": true

  }

}

```



---



## Skills



### Google Ads



| Skill | What it does |

|-------|-------------|

| [`ads-audit`](google-ads/ads-audit/) | Account audit + business context setup. Run this first. Scores 7 health dimensions, identifies wasted spend, builds business profile. |

| [`ads`](google-ads/ads/) | Campaign management. Read performance, optimize keywords, adjust bids/budgets, add negatives, create campaigns. |

| [`ads-copy`](google-ads/ads-copy/) | RSA copy generator + A/B testing. Data-driven headlines and descriptions with character counts and pin positions. |



### SEO



| Skill | What it does |

|-------|-------------|

| [`seo-analysis`](seo/seo-analysis/) | Full SEO audit with GSC data. Quick wins, traffic drops, technical issues, 30-day action plan. |

| [`content-writer`](seo/content-writer/) | SEO content creation following E-E-A-T guidelines. Blog posts, landing pages, content improvements. |

| [`keyword-research`](seo/keyword-research/) | Keyword discovery, intent classification, topic clusters, prioritized content calendar. |

| [`meta-tags-optimizer`](seo/meta-tags-optimizer/) | Title tags, meta descriptions, OG/Twitter cards with A/B variations and CTR estimates. |

| [`schema-markup-generator`](seo/schema-markup-generator/) | JSON-LD structured data for rich results. FAQ, HowTo, Article, Product, LocalBusiness. |

| [`setup-cms`](seo/setup-cms/) | Connect WordPress, Strapi, Contentful, or Ghost for automated SEO field audits. |



### Cross-Model



| Skill | What it does |

|-------|-------------|

| [`gemini`](gemini/) | Second opinion from Google Gemini. Review (pass/fail gate), challenge (adversarial stress test), or consult (open Q&A). Especially strong on Google Ads and SEO decisions โ€” Gemini has native Google ecosystem knowledge. |



All skills are namespaced: `/toprank:ads`, `/toprank:seo-analysis`, `/toprank:gemini`, etc.



---



## How It Works



Toprank is a Claude Code plugin. Each skill is a `SKILL.md` file with supporting reference documents, scripts, and eval tests.



```

toprank/

โ”œโ”€โ”€ .claude-plugin/

โ”‚   โ”œโ”€โ”€ plugin.json              <- plugin metadata (explicit skill paths)

โ”‚   โ””โ”€โ”€ marketplace.json         <- registry entry

โ”œโ”€โ”€ .mcp.json                    <- AdsAgent MCP server (auto-configured)

โ”œโ”€โ”€ google-ads/

โ”‚   โ”œโ”€โ”€ ads/                     <- campaign management

โ”‚   โ”œโ”€โ”€ ads-audit/               <- account audit + business context

โ”‚   โ””โ”€โ”€ ads-copy/                <- RSA copy generator + A/B testing

โ”œโ”€โ”€ seo/

โ”‚   โ”œโ”€โ”€ seo-analysis/            <- full SEO audit with GSC data

โ”‚   โ”œโ”€โ”€ content-writer/          <- E-E-A-T content creation

โ”‚   โ”œโ”€โ”€ keyword-research/        <- keyword discovery + topic clusters

โ”‚   โ”œโ”€โ”€ meta-tags-optimizer/     <- title tags, meta descriptions, OG

โ”‚   โ”œโ”€โ”€ schema-markup-generator/ <- JSON-LD structured data

โ”‚   โ”œโ”€โ”€ seo-page/                <- single-page deep analysis

โ”‚   โ””โ”€โ”€ setup-cms/               <- CMS connector

โ”œโ”€โ”€ gemini/                      <- cross-model review via Gemini CLI

โ”œโ”€โ”€ toprank-upgrade-skill/       <- self-updater

โ”œโ”€โ”€ test/                        <- unit + LLM-judge eval tests

โ””โ”€โ”€ VERSION

```



---



## Connectors



Toprank skills reference external tools using the `~~category` placeholder pattern. This makes skills tool-agnostic โ€” they work with any MCP server that provides the required capability.



| Category | Placeholder | Default Server | Alternatives |

|----------|-------------|---------------|--------------|

| Google Ads | `~~google-ads` | [AdsAgent MCP](https://www.adsagent.org) (`mcp__adsagent__*`) | Google Ads MCP (`mcp__google_ads_mcp__*`) |

| Search Console | `~~search-console` | gcloud CLI + Search Console API | Any GSC-compatible MCP server |

| CMS | `~~cms` | Direct API (WordPress REST, Strapi, Contentful, Ghost) | Any CMS MCP server |



Skills use conditional blocks based on available tools. If a connector is not available, the skill gracefully degrades โ€” for example, `seo-analysis` can still run a technical crawl without GSC data.



**Setup:**

- **Google Ads:** See `google-ads/shared/preamble.md`. Get a free API key from [adsagent.org](https://www.adsagent.org), set `ADSAGENT_API_KEY`, and the `.mcp.json` auto-configures the MCP server.

- **Search Console:** See `seo/shared/preamble.md`. Requires Google Cloud SDK, Search Console API enabled, and OAuth login.

- **CMS:** Run `/toprank:setup-cms` to configure WordPress, Strapi, Contentful, or Ghost.



---



## Contributing



Each skill lives in its own folder under a category directory:



```

seo/                      <- SEO skills go here

โ””โ”€โ”€ your-skill-name/

    โ”œโ”€โ”€ SKILL.md          <- required

    โ”œโ”€โ”€ scripts/          <- optional

    โ””โ”€โ”€ references/       <- optional



google-ads/               <- Google Ads skills go here

โ””โ”€โ”€ your-skill-name/

    โ””โ”€โ”€ SKILL.md          <- required

```



**SKILL.md** needs a frontmatter header with `name` and `description`, then step-by-step instructions in the imperative.



**Scripts:** Python 3.8+ stdlib only (or `requests`). Accept `--output` for file output. stderr for progress, stdout for data.



**Pull requests:** One skill per PR. Test your skill before submitting. Bump `VERSION` and update `CHANGELOG.md`.



Questions? Open an issue.



---



## Star History





 

   

   

   Star History Chart

 




---



## License



[MIT](LICENSE)