SEO MCP

Rust MCP server forSEO evidenceused by Grok Build and Claude Code: on-page audit, robots/sitemap, polite crawl, PageSpeed Insights, Google Search Console, optional paid SERP.

cargo build --release install -Dm755 target/release/seo ~/.local/bin/seo install -Dm755 target/release/mcp-server-seo ~/.local/bin/mcp-servers/mcp-server-seo

Cron / SeoAuditBot usesseo. Agents keep usingmcp-server-seo.

Optional:~/.config/mcp-server-seo/config.toml(seeconfig.example.toml).

mkdir -p ~/.config/mcp-server-seo cp config.example.toml ~/.config/mcp-server-seo/config.toml chmod 600 ~/.config/mcp-server-seo/config.toml

Phase 1 tools work withzerokeys. GSC needs a service-account JSON; PageSpeed needs a free API key; SERP needs Serper (optional).

Recommended free-first agent playbook (v0.7)

- page_auditmode=full(+target_keyword) on home + key templates - page_texton any page whose copy you need to judge — the audit returns counts, this returns the actual sections - crawl_runwithseed_sitemap=true→internal_link_graph; ifcoverage.truncated, re-call withresume_crawl_iduntil the frontier drains, then readtrue_orphans - local_auditfor NAP/GBP/authority/reviews in one pass - authority_snapshotbefore concluding a clean page "just needs more on-page" — a deficit verdict means links, not polish - serp_fetchonceper target query (~$0.001,confirm=YES-PAY) →content_briefreads the stored SERP for PAA questions and competitor-backed H2s - rank_diagnosiswhen a specific keyword underperforms — ranks indexation vs relevance vs authority vs technical - verify_liveafter deploy, thenlog_eventso the movement has a cause attached - Next session:findings_diff(no run ids) —fixedvsnew/regressed.url_to_sourcemaps a URL to the file under[[sites]].source_root

Weekly loop (schedule from your MCP client — this server runs no daemon)

gsc_trends site=<property> refresh=true # stores today's snapshot, returns movers rank_watch action=run confirm=YES-PAY # re-checks tracked queries

Readmovers_up/movers_downnext to theeventsyou logged.

keyword_research seed=<service> geo=<city> mode=all keyword_volumes keywords=[...] confirm=YES-PAY # one call, cached 90 days serp_fetch <top terms> confirm=YES-PAY # unlocks difficulty + SERP clustering keyword_research ... # now returns a ranked shortlist url_architecture_plan / content_brief # human approval before publish

Content publish stays in the CMS — this server isevidence + briefs, not a writer.

- SSRF:public http(s) only; private/reserved IPv4+IPv6 blocked; redirect hops re-checked
- sitemap_build:writes only understorage.data_dir(relativeout_path)
- GSC submit:confirm=YES-SUBMIT(sitemaps API — not URL Inspection)
- Paid SERP:dry_run=truedefault;confirm=YES-PAY+ budget ledger
- Paid authority(backlink_overview): same gate, separate[authority]budget ledger; dry run makeszeroprovider calls and the ledger records the provider's actual reported cost
- Static HTML:rendered: false— useagent-browserfor JS

Verify before trusting the numbers:your SERP provider's credit cost fornum > 10(serp.num_100_multiplier), the DataForSEOkeywords.location_codefor your country, and current Places API field pricing. All three are config values, not hardcoded.

Use sibling MCPs:google-analytics,google-adwords,cloudflare,namecheap,agent-browser.

Already registered asseoin Grok Build / Claude Code (restart clients after rebuild).

cargo test --release ./tests/test-stdio.sh

SeePLAN.md(merged Grok + Fable + Kimi + critique amendments).

src/ bin/seo.rs # CLI (doctor, tool, audit daily|weekly, mail) bin/mcp_server_seo.rs server/ # thin MCP tool-router only (no SEO logic) params.rs # all tool input schemas dispatch/ # named-tool router + one exec file per handler group playbooks.rs # daily/weekly audits; ok=false on step errors mod.rs # SeoServer, shared helpers, chained tool_router() handlers/ # #[tool] wrappers → run_named; one sub-router per file # (site, page, crawl, pagespeed, gsc, serp, audit, # findings, content, authority, local) tools/ # business logic per concern page/ # parse, og probe, structured data, text extraction, audit crawl/ # BFS crawl + report builder local/ # nap, citations, gbp, local_audit gsc/ # client (JWT) + ops (analytics/inspect/sitemaps) authority/ # open pagerank (free) + dataforseo (paid) adapters audit/ # composites: page, site, verify_live, rank_diagnosis source_map.rs # URL → repo file (convention presets, sandbox) serp_evidence.rs# stored-SERP parser shared by briefs/keywords html_dom.rs # shared HTML extract helpers incl. main-text extraction … rules/ # pure rules (checklist, schema, patterns, intent, relevance, issue) storage/ # SQLite split by domain (crawls, snapshots, spend, authority, # keywords, gsc, rank, places, events, # findings/{persist,extract,query,family}) over one shared conn http.rs / config.rs / site.rs / util.rs

Rule:no God files — logic lives undertools//rules/;server/does not implement SEO algorithms. Shared issue builders live inrules/issue.rs.

Free MCP that drives an audit of your marketing. Your AI connects, adsOS digs through your ads, email and site, and hands back a growth plan you can run today.

Answers questions on AEO, SEO, web development and branding from the published material of GOJI, a Melbourne digital agency, with a goji.agency URL to cite on every result.

Technical SEO audits and crawl insights for AI assistants via MCP.

MCP server for SEO — run audits and site checks from your AI assistant.

Zero-config SEO and GEO checker: 21 technical-SEO and generative-engine checks for a live site.

SEO autopilot: analyze any domain for winnable queries, 45+ free SEO tools, generate & publish SEO articles. Hosted MCP at https://www.tryspook.com/api/mcp

Official MCP server for XiaoFlow AI SEO Tools and Etsy Market Intelligence

Audit web performance, accessibility, and SEO using Google Lighthouse.

Comprehensive website auditing with 8 tools: SEO analysis, security headers, Lighthouse audits, broken link detection, site comparison, technology detection, SSL analysis, and accessibility checks. Zero API keys required.