Skip to content

netflix.com

Agents are likely to struggle

What should the prompt cover?

17 findings · 5 selected

Failures (10)

Warnings (7)

Task

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

Waiting for the agent’s first step…

Critical access needs attention

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.

    2 / 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.

    1 / 2 passed
  • Controls are understandable

    Forms and interactive controls expose usable names and structure.

    3 / 3 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

Needs work

51%

6 of 15 mature checks passed

API

Blocked

30%

1 of 8 mature checks passed

Authentication

Needs work

67%

2 of 3 mature checks passed

Commerce

Strong

100%

1 of 1 mature checks passed

Fix these gaps first

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

  1. 01

    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
  2. 02

    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
  3. 03

    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
  4. 04

    Scoped permissions

    Declare scoped API permissions where machines can read them: named OAuth scopes in your OpenAPI security schemes, or scopes_supported in RFC 9728 protected-resource metadata. Prose descriptions of roles help humans, but agents need the machine-readable declaration to request least-privilege access.

    Other readiness checks
  5. 05

    JSON error responses

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

    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.

Essential4 of 10 passed · 37.3 / 80 points
  • Content without JavaScriptPartial (67%)

    2830 chars with H1 but flat heading structure

    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 detectionPassed

    Site accessible to 6 AI agent user-agents

    Recommendation

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

  • Redirect hygienePassed

    No meta-refresh stubs, JavaScript-redirect stubs, or cross-domain hops across 1 checked page

    Recommendation

    Replace meta-refresh and JavaScript-only redirects with real HTTP 301/302 redirects. Non-JS agents never execute location.href or wait for a meta refresh - they see only the stub page. Verify with curl -sI <url> - you should see a Location header, not a 200 with a near-empty body.

  • 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; charset=utf-8; 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 reachabilityPassed

    Reachable to all major AI crawlers - ChatGPT-User: reachable, ClaudeBot: reachable, Google-Extended: reachable, ora-agent: reachable, DeepSeekBot: reachable

    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.

  • OAuth 2.0 supportPassed

    OAuth endpoint found at https://netflix.com/oauth2/authorize

    Recommendation

    Implement OAuth 2.0 for API authentication. Publish your authorization server metadata at /.well-known/oauth-authorization-server.

  • Scoped permissionsFailed

    No declared OAuth scopes, security schemes, or scoped-permission documentation found

    Recommendation

    Declare scoped API permissions where machines can read them: named OAuth scopes in your OpenAPI security schemes, or scopes_supported in RFC 9728 protected-resource metadata. Prose descriptions of roles help humans, but agents need the machine-readable declaration to request least-privilege access.

  • 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 404sFailed

    Nonexistent paths return HTTP 200 with the app shell (soft-404). Agents probing for resources conclude every path exists. Return a real HTTP 404 status for unknown paths.

    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.

Recommended6 of 17 passed · 9.8 / 20 points
  • Developer resource discoverabilityFailed

    Agent searched for "netflix" developer resources but found nothing relevant

    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

    netflix.com appears at position #3 in a clean brand-name search for "Netflix" (1 total match)

    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 existsPassed

    Valid sitemap found at https://www.netflix.com/sitemap/index with multiple sitemaps entries

    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.

  • Pricing info accessiblePassed

    Pricing page found at /pricing

    Recommendation

    Make pricing discoverable - add a /pricing page or include pricing as schema.org/Offer structured data, so agents can find it without scraping a marketing page.

  • Public API/docs linked from homepagePartial (33%)

    Documentation found at /api but not linked from homepage

    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%)

    Only 1/4 metadata signals present - missing: canonical URL, og:image, og:type

    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%)

    Contact, Privacy pages verified - missing: About

    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.

  • Page token budgetPassed

    All 1 measured page fit an agent context budget (largest ~1K tokens)

    Recommendation

    Keep each page's extracted text under ~100K characters (~25K tokens) so it fits an agent's context window without truncation. Split oversized reference pages into focused per-topic documents and link them from an index. Check a page with curl -s <url> | wc -c and remember agents read the extracted text, not the raw HTML.

  • Public API with reachable endpointsPartial (29%)

    GraphQL endpoint at https://netflix.com/graphql reachable but introspection disabled (errors_array). Best-of-protocols score: 2/7.

    Recommendation

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

  • Agent onboarding frictionPassed

    Low friction onboarding verified live: self-serve key generation, sandbox/test environment, zero-friction self-serve registration at /register

    Recommendation

    Offer a free tier or trial, self-serve API key generation, and a sandbox environment. Agents can't fill out 'contact sales' forms.

  • Rate limit response headersFailed

    No GraphQL rate-limit headers observed on the introspection response

    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: netflix

    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 analysisPartial (25%)

    REST: OpenAPI spec found but failed to parse for complexity analysis | GraphQL: endpoint detected but no schema reachable | Combined score: 0.5/2

    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 compatibilityPartial (50%)

    API spec found but couldn't validate function calling compatibility

    Recommendation

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

