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

  1. Add the endpoint with the configuration for your MCP client.
  2. Confirm the client discovers the tools below before relying on a prompt-driven call.
  3. Use search_site for the complete public corpus or search_content for articles only, then fetch an article by its returned slug when full text is needed.
  4. For verification tools, supply only the documented public IP, pasted markup, or public URL and preserve the returned evidence and error state.
  5. Cite the canonical URL returned with published content.

Available tools

ToolWhat it doesArguments
search_contentSearch 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_siteSearch 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_articleFetch 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_pillarsList the site's content pillars and clusters (taxonomy) with URLs and internal-PageRank share, from the build-time content graph.None
verify_botVerify 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 address
claim — Optional crawler id, e.g. "googlebot"
validate_schemaValidate 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 characters
mode — "jsonld" (default) or "html"
trace_redirect_chainTrace 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 trace
ua — Optional user-agent profile: default, browser, googlebot, bingbot, gptbot, claudebot, or perplexitybot
inspect_ogInspect 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 inspect
ua — 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-28 plus 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_og capture 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.

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.

Phản hồi
Báo lỗi

Có gì đó không hoạt động trong Máy chủ SEO MCP? Hãy cho chúng tôi biết điều gì đã xảy ra — báo cáo được gửi thẳng đến hàng đợi phân loại riêng tư, không phải danh sách công khai.

Thông tin sẽ được gửi
 Dữ liệu nhập vào công cụ, tệp tải lên, nguồn đã dán, kết quả đầy đủ, tham số truy vấn và đoạn URL không được tự động đính kèm. Bạn có thể sửa hoặc xóa đoạn đã chọn ở trên. Siêu dữ liệu trình duyệt và chống lạm dụng được xử lý để ngăn spam. 

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.

Bước tiếp theoTrình kiểm tra mức sẵn sàng cho tác nhân — verify it with a direct check. Hướng dẫn có bằng tiếng Anh.