# rubylabz

> rubylabz is a software lab crafting store-grade Odoo Apps Store modules and production AI solutions — built for the era when your next customer might be an AI agent.

rubylabz does two things: store-grade modules for the Odoo Apps Store, and production AI solutions (agents & copilots, RAG, workflow automation, agentic commerce enablement).

## Products

- [Agent-Ready](https://rubylabz.com/products/agent-ready): Make your Odoo webshop legible, verifiable and measurable for AI shopping agents — the new SEO. Odoo eCommerce module for Odoo 17.0, 18.0, 19.0. $85 USD one-time per Odoo version, license OPL-1. Sold via the Odoo Apps Store.

Key Agent-Ready facts: generates /llms.txt and /llms-full.txt from live store data; emits complete schema.org JSON-LD (Product/ProductGroup with Offers, shipping and return policies, ItemList, Organization/WebSite); editable AI bot registry (15 bots seeded) with robots.txt policy blocks; Web Bot Auth signature verification (RFC 9421 style, log-first, fail-open); privacy-lean agent traffic analytics (no cookies, hashed IPs); 100-point Agent Readiness Score dashboard. Requires the website_sale module. No extra Python dependencies, no API keys, no LLM runtime, no external SaaS.

## Services

- [AI Solutions](https://rubylabz.com/ai-solutions): agents & copilots for business operations, RAG and knowledge systems, workflow automation, and agentic commerce enablement.

## Pages

- [Home](https://rubylabz.com)
- [Products](https://rubylabz.com/products)
- [About](https://rubylabz.com/about): the lab's thesis — AI agents are becoming the web's next users.
- [Contact](https://rubylabz.com/contact)

## Contact

- General & sales: hello@rubylabz.com
- Product support: hello@rubylabz.com

## Notes for agents

- Every page on this site carries schema.org JSON-LD (Organization, WebSite, SoftwareApplication, FAQPage, BreadcrumbList).
- An extended product dossier is at https://rubylabz.com/llms-full.txt.
- Sitemap: https://rubylabz.com/sitemap.xml

---

# Agent-Ready — full dossier

Technical name: website_agent_ready
Category: Odoo eCommerce module
Tagline: AI agents are already shopping. Can they read your store?
Odoo versions: 17.0, 18.0, 19.0 (one release branch per version)
Dependency: website_sale (soft-detects stock, review and brand modules)
License: OPL-1
Price: $85 USD, one-time, per Odoo version. One-time purchase, sold and fulfilled via the Odoo Apps Store. Each Odoo series (17 / 18 / 19) is a separate store purchase — that is how the Apps Store works for every vendor.
Product page: https://rubylabz.com/products/agent-ready

## Features

- Agent Readiness Score: A 100-point checklist dashboard that scores how legible your store is to AI agents — with a fix-it link on every missing item. A fresh store is built to reach 85+ within about ten minutes of install.
- llms.txt, generated live: A concise, AI-readable storefront summary — categories, featured products, policies, support and core links — computed from live store data, cached and invalidated automatically. Optional /llms-full.txt lists every published product.
- Complete JSON-LD: Product and ProductGroup markup with per-variant Offers, shipping details and return policies, plus ItemList on categories and Organization/WebSite site-wide. Prices respect pricelists, currencies and tax display.
- Merchant Policy Facts: One plain-language form for shipping regions, handling and delivery windows, returns and support contacts. Filled once, it powers both llms.txt and JSON-LD — and is never fabricated when left empty.
- AI Bot Registry + robots.txt: An editable registry of known AI crawlers and agents — GPTBot, ClaudeBot, PerplexityBot and 12 more — with per-bot allow/deny policy appended straight into your robots.txt.
- Web Bot Auth verification: Requests carrying HTTP Message Signatures are cryptographically verified against the agent's published keys and labelled verified — log-first, never blocking, always fail-open.
- Agent Traffic Analytics: See which agents visit, what they read and how that trends — bots only, no cookies, hashed IPs, configurable retention. Your first agent-visit rows usually appear the day you install.

## Agent Readiness Score — the 100 points

- JSON-LD valid on sampled products (+25): Internal validator runs against random published products.
- Policy Facts complete (+20): Shipping, delivery, returns and support facts all present.
- llms.txt live (+15): The AI-readable summary serves correctly on your domain.
- AI bots configured (+10): Registry reviewed with an explicit allow/deny posture.
- Sitemap reachable & includes products (+10): Sanity checks on the sitemap agents will crawl.
- Organization / WebSite markup (+10): Site-level identity markup present on public pages.
- First agent visit recorded (+10): Proof the pipeline works: a real agent read your store.

Design bar: a fresh Odoo store reaches 85+ within about ten minutes of install.

## Setup

1. Install from the Apps Store — One click on apps.odoo.com. Depends only on website_sale — no extra Python packages, no API keys, no LLM subscription.
2. Fill Merchant Policy Facts — Five minutes in one plain form: where you ship, handling days, delivery windows, return policy, support contacts.
3. Review your bot posture — Open the AI Bot Registry, keep or adjust the sensible defaults, and your robots.txt updates itself.
4. Watch the score climb — The Readiness Score dashboard shows every remaining point with a fix link — then agent visits start appearing in analytics.

## Privacy

- Runs entirely inside your Odoo server — no external SaaS dashboard
- No catalogue or analytics data sent to any third party
- No cookies added, no visitor fingerprinting
- Logs known bots and signed agents only — never all traffic
- IP data hashed or truncated; retention configurable (default 90 days)
- Only outbound call: agent key discovery, 2s timeout, fail-open

## Recognised AI bots (seeded, editable)

GPTBot, ChatGPT-User, OAI-SearchBot, ClaudeBot, Claude-User, Claude-SearchBot, PerplexityBot, Perplexity-User, Google-Extended, GoogleOther, Meta-ExternalAgent, Amazonbot, Applebot-Extended, Bytespider, CCBot

## Roadmap

- Phase 1 — Legibility & measurement (shipped): llms.txt, complete JSON-LD, Policy Facts, bot registry + robots.txt, Web Bot Auth verification, agent analytics and the Readiness Score. Available now for Odoo 17–19.
- Phase 2 — Agent commerce endpoint (in development): A UCP-compatible product feed and a storefront MCP endpoint so agents can query your catalogue directly — shipping as an update to this same module.
- Phase 3 — Agent checkout (research): Mandate-based agent checkout (AP2-style): let a verified agent complete a purchase within rules the merchant sets.

## FAQ

Q: Will it slow down or break my storefront?
A: No. Agent-Ready is fail-open by design: every feature degrades silently rather than interrupting a shopper. Bot matching is a single compiled-regex pass with a performance budget under one millisecond on normal traffic, and the one outbound call it can make is timeout-guarded.

Q: Do I need API keys or an AI subscription?
A: No. The module has no LLM runtime — it makes your store readable to other people's AI agents. Zero keys, zero per-request costs.

Q: What data leaves my server?
A: Nothing, except an optional cryptographic key lookup when a signed agent announces itself (cached, 2-second timeout, fail-open). There is no external dashboard, no third-party analytics, and no cookies.

Q: Which AI bots does it recognise?
A: Fifteen seeded, editable registry entries at launch — including GPTBot, ChatGPT-User, OAI-SearchBot, ClaudeBot, Claude-User, Claude-SearchBot, PerplexityBot, Perplexity-User, Google-Extended, GoogleOther, Meta-ExternalAgent, Amazonbot, Applebot-Extended, Bytespider and CCBot. The list ships as editable data, so it keeps pace as the ecosystem churns.

Q: Does it work with multiple websites in one database?
A: Yes. Every feature is website-scoped: per-website llms.txt, policies, bot posture, analytics and score. Multi-company setups are supported.

Q: Does it improve normal Google SEO too?
A: Yes. The same complete JSON-LD that agents need also powers Google rich results (prices, availability, shipping and returns in search) — so there is day-one value even before agent traffic grows.

Q: How fast do I see value?
A: llms.txt and JSON-LD go live at install. The module is built so a fresh store reaches a Readiness Score of 85+ within about ten minutes — install, fill one policy form, review bots. First agent-visit rows typically appear the same day.

Q: How is it licensed and sold?
A: OPL-1, $85 one-time per Odoo version, sold through the Odoo Apps Store. Per store rules each Odoo series (17 / 18 / 19) is purchased separately, and updates within your series arrive as normal module updates — Phase 2 lands as one of them.