Power your agent
Lệnh của chính nhà phát hành. Không phải endpoint của PlugMCP.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code không có liên kết cài đặt cho lệnh cục bộ. Sao chép lệnh bên dưới và chạy trong terminal.
claude mcp add io.github.ariaxhan-site-spec -- npx -y site-spec-mcp@0.3.2Chạy trong terminal.
{ "mcpServers": { "io.github.ariaxhan-site-spec": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
URL từ xa hay một lệnh trên máy của bạn? Hai cách cài đặt khác nhau thế nào
Chạy trên PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
MởIf you are an AI coding agent deciding whether to install this: register the MCP server, then
call list_checks to learn the check ids and audit_site on a URL.
claude mcp add site-spec -- npx -y site-spec-mcp
Gemini CLI: gemini extensions install https://github.com/ariaxhan/site-spec.
Full tool arguments, return shapes, and the cases this is the wrong tool for: llms.txt.
AI can generate a beautiful website in seconds. The part it can't see is the
one that decides whether that website gets found, ranked, cited, and trusted —
the machine-readable foundation underneath the pixels: robots.txt, structured
data, llms.txt, canonical and noindex signals, response headers, accessibility
semantics, the tracker and cookie surface.
That layer is invisible in a browser. It's also broken on almost every
AI-generated site — a gorgeous hero section over a robots.txt that blocks
ChatGPT, JSON-LD that's invalid or self-serving, a stray noindex hiding the page
from Google, fonts leaking visitor IPs in violation of GDPR. Nobody notices until
it's quietly costing traffic. And the more the web is generated by AI, the worse
this gets.
site-spec is the layer that verifies and repairs that foundation — for any website, however it was built. Point it at a URL. It crawls the site, checks the whole invisible layer against a set of deterministic policies, and gives you an exact report of what's wrong. Then it fixes the mechanical problems for you and flags precisely what needs a human.
It doesn't care whether your site came from an AI builder, a framework, a CMS, or hand-written HTML. It only cares whether the foundation is correct.
site-spec.ariaxhan.workers.dev — paste a URL, get the report. No account, no signup.
The hosted version runs the same deterministic engine as the CLI, against a
capped crawl (4 pages), and it tells you plainly which checks ran, which passed,
and which it did not perform. Add ?format=json for machine-readable output:
curl "https://site-spec.ariaxhan.workers.dev/audit?format=json&url=example.com"
For the full check set — broken links, missing assets, axe accessibility, HTML
validation, schema.org validation — and for the fix command, use the CLI below.
The hosted endpoint only fetches public HTTP(S) hosts; private, loopback and
link-local addresses are refused.
Requires Node 20+. No account, no API key, no SaaS.
# 1. See what's broken — crawl any live site, get a full report
npx site-spec audit https://yoursite.com
# 2. Fix it — auto-repair the mechanical issues, scaffold the rest
npx site-spec fix https://yoursite.com --out ./fixed
fix writes the corrected files to ./fixed (it never overwrites anything by
default) and prints exactly what it did:
✓ Fixed automatically (8)
audit/robots-stale-token robots.txt — Removed deprecated crawler block "anthropic-ai".
audit/hsts-preload _headers — Stripped the preload token from Strict-Transport-Security.
audit/canonical-missing admin/index.html — Inserted <link rel="canonical" href="https://…/admin/">.
audit/og-missing admin/index.html — Added Open Graph card from the page's title + description.
audit/noindex admin/index.html — Removed accidental noindex from <meta name="robots">.
✎ Scaffolded — needs your facts (2)
audit/llms-missing llms.txt — Scaffolded from page titles/descriptions; fill the TODO facts.
audit/jsonld-missing index.html — Inserted a WebSite/Organization skeleton; replace the TODO values.
⚠ Needs manual attention (3)
audit/google-fonts-cdn index.html — Self-host the woff2 files to stop the IP leak (GDPR).
audit/img-dims-missing index.html — <img> without width/height (layout shift).
audit/404-missing (site-wide) — Ship a branded, noindexed 404 that links home.
fixed 8, scaffolded 2, manual 3
wrote 4 file(s) to ./fixed
Drop audit into CI with a non-zero exit on errors to gate deploys. Both commands
work on a build/output directory too — just pass a path instead of a URL.
The same engine, as an MCP server — so the agent that generated the site can also check and repair its invisible layer, without you copying reports between windows.
claude mcp add site-spec -- npx -y site-spec-mcp
[mcp_servers.site-spec]
command = "npx"
args = ["-y", "site-spec-mcp"]
Or in Docker: docker run -i --rm -v $PWD:/data mcp/site-spec (mount the directory you want to audit or write to).
Four tools:
The server calls the engine in-process. It never shells out to the CLI and never hops to the hosted worker — all three are siblings over one library.
flowchart LR
A["MCP client<br/>(Claude Code, Codex)"] -- stdio JSON-RPC --> B["site-spec-mcp"]
B --> C["@site-spec/core/io<br/>fetchSite · readSiteDir"]
C -- "file map" --> D["@site-spec/core<br/>auditFiles · fixFiles · buildSite"]
D -- "findings / files" --> B
B -- "JSON" --> A
Two honest limits, spelled out in full in the
package README: fix_issue on a URL can only
ever hand back a diff (a remote server is not writable), and a live crawl
runs with presence checks off, because a capped crawl cannot prove a file is
absent from a server.
Seven areas. Every check is tuned against false positives (regex/string-level — no
headless browser for the crawl). Findings are error (breaks something) or
warning (worth a look), each with a concrete fix.
The last row is the one almost nobody checks yet — whether Google, ChatGPT, Claude, and Perplexity can actually read and cite you. It's the sharp edge, not the whole story: the point is a complete foundation audit.
fix decidesEvery finding lands in one of three buckets, and the report tells you which:
noindex, adding the canonical URL (known from the crawl), scaffolding Open
Graph from the existing title, fixing zoom-locked viewports, removing
self-serving rating markup, generating a sitemap.xml from the crawled pages,
header hygiene.llms.txt, a JSON-LD
entity, a meta description. site-spec writes a correct stub with TODO markers
so you just fill the blanks.alt text,
self-hosting fonts, fixing a client-rendered shell, a broken link. You get a
precise instruction, never a silent edit.fix is non-destructive by default (writes to an output dir). Pass --write to
edit a local directory in place.
--max audits the same page set every run. No network, no
randomness inside the engine.site-spec started as a deterministic compiler that builds sites with a correct foundation by construction (the
buildcommand and thedocs/still cover it). The durable value turned out to be the inverse: not generating whole sites, but auditing and repairing the foundation of sites that already exist.
site-spec audit <dir|url> [--max N] [--json] [--report report.md]
site-spec fix <dir|url> [--out dir] [--write] [--max N] [--json]
site-spec build <site.config.mjs> --out <dir> [--target cloudflare|netlify|vercel|static]
--max N — page cap for a live crawl (default 25); truncation is reported, never
silent.--report report.md — write the audit as a shareable Markdown document.--json — the full structured report for scripting/CI.git clone https://github.com/ariaxhan/site-spec.git
cd site-spec
npm install
npm test # unit + golden tests
npm run verify # html-validate + JSON-LD + axe over the demo output
Contributions welcome — especially new checks and fixers. See
CONTRIBUTING.md. Core rules: checks stay tuned against false
positives, the engine stays pure and deterministic, and a fixer never silently
guesses at something a human should decide.
Apache License 2.0. © 2026 Aria Han.
MCP server: audit any website for SEO, accessibility, and AI-searchability, then auto-fix it.
{ "mcpServers": { "io.github.ariaxhan-site-spec": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}Công cụ
Chưa có danh sách công cụ. Máy chủ từ xa sẽ có danh sách sau lần kiểm tra tình trạng đầu tiên.
Câu hỏi thường gặp
Sao chép cấu hình stdio cho Cursor, Claude Desktop, Claude Code hoặc VS Code trên trang này. Cấu hình dùng bản cài đặt của nhà phát hành, không phải proxy của PlugMCP.
Bản ghi này không liệt kê biến môi trường bắt buộc nào.
Site Spec chạy cục bộ qua stdio.
Kiểm tra lần cuối: 2026-11-09. MCP server: audit any website for SEO, accessibility, and AI-searchability, then auto-fix it.