Skip to content

Universal SEO skill for Claude Code. 26 sub-skills + 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.

Merge branch 'v240/matomo' into release/v2.4.0

Agrici Danielca91aec13f43
diff --cc .claude-plugin/marketplace.json
index 4e43a40,46465df..892393f
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@@ -5,7 -5,7 +5,7 @@@
"name": "AgriciDaniel"
},
"metadata": {
- "description": "Comprehensive SEO analysis plugin for Claude Code. 25 sub-skills and 18 sub-agents, plus 8 optional MCP extensions (DataForSEO, Firecrawl, Banana, Ahrefs, SE Ranking, Profound, Bing Webmaster, Unlighthouse). v2.3.1 runs the judgment-heavy agents on Opus, adds a free Keywords Everywhere backlinks fallback, surfaces setup failures with their own output, and makes every extension installer write ~/.claude.json atomically."
- "description": "Comprehensive SEO analysis plugin for Claude Code. 25 sub-skills and 18 sub-agents, plus 9 optional MCP extensions (DataForSEO, Firecrawl, Banana, Ahrefs, SE Ranking, Profound, Bing Webmaster, Matomo, Unlighthouse). v2.3.0 adds a local-target allowlist and proxy validation to the SSRF guard, refreshes Google guidance through September 2026, hardens the JSON-LD hook, fixes AI crawler guidance, and raises audit agent turn budgets."
++ "description": "Comprehensive SEO analysis plugin for Claude Code. 25 sub-skills and 18 sub-agents, plus 9 optional MCP extensions (Matomo, DataForSEO, Firecrawl, Banana, Ahrefs, SE Ranking, Profound, Bing Webmaster, Unlighthouse). v2.3.1 runs the judgment-heavy agents on Opus, adds a free Keywords Everywhere backlinks fallback, surfaces setup failures with their own output, and makes every extension installer write ~/.claude.json atomically."
},
"plugins": [
{
diff --cc CHANGELOG.md
index bf95064,aa5dc54..01aa3f9
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@@ -7,26 -7,25 +7,41 @@@ and this project adheres to [Semantic V
## [Unreleased]
- ## [2.3.1] - 2026-09-10
-
### Added
+- Keywords Everywhere (Open PageRank) as an optional, free-signup backlinks
+ fallback source: a single 0-10 domain rank metric used for the Profile
+ Overview section when Moz isn't configured. Wired through
+ `backlinks_auth.py` (new `keywordseverywhere` service) and a new
+ `keywordseverywhere_api.py` client, following the existing Moz/Bing auth
+ and source patterns. The outbound call goes through the shared
+ `url_safety.safe_requests_get` DNS-pinned helper, domains are normalized
+ and SSRF-checked before use, and requests are capped at 100 domains per
+ call. `keywordseverywhere_api.py` is registered in `runtime.py`'s
+ `ALLOWED_CORE_SCRIPTS` (a script invoked from a SKILL.md but missing from
+ that allowlist is refused by `claude-seo run`; a new test in
+ `tests/test_runtime.py` guards against that class of bug for every
+ script every SKILL.md/agent invokes). The live API path is unverified:
+ landing this required no Keywords Everywhere account, and none was
+ available to exercise the real endpoint end to end (#262).
+ - New optional Matomo extension (`extensions/matomo/`) for self-hosted or
+ Matomo Cloud analytics. Adds `/seo matomo organic | top-pages | device
+ | country | referrers | keywords` as a GA4 alternative or complement.
+ The audit orchestrator spawns a new `seo-matomo` agent when
+ `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run matomo_auth.py --check`
+ succeeds, writing `findings/matomo.md` alongside the existing specialists.
+ Response parsing is verified live against Matomo 5, including array-shaped
+ DataTables, count-based bounce fields, `Referrers.getReferrerType` naming,
+ and locale-independent anonymized-keyword detection via the row `segment`
+ field. Credentials live in `~/.config/claude-seo/matomo.json` (0600, written
+ atomically), with the `MATOMO_URL` / `MATOMO_API_TOKEN` / `MATOMO_SITE_ID`
+ environment variables still taking precedence. Every request to the instance
+ goes through `url_safety`'s DNS-pinned helpers; a self-hosted instance on a
+ private address is reached by naming it in `CLAUDE_SEO_LOCAL_TARGETS`, which
+ both installers print at install time, and a redirect away from the instance
+ is refused rather than followed. (#275)
+
+
### Changed
- The five judgment-heavy agents (`seo-content`, `seo-geo`, `seo-sxo`, `seo-cluster`,
diff --cc scripts/runtime.py
index 6d1b011,dc25f32..f58a176
--- a/scripts/runtime.py
+++ b/scripts/runtime.py
@@@ -39,9 -39,8 +39,9 @@@ ALLOWED_CORE_SCRIPTS = frozenset
"ga4_report.py", "gbp_deprecation_lint.py", "google_auth.py",
"google_report.py", "gsc_inspect.py", "gsc_query.py", "indexing_notify.py",
"indexnow_submit.py", "iptc_ai_label.py", "keyword_planner.py",
- "lcp_subparts.py", "matomo_auth.py", "matomo_report.py", "moz_api.py",
- "nlp_analyze.py", "pagespeed_check.py",
+ "keywordseverywhere_api.py",
- "lcp_subparts.py", "metadata_template.py", "moz_api.py", "nlp_analyze.py",
- "pagespeed_check.py",
++ "lcp_subparts.py", "matomo_auth.py", "matomo_report.py", "metadata_template.py",
++ "moz_api.py", "nlp_analyze.py", "pagespeed_check.py",
"parasite_risk.py", "parse_html.py", "preload_check.py", "render_page.py",
"portability_check.py", "consistency_check.py",
"schema_ecommerce_validate.py", "schema_generate.py", "seo_updates.py",