Bonus signals10 positive · +2.1 points
  • pricing.md existsPartial (50%)

    pricing.md found at /pricing.md but thin (12 lines) - add plan tiers, prices, and feature breakdowns

    Recommendation

    Create a /pricing.md file with your pricing tiers, features, and limits in plain markdown. This lets AI agents compare costs and recommend plans without scraping HTML pricing pages.

  • Agent mode viewPassed

    Rich agent mode view at ?mode=agent with 4 agent signals and navigation links

    Recommendation

    Add a ?mode=agent query parameter to your homepage that returns a structured, machine-readable view with API endpoints, authentication info, and key capabilities instead of marketing HTML.

  • API catalog (RFC 9727)Partial (50%)

    api-catalog responded but body is not valid JSON

    Recommendation

    Publish an API catalog at /.well-known/api-catalog per RFC 9727. Serve it with Content-Type: application/linkset+json;profile="https://www.rfc-editor.org/info/rfc9727" and include a 'linkset' array with item entries pointing to your OpenAPI specs and service descriptions.

  • Web Bot Auth directoryPartial (50%)

    Web Bot Auth directory found but body is not valid JSON

    Recommendation

    Publish a Web Bot Auth directory at /.well-known/http-message-signatures-directory. Serve a JSON document with a 'keys' array of Ed25519 JWKs (kty=OKP, crv=Ed25519, kid, nbf, exp). This lets agents sign their requests per RFC 9421 so you can distinguish legitimate bots from spoofers.

  • Native interactive controlsPassed

    46 native controls, 0 non-native div-soup affordances (100% native).

  • Accessible names on controlsPassed

    46/46 interactive elements have a computable accessible name (100%).

  • Form control labelingPassed

    4/4 form controls have an associated label (100%).

  • Accessibility-tree injection safety (bonus)Passed

    No hidden instruction text detected in accessibility-tree attributes or off-screen content.

  • ACP - Agentic Commerce ProtocolPassed

    ACP checkout endpoint reachable at https://netflix.com/checkout_sessions (OPTIONS 200 allows POST, POST 200 confirmed)

    Recommendation

    Implement the Agentic Commerce Protocol checkout REST API: POST /checkout_sessions (create), update/get/complete/cancel variants, with API-Version: YYYY-MM-DD and Idempotency-Key required headers. Preflight OPTIONS should allow POST or return an ACP-shaped error with supported_versions so agents can negotiate.

  • ACP delegate paymentPassed

    Delegate Payment endpoint reachable at https://netflix.com/agentic_commerce/delegate_payment (OPTIONS 200 allows POST, POST 200 confirmed)

    Recommendation

    Expose the ACP Delegate Payment endpoint at POST /agentic_commerce/delegate_payment. The request takes payment_method, allowance (max amount, currency, expiry, merchant scope), and risk_signals; the response returns a vault token. This lets agents pay on behalf of users with scoped, revocable credentials.

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-24T04-52-42-119Z