Skip to content
Back to search

ranksto-seo-audit

MarketplaceWorks with Claude CodeGitHub

Free Claude skill for a full SEO audit from your own Google Search Console + GA4 data. Finds indexation issues, decaying pages, low-CTR keywords, striking-distance wins, keyword cannibalization, Core Web Vitals, on-page errors and AI-search traffic (ChatGPT, Perplexity, Gemini). No paid tools. By Ranksto.com

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tahirniaziseo-jpg--ranksto-seo-audit/badge.svg)](/listings/tahirniaziseo-jpg--ranksto-seo-audit)

HTML

<a href="/listings/tahirniaziseo-jpg--ranksto-seo-audit"><img src="/api/listings/tahirniaziseo-jpg--ranksto-seo-audit/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code: as a plugin

/plugin marketplace add tahirniaziseo-jpg/ranksto-seo-audit
/plugin install ranksto-seo-audit@ranksto-seo-audit

Claude Code: as a personal skill

git clone https://github.com/tahirniaziseo-jpg/ranksto-seo-audit.git
cp -r ranksto-seo-audit/skills/free-seo-audit ~/.claude/skills/
pip install -r ranksto-seo-audit/requirements.txt

Claude.ai / Claude Desktop

Zip the `skills/free-seo-audit` folder and upload it under **Settings → Capabilities → Skills**. The API path needs a place to run Python (Claude Code or Desktop with code execution). On claude.ai, use CSV mode.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 11 lines
  1. {
  2. "name": "ranksto-seo-audit",
  3. "owner": { "name": "Tahir Niazi", "url": "https://ranksto.com" },
  4. "plugins": [
  5. {
  6. "name": "ranksto-seo-audit",
  7. "source": "./",
  8. "description": "Free SEO audit from your own Google Search Console + GA4 data. No paid connector."
  9. }
  10. ]
  11. }
