
Geo Seo Analyzer Octoboost
io.github.eugenregehrPublished by GitHub account eugenregehrv1.1.1Updated Oct 24, 2026
Analyze multiple URLs with categorized SEO / GEO checks and scored results.
Overview
Runs OctoBoost SEO and GEO/AEO audits on URLs and crawls domains for SEO-relevant pages, returning scored, structured results.
- What you can do
- Exposes the OctoBoost SEO API as MCP tools. list_analyzers returns available analyzer keys, categories and weights; scan_domain crawls a domain and returns SEO-relevant URLs; analyze runs 30+ analyzers on one or more URLs and returns an overall SEO score, per-category scores and a GEO/AEO score for AI search visibility. Results are compact and structured rather than raw HTML, and analyze emits progress notifications per URL.
- When to use it
- Useful for agent or developer workflows that need SEO and AI-visibility signals inside the reasoning loop without spending tokens on raw page content, including site audits driven from MCP clients such as Cursor or Claude Desktop. Less useful as a general SEO guide or a raw HTML scraping tool.
- Requirements
- Local stdio process, typically started with npx from the npm package octoboost-mcp-server, so Node.js is needed. Requires an OctoBoost API key supplied in the OCTOBOOST_API_KEY environment variable; a free key is available from the provider and new accounts include free credits. Network access to the OctoBoost API is required.
Installation
In SourceWeft
- Open Geo Seo Analyzer Octoboost in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
OctoBoost SEO MCP Server
Expose the OctoBoost SEO API as Model Context Protocol (MCP) tools so agents can audit websites with compact, structured results instead of fetching and parsing raw HTML.
Get your free API key at octo-boost.com. New accounts include free credits to try every tool.
What This Server Does
octoboost-mcp-server gives an MCP client three core capabilities:
- discover available analyzers with
list_analyzers - crawl a domain for relevant URLs with
scan_domain - run full audits with
analyze
It is built for agent workflows that need SEO and AI-visibility signals inside the reasoning loop without spending thousands of tokens on raw page content.
Who It's For
This server is a good fit for:
- developers building MCP-enabled products, assistants, or internal automation
- teams using MCP clients such as Cursor or Claude Desktop and wanting SEO tooling via config only
- AI agent workflows that need token-efficient site audits, progress updates, and structured outputs they can reason over
It is less useful if you want a general SEO learning guide or a raw HTML scraping tool. The main value here is compact audit output for automated workflows.
Why Use This Instead Of Raw Scraping?
Running SEO checks directly in an LLM context is expensive. OctoBoost moves the heavy lifting to the API and returns only the signals an agent needs to decide what to do next.
- Token-efficient: structured results instead of raw HTML
- LLM-friendly: scores, flags, and diagnostics instead of prose parsing
- Credit-aware: responses include credits used and credits remaining
- Predictable errors:
401for invalid or expired keys,402for exhausted credits
Quick Start
- Get an API key from octo-boost.com.
- Add the server to your MCP client config.
- Call
list_analyzersto verify the connection.
Common config locations:
- Claude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json - Cursor: Cursor MCP settings
- OpenClaw:
~/.openclaw/mcp.json
Core Workflow
Most agent flows follow this pattern:
Tools Overview
list_analyzers
Returns available analyzer keys, categories, and weights. Call this first so an agent knows what it can run.
- no input required
- current categories include
seo,accessibility,ux,performance, andgeo - weights returned reflect your personal setup (see Analysis Setup below)
scan_domain
Crawls a domain and returns SEO-relevant URLs.
analyze
Runs a full audit for one or more URLs. All 30+ analyzers run on each URL, returning an overall SEO score, per-category scores, and a GEO/AEO score for AI search visibility. URLs are processed sequentially and emit progress notifications after each one.
Cost: 3 credits per URL.
Analysis Setup
From your dashboard at octo-boost.com/dashboard, you can configure how much each analyzer contributes to the overall score. Set a weight between 0 and 5 for any of the 30+ analyzers.
- Weight 0 — the analyzer still runs but is excluded from the overall score calculation
- Weight 1–5 — higher values give an analyzer more influence over the final score
- Changes apply immediately to all future API calls made with your key
list_analyzersalways returns your current weights, so agents can adapt their reasoning to your setup
Core Web Vitals (CrUX)
Full audits include real-user performance data (LCP, CLS, INP, FCP, TTFB) from the Chrome UX Report API at the p75 percentile — the speed 75% of actual Chrome users experienced or better. Google uses these as Search ranking signals.
If no data is returned, the result includes the exact reason (e.g. insufficient traffic, URL not in Google's dataset). This is common for low-traffic sites and does not affect the overall SEO score.
GEO/AEO Output
Full audits include a geoScore alongside the technical SEO score.
This score is meant for AI-search and agent workflows. It helps answer whether a page is easy for systems like ChatGPT, Claude, Gemini, or Perplexity to understand, extract, retrieve, and cite.
Key fields include:
geoScoretechnicalAccesscontentStructureentityClarityauthoritySignalscitationLikelihoodragReadinessllmAssessmentwhyThisMattersForAgents
Project Status
Planned next:
- LLM-based prioritization and condensation for more compact output
- higher-level tools such as
get_fix_plan,summarize_top_opportunitiesandcompare_urls - better site-level workflows built on top of crawl plus analysis
- dedicated interface and API documentation
Source: README.md at commit a6a01ef
Tools
0Version history
1- v1.1.1LatestSep 16, 2026
Score
40% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Declare a license in the repository or the registry entry.
