toprank  by nowork-studio

AI-driven marketing automation for SEO and Google Ads

Created 1 month ago
2,599 stars

Top 17.5% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

Toprank provides open-source Claude Code skills for automated SEO and Google Ads management. It empowers AI agents with direct access to Google Search Console and Google Ads data, enabling data-driven optimization, identification of performance bottlenecks, and automated implementation of fixes. This tool targets engineers and power users seeking to enhance AI-driven marketing strategies with precise, actionable insights and automated campaign adjustments.

How It Works

The project is a Claude Code plugin featuring modular "skills," each defined by SKILL.md. Its core innovation lies in a tool-agnostic design using category placeholders (e.g., ~~google-ads) that interface with various servers or direct APIs. This allows flexibility and graceful degradation if specific connectors are unavailable, simplifying maintenance via a self-updater.

Quick Start & Requirements

Installation via Claude Code: /plugin marketplace add nowork-studio/toprank then /plugin install toprank@nowork-studio. Manual setup involves editing ~/.claude/settings.json. Prerequisites include Claude Code and Python 3.8+. Optional integrations require a Google Ads API key (adsagent.org), Google Cloud SDK for Search Console, or CMS configuration. Setup is advertised as ~30 seconds.

Highlighted Details

  • SEO Suite: Skills for seo-analysis, content-writer (E-E-A-T), keyword-research, meta-tags-optimizer, and schema-markup-generator.
  • Google Ads Management: ads-audit for health/spend analysis, ads for campaign optimization, and ads-copy for AI-generated RSA ad copy.
  • Cross-Model Integration: gemini skill leverages Google Gemini for reviews or adversarial testing.
  • Automated Actions: Capable of rewriting meta tags, fixing headings, adding structured data, and integrating with CMS platforms.

Maintenance & Community

The project structure indicates active development with a self-updater and clear contribution guidelines. Specific maintainer details, sponsorships, or community channels (e.g., Discord/Slack) are not provided; questions are directed to GitHub issues.

Licensing & Compatibility

Released under the permissive MIT license, Toprank facilitates broad adoption and integration into commercial or closed-source projects without significant licensing restrictions.

Limitations & Caveats

Core functionality depends on the Claude Code environment. Full capabilities, especially for Google Ads/Search Console, require separate API key setup and authentication. Some skills offer degraded functionality without full connector integration.

Health Check
Last Commit

3 days ago

Responsiveness

Inactive

Pull Requests (30d)
26
Issues (30d)
6
Star History
2,135 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.