Skip to content

faire.com

Important blockers remain

What should the prompt cover?

21 findings · 5 selected

Failures (12)

Warnings (9)

Task

What does faire.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.

    1 / 2 passed
  • Core content is available

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

    1 / 2 passed
  • Navigation fails safely

    Redirects and missing pages give agents a recoverable path.

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

Blocked

39%

5 of 16 mature checks passed

API

Needs work

67%

6 of 12 mature checks passed

Authentication

Blocked

30%

0 of 3 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

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

    Scoped permissions

    Support scoped API permissions (OAuth scopes or API key roles) so agents can request only the access they need.

    Other readiness checks
  4. 04

    Markdown content negotiation (acceptmarkdown.com)

    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.

    Other readiness checks
  5. 05

    OAuth 2.0 support

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

    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.

Essential5 of 10 passed · 48.5 / 80 points
  • Content without JavaScriptPartial (67%)

    1204 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 6 checked pages

    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.

  • Content behind authPassed

    All 5 sampled pages are publicly readable (1 with substantive content)

    Recommendation

    Serve your content pages without a login wall. Agents cannot complete auth flows while browsing - a 401/403 or a login-form page is invisible content. Keep public documentation public; if some content must stay gated, publish an ungated summary so agents can still represent it.

  • OpenAPI spec publishedPassed

    OpenAPI spec found at https://faire.com/.well-known/openapi.json (version: 3.0.3)

    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 */*; 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

    Some AI crawlers are blocked - ChatGPT-User: reachable, ClaudeBot: reachable, Google-Extended: reachable, ora-agent: blocked, 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 supportPartial (40%)

    OAuth mentioned on homepage but no standard endpoints found

    Recommendation

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

  • Scoped permissionsFailed

    No scoped permissions or security schemes found

    Recommendation

    Support scoped API permissions (OAuth scopes or API key roles) so agents can request only the access they need.

  • JSON error responsesPassed

    API returns JSON error responses (404 at https://www.faire.com/external-api/v2 (from OpenAPI servers))

    Recommendation

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

Recommended6 of 22 passed · 8.9 / 20 points
  • Developer resource discoverabilityFailed

    Agent searched for "faire" 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 discoverabilityFailed

    "Instagram" search returned 4 results but domain did not appear - brand may be too generic or not indexed

    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.faire.com/sitemap-index.xml.gz 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.

  • Content efficiencyFailed

    Very low content efficiency: 0.66% (2104 text chars in 309KB HTML) - agents must process excessive markup noise

    Recommendation

    Reduce markup overhead so readable text is at least 5% of your HTML. Strip unused inline scripts/styles, server-render content instead of shipping large JSON hydration blobs, and keep wrapper nesting shallow.

  • 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.faire.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%)

    2/4 metadata signals present - missing: canonical URL, og:image

    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 pagesFailed

    No trust anchor pages found with sufficient content (About, Contact, Privacy)

    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 6 measured pages fit an agent context budget (largest ~3K 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.

  • Developer portalPassed

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

    Recommendation

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

  • Public API with reachable endpointsPassed

    Documented REST API detected; endpoints require 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.

  • Agent onboarding frictionPartial (50%)

    Moderate friction: self-serve key generation, sandbox/test environment

    Recommendation

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

  • MCP server / manifestPartial (83%)

    Live MCP server at https://mcp.faire.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 headersFailed

    No REST rate-limit headers found on probed endpoints

    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.

  • REST typed error modelPartial (33%)

    Partial typed error model: error schema defined but not consistently referenced (or vice versa)

    Recommendation

    Document your error responses in your OpenAPI spec: give 4xx and 5xx responses a typed error schema (or use RFC 9457 application/problem+json). A consistent error object with a machine-readable code and a human-readable message lets agents handle failures without guessing.

  • REST versioning / deprecation policyPartial (67%)

    API versioning found (URL versioning (servers or paths)) but no deprecation or sunset policy detected - add Sunset/Deprecation headers or a deprecation policy page

    Recommendation

    Declare a versioning policy agents can rely on: version your API (in the URL path or a version header) and publish how you signal deprecation (a Sunset/Deprecation header or a documented timeline). Agents avoid integrating against a surface that can change without warning.

  • CLI tool availableFailed

    No CLI tool found

    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.

  • REST response schema coveragePassed

    83% of operations define typed response schemas, 83% use application/json

    Recommendation

    Define typed JSON response schemas for every endpoint in your OpenAPI spec. Agents rely on these to know what fields they will get back; missing or partial schemas force trial-and-error.

  • API schema complexity analysisPartial (50%)

    REST: schema found (36 operations) but missing operationIds

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

    Partial compatibility: 0/36 operationIds, 34/36 typed schemas

    Recommendation

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

Bonus signals11 positive · +2.5 points
  • ChatGPT app listedPassed

    Found in ChatGPT app directory: "Faire Wholesale"

    Recommendation

    Submit your app to the ChatGPT apps / connectors directory (the apps-in-ChatGPT surface) so ChatGPT users can discover and use your product.

  • MCP well-known discoveryPartial (50%)

    MCP server at https://mcp.faire.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.

  • Agent mode viewPassed

    Rich agent mode view at ?mode=agent with 5 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.

  • Sitemap freshness (lastmod)Passed

    100% of 25 sampled sitemap entries carry lastmod; newest is 5 day(s) old

    Recommendation

    Add dates (W3C datetime, e.g. 2026-08-01) to your sitemap entries and update them when content actually changes. Aim for lastmod on at least half your entries with the newest within the last year. Verify with curl https://yourdomain.com/sitemap.xml | grep lastmod.

  • 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.

  • REST pagination patternPassed

    Cursor-based pagination found in OpenAPI spec response schemas or query parameters

    Recommendation

    Use a consistent, documented pagination shape on your list endpoints (cursor-based preferred) and define the pagination fields in your OpenAPI response schemas, so agents can page through results without guessing the shape.

  • REST batch / bulk endpointPassed

    Batch endpoint found in OpenAPI spec (/batch path)

    Recommendation

    Offer a batch endpoint that accepts an array of operations in one request, documented in your spec, so an agent acting on many items can do it in bulk instead of looping one call at a time.

  • Native interactive controlsPassed

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

  • Accessible names on controlsPassed

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

  • Form control labelingPassed

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

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-22T06-41-13-772Z