Skip to content

vidiq.com

Agents are likely to struggle

What should the prompt cover?

15 findings · 5 selected

Failures (12)

Warnings (3)

Task

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

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

4%

0 of 12 mature checks passed

Authentication

Blocked

33%

1 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

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

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

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

    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

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.

Essential1 of 6 passed · 13.3 / 80 points
  • Content without JavaScriptFailed

    Homepage blocked by WAF/security challenge - content not accessible to agents

    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, ClaudeBot, 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.

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

  • OAuth 2.0 supportPassed

    OpenID Connect discovery endpoint found at https://mcp.vidiq.com

    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.

Recommended0 of 10 passed · 2.7 / 20 points
  • Developer resource discoverabilityPartial (17%)

    Agent struggled to find developer resources by name - only 1 result(s) out of 10. Not searchable: MCP server. Not found via search: API docs, OpenAPI spec, developer portal, auth docs

    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 discoverabilityPartial (33%)

    vidiq.com appears once in brand-name search results for "vidiq" (position #7 out of 7)

    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

    Homepage blocked by WAF - cannot check structured data

    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.

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

    Homepage blocked by WAF - cannot check metadata

    Recommendation

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

  • Organization schema completenessFailed

    Homepage blocked by WAF - cannot check Organization schema

    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.

  • Agent onboarding frictionFailed

    High onboarding friction - no free tier, self-serve keys, or sandbox detected

    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.vidiq.com/mcp 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.

Bonus signals8 positive · +1.9 points
  • Wikipedia / Wikidata entity presencePassed

    Wikipedia "VidIQ" and Wikidata Q104857574 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.

  • ChatGPT app listedPassed

    Found in ChatGPT app directory: "vidIQ"

    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.vidiq.com/mcp - 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.

  • MCP auth mechanismPassed

    product MCP requires authentication with OAuth metadata discovery

    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.

  • MCP OAuth metadataPassed

    RFC 8414 OAuth metadata for product MCP: issuer=https://mcp.vidiq.com/mcp, auth and token endpoints present

    Recommendation

    Publish RFC 8414 authorization server metadata with issuer, authorization_endpoint, and token_endpoint so agents can authenticate without hardcoded URLs.

  • MCP PKCE S256 supportPassed

    OAuth metadata for product MCP supports PKCE S256 code challenge

    Recommendation

    Support PKCE with S256 code challenge method in your OAuth server. Add 'S256' to code_challenge_methods_supported in your authorization server metadata.

  • OAuth Protected Resource metadata (RFC 9728)Passed

    RFC 9728 protected resource metadata found on MCP origin (resource=https://mcp.vidiq.com/mcp)

    Recommendation

    Publish RFC 9728 protected-resource metadata at /.well-known/oauth-protected-resource. Include the resource field plus enough supporting metadata - your authorization servers, supported scopes, accepted bearer methods - that an agent can work out how to authenticate without first triggering a 401.

  • Agent auth WWW-Authenticate hintPassed

    401 at https://mcp.vidiq.com at /mcp with spec-shaped WWW-Authenticate hint: Bearer resource_metadata="https://mcp.vidiq.com/.well-known/oauth-protected-resource"

    Recommendation

    Return a 401 carrying a spec-shaped WWW-Authenticate: Bearer resource_metadata="<your protected-resource metadata URL>" header on your API's primary entry points, so an agent learns your auth requirements from one request instead of hunting for the well-known document. Point the metadata URL at /.well-known/oauth-protected-resource on the host that serves the API. Spec: https://workos.com/auth-md.

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-24T06-23-05-349Z