Skip to content

www.reddit.com

Agents are likely to struggle

What should the prompt cover?

15 findings · 5 selected

Failures (11)

Warnings (4)

Task

What does www.reddit.com do and who is it for? Explain it back to me.

Waiting for the agent’s first step…

Critical access blockers remain

These checks describe whether an ordinary agent can enter, read, and operate the public site.

  • Agents can reach the site

    Crawler access and bot defenses.

    0 / 2 passed
  • Core content is available

    Useful content remains accessible without a fragile browser-only path.

    0 / 1 passed
  • Navigation fails safely

    Redirects and missing pages give agents a recoverable path.

    0 / 1 passed

Evaluated surfaces have material gaps

The public website is always evaluated. Optional surfaces appear when the scan finds positive evidence that they apply.

Public website

Blocked

27%

2 of 13 mature checks passed

API

Needs work

67%

6 of 9 mature checks passed

MCP

Ready with gaps

83%

0 of 1 mature checks passed

Fix these gaps first

Critical access gaps come first, followed by other applicable readiness gaps.

  1. 01

    Not blocked by bot detection

    Allowlist known AI agent User-Agents (ChatGPT-User, ClaudeBot, Google-Extended, DeepSeekBot) in your WAF or bot-detection rules.

    Critical access
  2. 02

    Agent crawler reachability

    Verify that major agent User-Agents can reach the homepage. If your WAF or bot rules block them, remove or narrow the blocking rule. Add an allow rule only when your security setup denies them by default.

    Critical access
  3. 03

    Content without JavaScript

    Server-side render your homepage so AI crawlers see meaningful content without JavaScript. Ensure an H1 and 500+ chars of text in raw HTML.

    Critical access
  4. 04

    Agent-friendly 404s

    Return a real HTTP 404 (or 410) status for nonexistent paths - never a 200 with your app shell, which makes agents believe every path exists. For full credit, give the 404 response a short markdown body pointing agents at your sitemap, llms.txt, or docs index. Verify with curl -s -o /dev/null -w "%{http_code}" https://yourdomain.com/some-path-that-does-not-exist - it must print 404.

    Critical access
  5. 05

    OpenAPI spec published

    Publish an OpenAPI (Swagger) specification at /openapi.json or /api/openapi.yaml. This is how agents understand your API surface automatically.

    Other readiness checks

Audit the checks behind the score

Applicable evidence is grouped by how it contributes to this preview model. Bonus checks appear only when they add points.

Essential0 of 7 passed · 5.7 / 80 points
  • Content without JavaScriptFailed

    Could not fetch homepage

    Recommendation

    Server-side render your homepage so AI crawlers see meaningful content without JavaScript. Ensure an H1 and 500+ chars of text in raw HTML.

  • Not blocked by bot detectionFailed

    Agents blocked: GPTBot, ChatGPT-User, PerplexityBot, Google-Extended, Applebot-Extended

    Recommendation

    Allowlist known AI agent User-Agents (ChatGPT-User, ClaudeBot, Google-Extended, DeepSeekBot) in your WAF or bot-detection rules.

  • OpenAPI spec publishedFailed

    No OpenAPI/Swagger specification found

    Recommendation

    Publish an OpenAPI (Swagger) specification at /openapi.json or /api/openapi.yaml. This is how agents understand your API surface automatically.

  • Markdown content negotiation (acceptmarkdown.com)Failed

    Not acceptmarkdown.com compliant: Accept: text/markdown returned text/html; Vary header missing Accept (got "none")

    Recommendation

    On the responses that serve text/markdown via Accept negotiation, add Accept to the Vary header (Vary: Accept, Accept-Encoding). Without it, CDNs can serve the cached HTML variant to an agent asking for markdown (or vice versa), depending on which variant landed in cache first.

  • Agent crawler reachabilityFailed

    No major AI crawler can reach the homepage - ChatGPT-User: blocked, ClaudeBot: blocked, Google-Extended: blocked, ora-agent: blocked, DeepSeekBot: blocked

    Recommendation

    Verify that major agent User-Agents can reach the homepage. If your WAF or bot rules block them, remove or narrow the blocking rule. Add an allow rule only when your security setup denies them by default.

  • JSON error responsesFailed

    API does not return JSON error responses (or no API detected)

    Recommendation

    Return structured JSON error responses with error codes, messages, and resolution hints. Agents can't parse HTML error pages.

  • Agent-friendly 404sPartial (50%)

    Nonexistent paths return HTTP 403 instead of 404/410 - agents get a non-200 signal but not the standard not-found semantics

    Recommendation

    Return a real HTTP 404 (or 410) status for nonexistent paths - never a 200 with your app shell, which makes agents believe every path exists. For full credit, give the 404 response a short markdown body pointing agents at your sitemap, llms.txt, or docs index. Verify with curl -s -o /dev/null -w "%{http_code}" https://yourdomain.com/some-path-that-does-not-exist - it must print 404.

