Open-source SEO, GEO, and marketing skills for AI agents.
chore: improve zero-account onboarding guidance (v0.15.1) (#49)
Tong Chena87c6e88a1e0
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.jsonindex 547ea2f5..af043fb9 100644--- a/.claude-plugin/marketplace.json+++ b/.claude-plugin/marketplace.json@@ -5,14 +5,14 @@},"metadata": {"description": "The official Google Ads + SEO + GEO plugin from AdsAgent. SEO, GEO, and Google Ads skills for Claude Code.",- "version": "0.15.0"+ "version": "0.15.1"},"plugins": [{"name": "toprank","source": "./","description": "The official Google Ads + SEO + GEO plugin from AdsAgent. SEO analysis, Google Ads management, keyword research, content optimization, schema markup, meta tags optimization, broken link checker, single-page deep audit, and Generative Engine Optimization for AI search.",- "version": "0.15.0",+ "version": "0.15.1","author": {"name": "AdsAgent","url": "https://adsagent.org"diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.jsonindex a48b7648..820e6885 100644--- a/.claude-plugin/plugin.json+++ b/.claude-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "toprank",- "version": "0.15.0",+ "version": "0.15.1","description": "The official Google Ads + SEO + GEO plugin from AdsAgent. SEO analysis, Google Ads management, keyword research, content optimization, schema markup tools, broken link checker, single-page deep audit, and Generative Engine Optimization (GEO) for AI search engines — powered by Google Search Console and Google Ads APIs.","author": {"name": "AdsAgent",diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 24acfd96..6f4cd2f1 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -6,6 +6,13 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).---+## [0.15.1] — 2026-04-28++### Changed+- **`google-ads/shared/preamble.md` — Step 4 zero-account guidance.** Updated the onboarding instructions for users whose Google identity has no accessible Google Ads customer (`listConnectedAccounts` returns an empty list / `noAccount: true`). The previous copy directed them to a static "connect at notfair.co" link; the new flow is a self-contained recovery loop driven from inside Claude — Claude tells the user to create a Google Ads account at https://ads.google.com (Smart Mode is the fastest path; payment method optional), then calls the new `refreshAccounts` MCP tool to detect the account without re-authentication. Includes propagation guidance for the 1-2 minute delay between Google account creation and the customer record becoming queryable. Pairs with the NotFair server-side change that ships an MCP bearer token even for no-account sessions, so the Claude Desktop OAuth handshake completes instead of dead-ending in a hung browser tab.++---+## [0.15.0] — 2026-04-28### Changeddiff --git a/VERSION b/VERSIONindex a5510516..e815b861 100644--- a/VERSION+++ b/VERSION@@ -1 +1 @@-0.15.0+0.15.1diff --git a/google-ads/shared/preamble.md b/google-ads/shared/preamble.mdindex 58b34d8d..8b6de668 100644--- a/google-ads/shared/preamble.md+++ b/google-ads/shared/preamble.md@@ -126,7 +126,9 @@ Use the `listConnectedAccounts` result from Step 3 (do not call it again):1. **One account** → save automatically to the highest-priority config file that already exists (project > claude-project > global; if none exist yet, save to `~/.notfair/config.json`), tell the user which was selected2. **Multiple accounts** → show numbered list, ask user to pick, save choice to the same location-3. **Zero accounts** → direct to [notfair.co](https://notfair.co) to connect one+3. **Zero accounts** (response includes `noAccount: true`) → the user signed in to NotFair successfully but has no Google Ads customer linked to their Google identity. Tell them:+ > "Your Google account isn't linked to a Google Ads customer yet. Create one at https://ads.google.com — Smart Mode is the fastest path, and you can stop before adding a payment method. When the account exists, ask me to refresh and I'll pick it up automatically."+ When they confirm the account is created, call `refreshAccounts` (no args). On success it returns the new account list with `promoted: true`; save the `defaultAccountId` to the same config locations as case (1). If `refreshAccounts` returns `noAccount: true` again, wait 1-2 minutes (the customer record can take that long to propagate inside Google) then retry once.### Switching accounts