# GoCrawl (gocrawl.tech) — Full Technical Knowledge Base & AI Reference
> Machine-readable single-file compilation for LLMs, AI search engines (ChatGPT Search, Perplexity, Claude, Google AI Overviews), and MCP agents. Source: https://gocrawl.tech
---
## 1. Platform Overview
- **Product Name:** GoCrawl
- **Canonical Origin:** https://gocrawl.tech
- **Core Capabilities:** High-speed Go concurrent website crawler, 6-Dimension Technical SEO & AI Search (GEO) Grader, 3-file `/llms.txt` grounding pack generator, 20 interactive diagnostic question tools, 24/7 HTTP/AI-bot Watchdog, and native Model Context Protocol (MCP) server.
- **Supported Platforms:** Web (`https://gocrawl.tech`), Windows (`GoCrawl-Windows-amd64.exe`), macOS (`GoCrawl-macOS-universal.zip`), Linux (`GoCrawl-Linux-amd64`), and MCP (`https://gocrawl.tech/api/mcp`).
## 2. Six-Pillar Site Scorecard Methodology
GoCrawl grades every domain on a 0–100 scale (`A+` through `F`) weighted across six technical pillars:
1. **Crawl & Indexability (25%):** HTTP 200 OK ratio, broken 4xx/5xx links, redirect chains/loops, canonical consistency.
2. **On-Page & Keyword Alignment (20%):** Title pixel width (<=580px), H1 presence, meta description, and semantic n-gram alignment between visible body copy and `
`/``.
3. **Site Architecture & Link Equity (15%):** Click depth distribution, internal PageRank (`LinkScore`), orphan page detection.
4. **Performance & TTFB (15%):** Server response latency and HTML payload efficiency.
5. **Structured Data & Schema.org (10%):** Embedded `application/ld+json` entity validation.
6. **AI Search & GEO Readiness (15%):** Live bot parity across `Googlebot`, `GPTBot`, `OAI-SearchBot`, `ClaudeBot`, and `PerplexityBot`, SSR raw HTML word count, and `/llms.txt` + `/llms-full.txt` grounding presence.
## 3. Cloud & Local MCP Server Integration
- **Discovery Endpoint:** `GET https://gocrawl.tech/api/mcp`
- **Tools List Endpoint:** `GET https://gocrawl.tech/api/mcp/tools`
- **JSON-RPC 2.0 Endpoint:** `POST https://gocrawl.tech/api/mcp`
- **Local Stdio Mode:** `go-crawl -mcp -db gocrawl.db`
## 4. Complete Directory of 20 Interactive Diagnostic Question Pages
### 1. Is ChatGPT Blocked From Crawling My Website?
- **URL:** https://gocrawl.tech/q/is-chatgpt-blocked-from-my-website
- **Category:** AI Search & Bots
- **Summary:** Test live if OpenAI's GPTBot and OAI-SearchBot can crawl your website or if Cloudflare, WAF rules, or robots.txt are blocking ChatGPT Search citations.
- **Direct Answer:** ChatGPT relies on two user-agents—OAI-SearchBot (for live search citations) and GPTBot (for model grounding)—to read your site. If your CDN, WAF, or robots.txt returns HTTP 403 or Disallow to these bots while allowing Googlebot, your pages will be omitted from ChatGPT Search answers.
### 2. Why Is Perplexity or Claude Not Citing My Website?
- **URL:** https://gocrawl.tech/q/why-is-perplexity-not-citing-my-website
- **Category:** AI Search & Bots
- **Summary:** Diagnose why PerplexityBot and ClaudeBot fail to cite your domain. Check AI crawler parity, /llms.txt presence, and structured entity grounding.
- **Direct Answer:** Perplexity and Claude omit websites primarily due to three technical barriers: edge firewall blocks (HTTP 403/503 on PerplexityBot or ClaudeBot), lack of a machine-readable /llms.txt directory, or thin client-side JavaScript pages that lack server-rendered text and JSON-LD schema.
### 3. Is Cloudflare or My Firewall Blocking AI Search Bots?
- **URL:** https://gocrawl.tech/q/is-cloudflare-blocking-ai-bots
- **Category:** AI Search & Bots
- **Summary:** Run a simultaneous multi-agent probe across Googlebot, GPTBot, OAI-SearchBot, ClaudeBot, and PerplexityBot to detect WAF and CDN bot blocking.
- **Direct Answer:** Many CDN and WAF configurations—including Cloudflare Bot Fight Mode—treat AI search crawlers as unverified scrapers, serving JS challenges or HTTP 403 Forbidden responses to GPTBot, ClaudeBot, and PerplexityBot even when Googlebot passes cleanly.
### 4. What Should My robots.txt Look Like for AI Search Engines?
- **URL:** https://gocrawl.tech/q/robots-txt-for-ai-search-engines
- **Category:** AI Search & Bots
- **Summary:** Audit your live robots.txt for AI search crawler access and generate a clean, spec-compliant robots.txt for Googlebot, OAI-SearchBot, GPTBot, ClaudeBot, and PerplexityBot.
- **Direct Answer:** An optimal robots.txt for AI search explicitly allows retrieval agents (Googlebot, OAI-SearchBot, PerplexityBot, ClaudeBot) on public content while blocking private app routes (/admin, /api, /checkout) and referencing both your XML sitemap and /llms.txt.
### 5. Does My Website Have a Valid /llms.txt File?
- **URL:** https://gocrawl.tech/q/does-my-website-have-llms-txt
- **Category:** llms.txt & Grounding
- **Summary:** Check if your domain serves a valid /llms.txt file for AI search agents, verify markdown section formatting, and test linked URLs for 200 OK status.
- **Direct Answer:** The /llms.txt standard places a concise, machine-readable Markdown index at the root of your domain (https://yourdomain.com/llms.txt) so LLMs and AI retrieval agents can immediately understand your product identity, core verticals, and canonical documentation links.
### 6. How Do I Generate an /llms.txt File for My Website?
- **URL:** https://gocrawl.tech/q/how-to-generate-llms-txt
- **Category:** llms.txt & Grounding
- **Summary:** Automatically crawl your top pages and generate a 3-file AI grounding pack: /llms.txt, /llms-full.txt, and a zero-JS semantic entity HTML page.
- **Direct Answer:** You can generate a production-ready /llms.txt file by crawling your domain's indexable 200 OK pages, ranking them by internal PageRank (LinkScore), grouping them by directory vertical, and formatting their titles and meta descriptions into clean Markdown.
### 7. Does My Website Have Valid JSON-LD Schema for AI Search?
- **URL:** https://gocrawl.tech/q/does-my-website-have-json-ld-schema
- **Category:** llms.txt & Grounding
- **Summary:** Inspect your page for structured JSON-LD schema.org entities (Organization, WebSite, SoftwareApplication, FAQPage) and generate missing structured data.
- **Direct Answer:** JSON-LD (