Recommended8 of 16 passed · 12.3 / 20 points
  • Developer resource discoverabilityPassed

    Agent discovered 2 developer-resource types by name (MCP server, API docs) across 8 pages

    Recommendation

    Make your developer resources (API docs, OpenAPI spec, auth docs, webhooks, MCP server) discoverable by name. Publish them at predictable URLs, list them in llms.txt, and include your product name in page titles and headings so search engines surface them for name-based queries.

  • Brand name discoverabilityPassed

    reddit.com appears at position #2 in a clean brand-name search for "reddit communication support" (7 total matches)

    Recommendation

    Make sure a clean search for your brand name returns your own domain in the top results. If it does not, your brand may be too generic, conflict with a more established term, or not yet indexed. Strengthen brand-name search by claiming consistent NAP across listings, earning press mentions that link to the canonical domain, and avoiding redirect chains that mask the apex domain in search results.

  • Sitemap existsFailed

    No sitemap found

    Recommendation

    Add a valid XML sitemap at /sitemap.xml listing all indexable URLs. Include lastmod dates and keep it under 50MB.

  • JSON-LD structured dataFailed

    No JSON-LD structured data found on homepage

    Recommendation

    Add JSON-LD structured data to your homepage using the identity type that matches your site - SoftwareApplication for products, Organization or LocalBusiness for companies, Person for personal sites, Article for blogs - with name, description, url, and type-appropriate fields (offers, sameAs, author) so AI can parse your identity programmatically.

  • Public API/docs linked from homepagePassed

    Documentation site found at https://developers.reddit.com

    Recommendation

    Publish API documentation at a discoverable URL (/docs, /api, /developers). Include authentication, endpoints, and example requests.

  • Agent instruction / when-to-useFailed

    No agent instruction file with when-to-use guidance found

    Recommendation

    Tell agents when to reach for you: add a 'when to use this' section to your llms.txt (or a dedicated agent-instructions file) that names your best-fit use cases and how an agent should call you. Be specific about the jobs you are right for - generic marketing copy does not read as guidance.

  • Metadata completenessPartial (50%)

    3/4 metadata signals present - missing: canonical URL

    Recommendation

    Add all four signals to your homepage: , , , and . Agents use these for entity resolution and attribution.

  • Organization schema completenessFailed

    No JSON-LD found - Organization schema missing

    Recommendation

    Add Organization JSON-LD that includes both contactPoint (with email/phone and contactType) and address (PostalAddress). This lets AI verify your business legitimacy and answer contact queries.

  • Trust anchor pagesPartial (50%)

    About, Privacy pages verified - missing: Contact

    Recommendation

    Publish real /about, /contact, and /privacy pages with at least 500 characters of content each. These are the pages AI agents check to verify your business is legitimate before recommending you.

  • Developer portalPassed

    Developer documentation portal found at https://developers.reddit.com

    Recommendation

    Create a developer portal at /developers with API keys, documentation, quickstart guides, and a sandbox environment.

  • Public API with reachable endpointsPassed

    API described in documentation at https://developers.reddit.com but no machine-verifiable API surface confirmed. GraphQL endpoint at https://api.reddit.com/graphql is reachable; introspection requires authentication (API key / OAuth), which is expected for agent access. Best-of-protocols score: 7/7.

    Recommendation

    Expose a public REST or GraphQL API. AI agents need programmatic access - not just a web UI - to integrate with your product.

  • MCP server / manifestPartial (83%)

    Live MCP server at https://mcp.reddit.com requires authentication (OAuth challenge at initialize) - properly scoped. Upgrade to public tool listing for full 6/6.

    Recommendation

    Build an MCP (Model Context Protocol) server exposing your API as tools. Use Streamable HTTP transport for full score. This lets Claude, ChatGPT, and other AI agents call your product natively.

  • Rate limit response headersPassed

    GraphQL rate-limit / cost headers found on introspection response: retry-after

    Recommendation

    Return standard rate-limit headers on your API responses (the RFC RateLimit headers, plus Retry-After on a 429) so agents can self-throttle in real time, and document the conventions alongside your API.

  • CLI tool availablePassed

    CLI tool found on PyPI: reddit_cli

    Recommendation

    Publish an official CLI tool on npm, PyPI, or Homebrew. A CLI lets agents and developers script interactions with your product without building API integrations from scratch.

  • API schema complexity analysisPassed

    GraphQL: schema details documented at https://developers.reddit.com/docs/introduction/intro-games (introspection auth-gated)

    Recommendation

    Make your API spec self-describing: a unique operationId and a description on every operation, typed parameters, and response schemas. For GraphQL, a fully typed schema with a documented cost or rate limit reads best.

  • Function calling compatibilityFailed

    No API spec found - function calling requires discoverable endpoints

    Recommendation

    Ensure API endpoints have unique operation IDs, typed schemas, and descriptions compatible with LLM function-calling formats.

