Scan Results: https://ai.google.dev/gemini-api/docs
ID: 48dd3332-ab87-428b-b915-be8a9cec180a
Legacy Docs (Invisible)
Invisible to AI agents. Severe context noise, non-functional code, or zero discoverable specifications.
Category Breakdown
Detailed Findings
Context Optimization
llms.txt Auto-Discovery
Create an llms.txt file at the root of my documentation site. Place it at: [domain]/llms.txt Structure it exactly as follows: Line 1: # [Product Name] Line 2: Blank line Line 3: One paragraph summary of what the product does and who it's for. Line 4: Blank line Line 5: ## Technical Constraints - Rate limits - Authentication requirements - SDK language support - Known limitations Line 6: Blank line Line 7: ## Key Documentation - [URL]: [one-line description] (repeat for top 10 most important pages) My docs are at: [URL] My product does: [brief description]
llms-full.txt Consolidated Docs
Create an llms-full.txt file at the root of my documentation site. This should contain the entire documentation merged into a single Markdown file.
Markdown Content Negotiation (Accept: text/markdown)
My documentation is returning excessive HTML to AI agents. Implement server-side content negotiation in my app. When a request includes the header 'Accept: text/markdown', return ONLY the technical content as clean Markdown. Strip completely: navigation menus, footers, cookie banners, sidebar links, breadcrumbs, social sharing buttons, interactive widgets, and any HTML not containing technical content. The response should contain only: - Page title as H1 - Section headings as H2/H3 - Body text - Code blocks with language tags - Parameter tables - No HTML tags, no CSS, no scripts
DOM Cleanliness Ratio (7% markdown/HTML)
Reduce layout boilerplate (header, footers, scripts) or use Markdown Content Negotiation to strip DOM noise.
Code Block Execution
This category was analyzed using structural heuristics. Results reflect your documentation's observable patterns.
Terminal Prompt Pollution (No "$" prefixes in copyable code)
Dependency & Import Completeness (AI Check Fallback)
Dynamic Variable Placeholders (AI Check Fallback)
Use structured placeholders like <YOUR_API_KEY> or process.env.
Machine Readability
OpenAPI/Swagger Spec Auto-Discovery
Expose an OpenAPI or Swagger specification at a standard path (e.g. /openapi.json) or link to it using the "Link" HTTP response header with rel="openapi".
JSON-LD Structured Schema (TechArticle / APIReference / Guide)
Embed a <script type="application/ld+json"> block classifying your docs as a TechArticle, Guide, or APIReference, containing semantically enriched metadata.
Agent Tooling & MCP
Model Context Protocol (MCP) Server Integration
Configure and expose an MCP server definition at /.well-known/mcp.json or publish guidelines showing AI agents how to interact with your APIs using MCP tool declarations.
Error Code Diagnostics & Cross-Referencing Index
Provide a comprehensive table or section listing error codes, their causes, and solutions. This lets agents cross-reference error stacks and resolve integration errors automatically.