README.md · README · 119 lines
  1. # Ranksto Free SEO Audit — a Claude skill
  2. **A complete SEO audit from your site's own Google data. Free forever: no paid connector, no subscription, no third-party estimates.**
  3. Ask Claude *"audit my site"* and get a prioritized report built from your real Search
  4. Console and GA4 numbers. The report covers indexation, pages losing traffic, quick wins,
  5. keyword cannibalization, Core Web Vitals, on-page issues, AI-search traffic and a 5-step
  6. action plan.
  7. Built and maintained by **[Ranksto](https://ranksto.com)**, an SEO agency for teams that want rankings without the overhead.
  8. ---
  9. ## What it checks
  10. | Area | What you get | Data source (all free) |
  11. |---|---|---|
  12. | **Indexation** | Sitemap URLs that never appear in search, inspected one by one: coverage state, canonical mismatches, noindex, robots | Search Console URL Inspection API + your sitemap |
  13. | **Traffic baseline** | Clicks, impressions, CTR and position for the last 90 days vs the previous 90 | Search Console API |
  14. | **Decaying pages** | Pages that lost more than 30% of their clicks, each with its *likely cause*: ranking drop, demand drop, CTR drop or vanished | Search Console API |
  15. | **CTR anomalies** | Queries ranking in the top 5 with CTR under 2%, plus an estimate of the clicks you're missing and rewritten titles and meta descriptions | Search Console API |
  16. | **Striking distance** | Queries at positions 8–20 with real impressions: one push from page 1 | Search Console API |
  17. | **Cannibalization** | Queries where 2+ of your pages split impressions, with a suggested primary page | Search Console API (query × page) |
  18. | **Rank movers** | Winning, losing, new and lost queries | Search Console API |
  19. | **Brand vs non-brand** | How much of your traffic is only your brand name | Search Console API |
  20. | **Revenue risk** | Landing pages losing organic sessions, key events or revenue, even when rankings hold | GA4 Data API |
  21. | **AI search** | Sessions from ChatGPT, Perplexity, Gemini, Claude, Copilot…, trend, and which pages they cite | GA4 Data API |
  22. | **AI crawler access** | Whether Googlebot, GPTBot, OAI-SearchBot, PerplexityBot, ClaudeBot and others are blocked | robots.txt |
  23. | **Core Web Vitals** | Real-user LCP / INP / CLS (CrUX) plus a Lighthouse score | PageSpeed Insights API |
  24. | **On-page** | Title and meta length, H1s, canonical, noindex, word count, schema, images missing alt | Page HTML |
  25. ## Three ways to feed it data (pick one)
  26. 1. **Google APIs (recommended):** a one-time, roughly 10-minute setup in your own free
  27. Google Cloud project. Easiest is a **service account**: a read-only "robot" user you add
  28. to Search Console and GA4. It needs no consent screen and never expires, and clients can
  29. grant it access to their sites. Signing in with OAuth also works.
  30. → [docs/SETUP.md](docs/SETUP.md)
  31. 2. **CSV export (zero setup):** export *Queries* and *Pages* from Search Console for two
  32. periods and hand Claude the files.
  33. 3. **Browser:** if Claude can use your browser (Claude in Chrome), it reads the reports
  34. straight from the Search Console and GA4 interfaces.
  35. ## Install
  36. ### Claude Code: as a plugin
  37. ```bash
  38. /plugin marketplace add tahirniaziseo-jpg/ranksto-seo-audit
  39. /plugin install ranksto-seo-audit@ranksto-seo-audit
  40. ```
  41. ### Claude Code: as a personal skill
  42. ```bash
  43. git clone https://github.com/tahirniaziseo-jpg/ranksto-seo-audit.git
  44. cp -r ranksto-seo-audit/skills/free-seo-audit ~/.claude/skills/
  45. pip install -r ranksto-seo-audit/requirements.txt
  46. ```
  47. ### Claude.ai / Claude Desktop
  48. Zip the `skills/free-seo-audit` folder and upload it under **Settings → Capabilities → Skills**.
  49. The API path needs a place to run Python (Claude Code or Desktop with code execution). On
  50. claude.ai, use CSV mode.
  51. ## Use
  52. Just ask:
  53. > Audit example.com
  54. > Why is my organic traffic down?
  55. > Find quick SEO wins for example.com
  56. Or run the scripts yourself:
  57. ```bash
  58. S=skills/free-seo-audit/scripts
  59. python $S/fetch.py auth
  60. python $S/fetch.py sites
  61. python $S/fetch.py pull --site example.com --property 123456789 --days 90 --out audit-example.com
  62. python $S/fetch.py sitemap-check --site example.com --out audit-example.com
  63. python $S/analyze.py --data-dir audit-example.com --brand "example" --out audit-example.com/findings.json
  64. python $S/fetch.py psi --url https://example.com/
  65. ```
  66. The report ends with a **prioritized 5-item action list**, ordered by clicks at stake and
  67. ease of the fix. Each item names the exact page and the exact change.
  68. ## Privacy
  69. - Every Google scope is **read-only** (`webmasters.readonly`, `analytics.readonly`).
  70. - Your data goes from Google to your computer and nowhere else.
  71. - Revoke access any time at <https://myaccount.google.com/permissions>.
  72. ## Try it without your own data
  73. `examples/` contains small sample CSV exports:
  74. ```bash
  75. python skills/free-seo-audit/scripts/analyze.py \
  76. --cur-queries examples/cur_queries.csv --prev-queries examples/prev_queries.csv \
  77. --cur-pages examples/cur_pages.csv --prev-pages examples/prev_pages.csv \
  78. --out findings.json
  79. ```
  80. ## Need a hand?
  81. Want an expert to read the report and fix the issues for you? **[Ranksto](https://ranksto.com)**
  82. runs technical SEO, content and AI-search work for growing sites.
  83. → [ranksto.com](https://ranksto.com)
  84. ⭐ If this skill saved you a subscription, star the repo so others find it.
  85. ## License
  86. MIT © 2026 Tahir Niazi ([Ranksto](https://ranksto.com)). See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.