Bonus signals6 positive · +1.1 points
  • Wikipedia / Wikidata entity presencePassed

    Wikipedia "Reddit" and Wikidata Q1136 both verified - domain confirmed on both sources

    Recommendation

    Establish a Wikipedia article and a Wikidata entity for your brand, with the domain set as the official website (Wikidata property P856) and a corresponding external link on Wikipedia. Wikipedia is the largest single source of citations in ChatGPT and a primary input to Knowledge Graphs across Google, Bing, and LLM training data. Earn third-party press coverage first to satisfy notability, then draft the article with cited references rather than self-promotion.

  • Listed on skills.shPassed

    3 official skills published on skills.sh - 224 total installs (skills.sh/reddit)

    Recommendation

    Publish agent skills on skills.sh so AI agents can discover your product's capabilities. Create a SKILL.md in your GitHub repo and register it with 'npx skills add'. See skills.sh/docs.

  • MCP well-known discoveryPartial (50%)

    MCP server at https://mcp.reddit.com - consider adding /.well-known/mcp for standard discovery

    Recommendation

    Serve your MCP server at /.well-known/mcp, publish a server-card.json at /.well-known/mcp/server-card.json, or reference it in llms.txt so agents can discover it automatically without manual URL input.

  • Skills.sh skill qualityPartial (50%)

    Skills.sh presence exists but limited - 3 skills (goal: 5+)

    Recommendation

    Expand your skills.sh presence with multiple skill repos covering different use cases. Add descriptive skill names, clear SKILL.md files, and organize by capability area.

  • MCP auth mechanismPartial (50%)

    product MCP requires authentication but no standard OAuth discovery metadata

    Recommendation

    Protect your MCP server with OAuth 2.0 authentication. Publish authorization server metadata at /.well-known/oauth-authorization-server for automatic agent auth flows.

  • NLWeb /ask endpointPassed

    NLWeb /ask endpoint exists but requires authentication (HTTP 403, via GET)

    Recommendation

    Implement Microsoft's NLWeb protocol by adding a POST /ask endpoint that accepts natural-language queries and returns JSON with _meta (response_type, version). See github.com/microsoft/NLWeb.

Inspect the underlying audit

The complete Ora audit uses evidence from the scan on . After applying changes, run another scan from the homepage to refresh these recommendations.

Sign me up for Vercel product updates and marketing emails.

Unsubscribe anytime. Privacy Notice

Source: Ora API

Snapshot 2026-08-24T14-46-20-624Z