converthub.com
Important blockers remain
Task
What does converthub.com do and who is it for? Explain it back to me.
Critical access needs attention
These checks describe whether an ordinary agent can enter, read, and operate the public site.
- 2 / 2 passed
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.
- 3 / 3 passed
Controls are understandable
Forms and interactive controls expose usable names and structure.
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
Ready with gaps
11 of 17 mature checks passed
API
Needs work
4 of 8 mature checks passed
Authentication
Blocked
0 of 3 mature checks passed
Fix these gaps first
Critical access gaps come first, followed by other applicable readiness gaps.
- 01Critical access
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.
- 02Critical access
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. - 03Other readiness checks
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.
- 04Other readiness checks
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.
- 05Other readiness checks
OAuth 2.0 support
Implement OAuth 2.0 for API authentication. Publish your authorization server metadata at /.well-known/oauth-authorization-server.
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 11 passed · 52 / 80 points
- Content without JavaScriptPartial (33%)
Only 6428 chars of text content, no H1 tag - agents see limited content
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.hrefor wait for a meta refresh - they see only the stub page. Verify withcurl -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 (5 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 publishedPartial (71%)
OpenAPI spec (YAML) found at /openapi.yaml
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 "accept-encoding")
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 supportPartial (60%)
OAuth mentioned in documentation at https://converthub.com/auth/google but no OAuth or OpenID Connect endpoint responded
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 responsesPassed
API returns JSON error responses (500 at https://api.converthub.com/orank-probe-test)
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 a real HTTP 404. For full credit, include a short markdown body (site map links, where to look next) so agents can recover.
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.
Recommended10 of 17 passed · 14.7 / 20 points
- Developer resource discoverabilityPassed
Agent discovered 2 developer-resource types by name (developer portal, API docs) across 2 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 discoverabilityPartial (33%)
converthub.com appears once in brand-name search results for "ConvertHub" (position #5 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 existsPassed
Valid sitemap found at https://converthub.com/sitemap.xml with 3158 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 dataPassed
Rich JSON-LD identity: Organization with name, description, url, and sameAs/logo/address (4 block(s))
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
API/docs link found on homepage and resolves: https://converthub.com/api
Recommendation
Publish API documentation at a discoverable URL (/docs, /api, /developers). Include authentication, endpoints, and example requests.
- Agent instruction / when-to-usePassed
When-to-use guidance found in llms.txt
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 completenessPassed
All metadata signals present: canonical URL, lang="en", og:image, og:type
Recommendation
Add all four signals to your homepage: , , , and . Agents use these for entity resolution and attribution.
- Organization schema completenessPartial (50%)
Organization schema found but missing: address
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 6 measured pages fit an agent context budget (largest ~2K 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 -cand remember agents read the extracted text, not the raw HTML. - Code fence validityPassed
Code fences balanced across 1 markdown document
Recommendation
Close every fenced code block (``` or ~~~) in your served markdown. CommonMark treats everything after an unclosed fence as code, so an agent parsing the document silently loses the rest of it. Count fence lines per file - the total must be even.
- Developer portalPassed
Developer portal found at /developers
Recommendation
Create a developer portal at /developers with API keys, documentation, quickstart guides, and a sandbox environment.
- Public API with reachable endpointsPassed
REST API documentation found at https://converthub.com/api. 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%)
Onboarding signals described but not verified live: free tier available, self-serve key generation
Recommendation
Offer a free tier or trial, self-serve API key generation, and a sandbox environment. Agents can't fill out 'contact sales' forms.
- CLI tool availablePartial (67%)
CLI tool mentioned in llms.txt
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 analysisFailed
No API schema detected
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 signals10 positive · +2.1 points
- NPM/PyPI SDK packagePassed
NPM package found: @converthub/sdk - "Official JavaScript SDK for ConvertHub API v2 - Convert files between 800+ formats"
Recommendation
Publish a JavaScript/TypeScript SDK package on npm so developers can integrate your API programmatically. In package.json set
repositoryto your source repo andhomepageto your product domain - these links are how agents confirm the package is your official SDK rather than a third-party tool with a similar name. - ChatGPT app listedPassed
ChatGPT plugin manifest found: "ConvertHub File Converter"
Recommendation
Submit your app to the ChatGPT apps / connectors directory (the apps-in-ChatGPT surface) so ChatGPT users can discover and use your product.
- llms.txt existsPassed
Found the llms.txt at https://converthub.com/llms.txt.
Recommendation
Create an llms.txt file at your domain root (/llms.txt) - the AI equivalent of robots.txt. Write at least 100 characters of real content: what your product is, what it does, and links to your key docs. Then verify it with
curl https://yourdomain.com/llms.txt- you should see your text, not HTML. If your app returns its homepage for every URL (common with single-page apps), add a static file route so the raw text is served. A placeholder with just a heading earns no credit. - llms.txt formattingPartial (50%)
The llms.txt starts with a heading and has 83 lines, but it contains no markdown links.
Recommendation
Format your llms.txt as a navigation index: start with a markdown heading, include markdown links to deeper resources, and keep it under 30,000 characters. If you have more to say, move long-form content into /llms-full.txt or per-section files (e.g. /docs/llms.txt, /api/llms.txt) and link to them from the main index.
- Schema type breadthPartial (50%)
Some extended schema types found: BreadcrumbList, Service - add FAQPage, Service, or AggregateRating for full coverage
Recommendation
Expand your JSON-LD beyond Organization/WebSite. Add FAQPage for common questions, Service or Product for offerings, AggregateRating or Review for social proof, and BreadcrumbList for navigation context.
- Multi-language SDK packagesPartial (33%)
SDK package found only in npm
Recommendation
Publish official SDK packages across multiple language ecosystems (npm, PyPI, Go modules, RubyGems). Auto-generate them from your OpenAPI spec using tools like openapi-generator. For each package set the project URL or homepage to your product domain (package.json
repository/homepage, PyPIHome-Pageorproject_urls, RubyGemshomepage_uri) - this is how agents verify the package is your official SDK. - Accessible document structurePassed
Server HTML is a well-structured document (main=true, landmarks=4/4, h1=1, maxHeadingSkip=2).
- Native interactive controlsPassed
129 native controls, 0 non-native div-soup affordances (100% native).
- Accessible names on controlsPassed
123/128 interactive elements have a computable accessible name (96%).
- 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-24T17-09-12-382Z