seohead
Provides access to Google search data for demand, SERP, and traffic analysis, including keyword and search results data via DataForSEO.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
SpiderHead is a working environment for an SEO specialist and their AI agent. Analyse server logs, crawl a site, parse pages and keep the results in a project on your own machine — from the terminal, through Claude over MCP, or in a desktop window.
One core, three faces. The
spiderheadCLI, the MCP server and the desktop app share the same Rust core and the same projects.Projects, not one-off runs. Results live next to your site in a
seo/folder, so the next session starts where the last one ended.Local-first. No hosted account, no telemetry; paid providers run only with your key and your confirmation.
Status: 0.9, first public snapshot. The command line is the primary, working surface. The MCP server works through the same binary. The desktop app is early and its visuals are weak. See ROADMAP.md.
What works today
Surface | State |
| Primary and working. 250+ commands: log analysis ( |
MCP server |
|
Desktop app | Early. Log analysis opens from the launcher; the crawler UI and the agent mode are marked "coming soon". Expect rough visuals |
Not finished yet (see the roadmap): some comparison commands, content and image tools, the Cloudflare Logpush / Instant Logs importers, and a Windows build of every component.
Related MCP server: Agent SEO Engine
Install
Releases are cut by CI: a push to the release branch builds the CLI for four targets (macOS
arm64 and x86_64, Linux x86_64 and aarch64), packs .dmg, .pkg, .deb, .AppImage and
.tar.gz installers, and leaves the result as a draft GitHub Release that is published by hand.
Every asset is checksummed in SHA256SUMS; the file is Ed25519-signed only when the signing key
is configured — until then releases are unsigned. To build from source instead, use the Rust
toolchain pinned in rust-toolchain.toml:
git clone https://github.com/PavloSEO/spiderhead.git
cd spiderhead
cargo build --release
# binaries: target/release/spiderhead spiderhead-mcp spiderhead-desktop spiderhead-desktop-ctlcargo xtask dist and cargo xtask package macos|linux|windows produce profile archives and
installers (see docs/COMPONENTS.md). The desktop app has menu actions
Install command in terminal (links the bundled spiderhead into a user-writable PATH
directory) and Connect to Claude (copies the MCP config snippet; it never edits client
configuration files).
Updating
Releases are published on GitHub with a SHA256SUMS file; the macOS arm64 CLI binary is
spiderhead-<version>-aarch64-apple-darwin. Nothing contacts the network unless you run:
spiderhead update-check --consent # read the release feed, report the newest version
spiderhead update [--dry-run] [--bin-dir DIR] # verify SHA-256 and replace DIR/spiderhead (default ~/.cargo/bin)update does nothing when the installed version is current, and keeps the old binary if the
checksum or the downloaded binary's reported version does not match.
Quick start
spiderhead --help
# analyse server logs
spiderhead logs-import --help
spiderhead logs-summary --help
spiderhead logs-bots --help
# crawl a site (read-only, polite by default)
spiderhead crawl-site --helpUse it from an AI client: add the server to the client's MCP settings.
{
"mcpServers": {
"spiderhead": { "command": "spiderhead", "args": ["mcp"] }
}
}With Claude Code: claude mcp add spiderhead -- spiderhead mcp.
Project model
A project is a seo/ folder inside your site's working tree:
my-site/
seo/
project.json manifest (schema_version, site, facts); relative paths only
log.md project journal
scans/ reports/ heavy data
.gitignore keeps scans/, logs/ and *.db out of gitspiderhead init [--site URL]createsseo/in the current directory. Without--sitethe directory name is used if it looks like a host name.Autodiscovery. Like git finds
.git, the CLI, the MCP server and the desktop app walk up from the current directory to the nearestseo/project.json(aproject.jsonin the current directory also counts). An explicit--projector--directoryalways wins.project.jsoncarries aschema_version; manifests written before it existed load as version 1 and are migrated in memory.
Roadmap
Milestones and epics are in ROADMAP.md and on the milestones page. Recent changes: CHANGELOG.md.
Build and test
cargo build --release
cargo xtask ci # fmt --check, clippy -D warnings, tests, doctests
cargo xtask layers # crate layering checkSee CONTRIBUTING.md for the workspace layout and quality gates.
Contributing, security, license
CONTRIBUTING.md and the Code of Conduct.
Report vulnerabilities privately: SECURITY.md.
Cite: CITATION.cff.
MIT. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Audit, rank-track and analyze SEO for sites via an authenticated MCP server.
Run and read SEO site audits: issues, health score, fixes, rankings and logs.
Technical SEO audits: check a page or crawl a whole site, locally or hosted. Compares crawls.
Unified 15-tool SEO, SERP, clean Markdown & GEO (LLM citation Share-of-Voice) MCP server.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to perform comprehensive SEO audits on web pages, including meta tags, headings, links, images, performance, and more, via a CLI or MCP server.182MIT
- AlicenseDqualityBmaintenanceAgent-first local SEO quality, intent and opportunity engine with CLI and optional MCP server.7MIT
- AlicenseNot gradedqualityCmaintenanceProvides SEO audits, crawling, performance analysis, and deployment management for web projects via a stdio MCP server.4 npmMIT
- AlicenseNot gradedqualityDmaintenanceProvides 23 bounded MCP tools for AI agents to perform technical SEO audits, including crawl setup, page analysis, issue detection, and report exports, all while keeping data local.7MIT