Máy chủ SEO MCP
This is a teaser tier, not a general public API: it has no key, no write actions, and intentionally modest fair-use limits. For a normal browser workflow, use the free tools directly.
Connect
Claude Code
claude mcp add --transport http patrickstox https://patrickstox.com/api/mcp Claude Desktop or claude.ai custom connector
{
"mcpServers": {
"patrickstox": {
"url": "https://patrickstox.com/api/mcp"
}
}
} Cursor
{
"mcp": {
"servers": {
"patrickstox": { "url": "https://patrickstox.com/api/mcp" }
}
}
} Any Streamable HTTP MCP client can use the same endpoint: https://patrickstox.com/api/mcp. The server supports the stateless 2026-07-28 protocol and retains the 2025 initialization flow for older clients.
Yêu cầu được máy chủ của chúng tôi xử lý và không được lưu sau khi xử lý. Số đếm kết quả ẩn danh theo từng lần chạy có thể được dùng cho nghiên cứu tổng hợp; URL, tên miền, IP và mã định danh không bao giờ được bao gồm, và không công bố số liệu thống kê khi có dưới 100 lần chạy.
How to use it
- Add the endpoint with the configuration for your MCP client.
- Confirm the client discovers the tools below before relying on a prompt-driven call.
- Use
search_sitefor the complete public corpus orsearch_contentfor articles only, then fetch an article by its returned slug when full text is needed. - For verification tools, supply only the documented public IP, pasted markup, or public URL and preserve the returned evidence and error state.
- Cite the canonical URL returned with published content.
Available tools
| Tool | What it does | Arguments |
|---|---|---|
search_content | Search Patrick Stox's published SEO articles and guides. Supports in:, type:, quoted-phrase, and exclusion syntax; returns title, description, canonical URL, and a markdown URL for each match. | query — Article search terms using optional shared syntax (for example: in:technical-seo "javascript seo") |
search_site | Search Patrick Stox's complete public retrieval corpus, including articles, services, tools, newsletters, talks, and site reference pages. Supports the same in:, type:, quoted-phrase, and exclusion syntax as site search. | query — Search terms, optionally scoped (for example: in:tools canonical) |
get_article | Fetch one article as clean markdown by its slug (from search_content results) — includes title, description, canonical URL, and the full text. | slug — Article slug, e.g. "javascript-seo" |
list_pillars | List the site's content pillars and clusters (taxonomy) with URLs and internal-PageRank share, from the build-time content graph. | None |
verify_bot | Verify whether a public IP claiming to be a known crawler matches published ranges and forward-confirmed reverse DNS. Returns the range snapshot date as evidence. | ip — One public IPv4 or IPv6 addressclaim — Optional crawler id, e.g. "googlebot" |
validate_schema | Validate pasted JSON-LD or HTML containing JSON-LD with the same pure schema.org, Google rich-result, and @id graph checks used by the Schema Markup Validator. | input — JSON-LD or HTML, up to 100,000 charactersmode — "jsonld" (default) or "html" |
trace_redirect_chain | Trace one public URL through bounded HTTP, Refresh-header, and short meta-refresh hops. Returns redirect-relevant evidence only, never a raw header dump. | url — Public http(s) URL to traceua — Optional user-agent profile: default, browser, googlebot, bingbot, gptbot, claudebot, or perplexitybot |
inspect_og | Inspect bounded raw HTML from one public URL for normalized Open Graph and Twitter metadata, resolved image URLs, platform fallback provenance, and share-readiness findings. Never returns the HTML or an arbitrary header dump. | url — Public http(s) URL to inspectua — Optional allowlisted user-agent profile: default, browser, facebookexternalhit (default), or googlebot |
search_content example
Arguments
{
"query": "in:technical-seo \"javascript seo\""
} Trimmed response
[
{
"slug": "javascript-seo",
"title": "JavaScript SEO",
"url": "https://patrickstox.com/technical-seo/javascript-seo/"
}
] search_site example
Arguments
{
"query": "in:tools canonical"
} Trimmed response
[
{
"title": "Canonical Tag Checker",
"kind": "tool",
"url": "https://patrickstox.com/tools/canonical-checker/"
}
] get_article example
Arguments
{
"slug": "javascript-seo"
} Trimmed response
{
"content": [
{
"type": "text",
"text": "# JavaScript SEO\n…"
}
]
} list_pillars example
Arguments
{} Trimmed response
[
{
"kind": "pillar",
"label": "Technical SEO",
"url": "https://patrickstox.com/technical-seo/",
"pagerankShare": "8.42%"
}
] verify_bot example
Arguments
{
"ip": "203.0.113.9",
"claim": "googlebot"
} Trimmed response
{
"verdict": "spoofed",
"bot": {
"id": "googlebot",
"displayName": "Googlebot"
},
"findings": [
{
"findingId": "verify-bot.range-mismatch",
"severity": "fail",
"label": "Crawler IP is outside the published range"
}
],
"evidence": {
"matchedRanges": [],
"listsFetchedAt": "2026-07-05T16:45:33.112Z"
}
} validate_schema example
Arguments
{
"input": "{\"@context\":\"https://schema.org\",\"@type\":\"Product\",\"name\":\"Example\"}"
} Trimmed response
{
"entities": [
{
"type": "Product",
"googleEligible": "does-not-meet"
}
],
"issues": [
{
"code": "google.product.offers-review-rating.missing",
"tier": "blocks"
}
]
} trace_redirect_chain example
Arguments
{
"url": "http://example.com/old"
} Trimmed response
{
"hops": 2,
"finalUrl": "https://example.com/new",
"finalStatus": 200,
"findings": [
{
"findingId": "trace-redirect.extra-hop",
"severity": "warning",
"label": "Redirect trace contains an unnecessary hop"
}
],
"chain": [
{
"status": 301,
"kind": "http"
},
{
"status": 302,
"kind": "http"
},
{
"status": 200,
"kind": "http"
}
]
} inspect_og example
Arguments
{
"url": "https://example.com/article",
"ua": "facebookexternalhit"
} Trimmed response
{
"finalUrl": "https://example.com/article",
"httpStatus": 200,
"userAgent": {
"profile": "facebookexternalhit"
},
"acquisition": {
"maxBytes": 262144,
"capturedBytes": 18420,
"truncated": false,
"complete": true
},
"metadata": {
"openGraph": {
"og:title": "Example article",
"og:image": "https://example.com/card.jpg"
},
"twitter": {}
},
"platforms": [
{
"id": "facebook",
"title": {
"value": "Example article",
"source": "og:title"
},
"image": {
"value": "https://example.com/card.jpg",
"source": "og:image"
}
}
],
"score": 97
} Search syntax
The search tools use the same retrieval syntax as the site. Use in: for a section or taxonomy, type: for a result class, quotation marks for an exact phrase, and a leading minus sign to exclude a term. Multiple in: scopes are combined as alternatives. Available results still depend on each tool’s documented corpus.
in:ai-search citations— search the AI Search pillar.type:guide "title tag" -generator— require the phrase in guides and exclude generators.in:tools canonical— search the Tools section with the full-site search tool.
Example project
The search_content example above scopes an exact javascript seo phrase to Technical SEO and returns a result shaped like this:
Title: JavaScript SEO
Slug: javascript-seo
Canonical URL: https://patrickstox.com/technical-seo/javascript-seo/
This is a deliberately trimmed documentation fixture from the shared tool roster, not a live request made when the page renders.
What each step produces
Content tools return source records intended to retain their canonical URLs. verify_bot returns identity evidence and a crawler-range snapshot date. validate_schema returns parsed entities and issue tiers. trace_redirect_chain returns a bounded chain and final state. inspect_og returns normalized Open Graph and Twitter fields, resolved image URLs, selected-UA evidence, and per-platform source provenance. Every verification result also carries a versioned capture-provenance object and finding packet so an agent can preserve the observed mode, JavaScript state, coverage, evidence, fix, and verification instruction. Neither URL tool exposes full HTML or arbitrary response headers. Treat an error, truncated capture, or unavailable check as not evaluated, never as a negative verdict.
How project data is stored
The page and Worker share the same MCP registry and free-tier availability rule, so names, argument schemas, rate tiers, and documentation examples stay aligned with the tools an unauthenticated client can list. Modern clients use stateless per-request metadata and server/discover; legacy clients can still negotiate through initialize. Streamable HTTP requests are routed to read-only handlers. Content calls use the build-time published corpus; tool calls reuse bounded validators and safe public-network checks.
Features
- Search the complete public site corpus or only published SEO guidance, with canonical attribution.
- Fetch full article markdown and list the public content taxonomy with build-time PageRank share.
- Verify one crawler IP, validate pasted schema, trace one public redirect chain, or inspect social metadata from one public page.
- Return versioned capture provenance and portable finding packets with verification-tool results.
- Supports MCP
2026-07-28plus the legacy 2025 initialization flow over Streamable HTTP, without a key.
Limits & fair use
- Published-content tools: 120 calls per minute per IP.
- Tool calls (bot verification, schema validation, redirect tracing, and social metadata inspection): 10 calls per day per IP across the teaser tool set.
- URL inspection accepts only public URLs and allowlisted user agents, validates every redirect hop, and bounds redirects, bytes, and time.
Limits protect the free service. A paid API tier is not available yet.
Common request error: Provide a public http(s) URL. Correct the request arguments or wait for the stated rate-limit window before retrying. Call the same read-only tool again and confirm it returns a result object instead of an MCP error.
For an unexpected connection or service error, check the current service status before retrying or reporting it.
Limitations
- No write actions, private content, Search Console access, bulk crawling, or general proxy behavior.
- Public tool calls share a small daily per-IP teaser quota.
- Bot verification depends on dated published ranges and available DNS evidence.
- Schema checks are deterministic eligibility guidance, not a guarantee of a rich result.
- URL checks are bounded and accept only public HTTP(S) targets.
- A truncated
inspect_ogcapture may report observed tags, but missing fields, completeness, and score remain explicitly not evaluated.
Attribution
When you use material returned by get_article, cite its canonical Patrick Stox URL. The server flags AI-assisted drafts pending human review; treat that status as part of the source context.
Frequently asked questions
Is this a public API?
No. This is a small, read-only MCP teaser for agents. The site’s ordinary tool endpoints remain same-origin only, and the MCP tool calls have a deliberately small fair-use limit.
What can an agent do?
It can search and fetch published content, inspect the content taxonomy, verify one public crawler IP, validate pasted JSON-LD or HTML, trace one public redirect chain, and inspect Open Graph or Twitter metadata from one public URL. It cannot change site data or access private content.
How should an agent cite this content?
Use the canonical article URL returned by the server whenever you rely on material from a fetched article.
Does the MCP server require an API key?
No. The teaser endpoint is unauthenticated, read-only, and protected by per-IP fair-use limits. It is not intended for high-volume automation.
What happens when a tool cannot verify a result?
The server returns bounded evidence or an explicit error state. A failed fetch, unavailable verification, or rate limit must not be interpreted as a crawler, schema, or redirect verdict.
Hộ chiếu trang web Ngữ cảnh cục bộ cho trang đã lưu này
Dữ liệu cục bộ
Các mục tiêu đã lưu, danh sách có tên và bản tóm tắt kiểm tra gần đây chỉ được giữ trong trình duyệt này.
Đánh giá công cụ này
Giới thiệu công cụ
Cung cấp máy chủ MCP chỉ đọc để tác nhân tìm nội dung đã xuất bản và gọi một tập công cụ SEO công khai có giới hạn.
Tính năng
- Tìm kiếm và truy xuất nội dung với URL canonical.
- Xác minh trình thu thập, dữ liệu có cấu trúc, chuyển hướng và siêu dữ liệu xã hội.
- Trả bằng chứng, nguồn gốc bản chụp và hướng dẫn xác minh.
- Không cần khóa API cho tầng giới thiệu có giới hạn.
Cách hoạt động
Trang và Worker dùng chung sổ đăng ký công cụ cùng lược đồ đối số; yêu cầu được định tuyến đến trình xử lý chỉ đọc có giới hạn và mọi lỗi hoặc bản chụp không đầy đủ được giữ là chưa đánh giá.
Giới hạn
- Không phải API công khai cho tự động hóa khối lượng lớn.
- Không thay đổi dữ liệu hoặc truy cập nội dung riêng tư.
- Công cụ URL không trả toàn bộ HTML hoặc tiêu đề tùy ý.
Câu hỏi thường gặp
Đây có phải là API công khai không?
Không. Đây là bản giới thiệu `MCP` nhỏ, chỉ đọc dành cho tác nhân. Các điểm cuối công cụ thông thường của trang web vẫn chỉ cùng nguồn, còn lệnh gọi công cụ `MCP` có giới hạn sử dụng hợp lý được đặt ở mức thấp có chủ ý.
Một tác nhân có thể làm gì?
Tác nhân có thể tìm kiếm và truy xuất nội dung đã xuất bản, xem phân loại nội dung, xác minh một IP trình thu thập công khai, xác thực JSON-LD hoặc HTML được dán, theo dõi một chuỗi chuyển hướng công khai và kiểm tra siêu dữ liệu `Open Graph` hoặc `Twitter` từ một URL công khai. Tác nhân không thể thay đổi dữ liệu trang web hay truy cập nội dung riêng tư.
Tác nhân nên trích dẫn nội dung này như thế nào?
Hãy dùng URL bài viết canonical do máy chủ trả về bất cứ khi nào bạn dựa vào tài liệu từ một bài viết đã truy xuất.
Máy chủ `MCP` có yêu cầu khóa API không?
Không. Điểm cuối giới thiệu không cần xác thực, chỉ đọc và được bảo vệ bằng giới hạn sử dụng hợp lý theo IP. Nó không dành cho tự động hóa khối lượng lớn.
Điều gì xảy ra khi công cụ không thể xác minh kết quả?
Máy chủ trả về bằng chứng có giới hạn hoặc trạng thái lỗi rõ ràng. Không được diễn giải lần truy xuất thất bại, xác minh không khả dụng hoặc giới hạn tốc độ như một kết luận về trình thu thập, dữ liệu có cấu trúc hay chuyển hướng.
Các vấn đề thường gặp và cách khắc phục
- Lỗi Mã đánh dấu không đáp ứng điều kiện kết quả nhiều định dạng Cách khắc phục: Sửa lỗi phân tích cú pháp hoặc thuộc tính bắt buộc được thao tác xác thực nêu tên, và chỉ dùng loại kết quả nhiều định dạng được hỗ trợ khớp chính xác với trang.
- Cảnh báo Dấu vết chuyển hướng có một bước không cần thiết Cách khắc phục: Chuyển hướng URL ban đầu thẳng đến đích cuối và loại bỏ bước trung gian.
- Lỗi IP trình thu thập nằm ngoài dải đã công bố Cách khắc phục: Coi tuyên bố đó là giả mạo, chặn hoặc giới hạn tốc độ theo hành vi, rồi xác minh với các dải hiện hành do nhà vận hành công bố.