# ORBEXA 知识库 / ORBEXA Knowledge Base

## Docs

- [How AI agents are changing online shopping](https://learn.orbexa.io/en/book-1/ch1-ai-agents-changing-shopping.md): What is AI agent shopping and why might your products be invisible to AI? Understand the major shift happening in e-commerce right now.
- [How AI agents decide which stores to trust](https://learn.orbexa.io/en/book-1/ch2-trust-mechanism.md): Learn about the background check AI agents run before recommending your store — the six-dimension trust score and trust badge system.
- [Three things every store must do for AI](https://learn.orbexa.io/en/book-1/ch3-three-essentials.md): Structured data, llms.txt, and Sitemaps — understanding the three essential foundations of AI discoverability through everyday analogies.
- [Commerce protocols: UCP, ACP, and MCP overview](https://learn.orbexa.io/en/book-1/ch4-commerce-protocols.md): Plain-language explanation of UCP, ACP, and MCP commerce protocols — how AI agents browse products, place orders, and act as sales assistants
- [Shopify merchant AI agent setup guide](https://learn.orbexa.io/en/book-1/ch5-shopify.md): The complete guide for Shopify merchants to become AI-agent ready — from auditing your current state to optimizing your trust score
- [WooCommerce merchant AI agent setup guide](https://learn.orbexa.io/en/book-1/ch6-woocommerce.md): Step-by-step AI agent commerce setup for WooCommerce merchants — plugin configuration, structured data, llms.txt, and trust signal integration on WordPress.
- [Custom-built site AI agent setup guide](https://learn.orbexa.io/en/book-1/ch7-custom-site.md): Minimum requirements for making custom-built e-commerce sites discoverable by AI agents — structured data, llms.txt, and trust signals.
- [AI commerce real-world case studies](https://learn.orbexa.io/en/book-1/ch8-case-studies.md): AI trust score case studies with publicly verifiable data from over 3,200,000+ domains — real merchant scores, optimization paths, and results.
- [Getting Started with AI Agent Commerce](https://learn.orbexa.io/en/book-1/index.md): How your products get discovered and recommended by AI shopping agents — a plain-language guide for non-technical e-commerce merchants.
- [Why AI agents need a trust verification layer](https://learn.orbexa.io/en/book-2/ch1-why-trust-layer.md): The trust dilemma facing AI agents in commerce — why existing trust mechanisms fall short and how OTR solves the verification problem.
- [How to improve your OTR trust score](https://learn.orbexa.io/en/book-2/ch10-improve-score.md): A dimension-by-dimension guide to raising your OTR trust score — actionable steps for each signal on the complete path from UNRATED to PLATINUM tier.
- [OTR-ID lifecycle and status management](https://learn.orbexa.io/en/book-2/ch11-otr-id.md): The complete lifecycle of OTR domain identifiers — creation, status transitions, revocation, and recovery across commerce and non-commerce sites.
- [OTR trust scoring case studies](https://learn.orbexa.io/en/book-2/ch12-case-studies.md): Real-world applications of OTR trust scoring — case studies covering AI agent recommendations, supply chain assessment, and brand monitoring.
- [OTR protocol technical reference](https://learn.orbexa.io/en/book-2/ch13-reference.md): Complete technical reference for the OTR protocol — full signal inventory, weight tables, status codes, error codes, and version changelog.
- [OTR four-layer architecture overview](https://learn.orbexa.io/en/book-2/ch2-architecture.md): OTR's four-layer architecture explained in detail — Signal Collection, Scoring Engine, ID Generation, and Verification API components.
- [OTR verification and security signal dimensions](https://learn.orbexa.io/en/book-2/ch3-verification-signals.md): The first two dimensions of OTR trust scoring explained — complete technical analysis of 13 verification and 15 security signals with data sources.
- [OTR governance, transparency, and data quality](https://learn.orbexa.io/en/book-2/ch4-governance-transparency-data.md): The three auto-assessed OTR dimensions — technical breakdown of 10 governance, 18 transparency, and 21 data quality trust signals with weight rules.
- [OTR scoring engine and weight formulas](https://learn.orbexa.io/en/book-2/ch5-scoring-engine.md): How OTR calculates trust scores — three scoring modes (COLD Ecommerce, COLD SaaS, AUTH), site classification, badge tiers, and rescan triggers.
- [OTR trust verification REST API reference](https://learn.orbexa.io/en/book-2/ch6-rest-api.md): Complete technical documentation for the OTR trust verification API — endpoints, request format, response structure, and integration examples
- [OTR MCP Server for AI trust queries](https://learn.orbexa.io/en/book-2/ch7-mcp-server.md): Enable AI agents to invoke OTR trust queries directly via the MCP protocol — MCP Server architecture, setup, and integration guide.
- [OTR OpenAPI 3.0 specification and SDK generation](https://learn.orbexa.io/en/book-2/ch8-openapi-spec.md): The OpenAPI 3.0 specification for the OTR verification API — endpoint definitions, data models, SDK generation, and usage examples.
- [AI agent OTR integration patterns](https://learn.orbexa.io/en/book-2/ch9-agent-integration.md): Technical patterns for integrating OTR trust queries into AI agents — recommendation workflows, caching strategies, and multi-dimensional evaluation
- [OTR Open Trust Registry](https://learn.orbexa.io/en/book-2/index.md): The trust layer for agentic commerce — OTR five-dimension scoring methodology, 77 signal references, REST API documentation, and integration guide.
- [UCP protocol architecture and core concepts](https://learn.orbexa.io/en/book-3/ch1-core-concepts.md): UCP protocol architecture in depth — namespace governance, four core capabilities, UCP Profile, capability negotiation, and transport.
- [UCP case studies and extension mechanisms](https://learn.orbexa.io/en/book-3/ch10-case-studies.md): UCP extension mechanisms (Buyer Consent, AP2 Mandate), real-world integration paths, and case studies for merchants of different scales
- [UCP checkout API and state machine](https://learn.orbexa.io/en/book-3/ch2-checkout.md): Complete technical documentation for UCP checkout — 6 states, 5 operations, ISO 4217 amounts, embedded UI, and state machine details
- [UCP identity linking with OAuth 2.0](https://learn.orbexa.io/en/book-3/ch3-identity.md): UCP identity linking mechanism — OAuth 2.0 Authorization Code flow, authorization server discovery, scope specification, and token revocation (RFC 7009)
- [UCP order management and fulfillment events](https://learn.orbexa.io/en/book-3/ch4-orders.md): UCP order management capability — line item status, fulfillment events, adjustments, Webhook signatures (RFC 9421), and order lifecycle
- [UCP product data format and transport methods](https://learn.orbexa.io/en/book-3/ch5-product-data.md): UCP product data format and four transport mechanisms — REST/OpenAPI, MCP/OpenRPC catalog tools, A2A Agent Card, and Embedded transport
- [UCP security model and authentication methods](https://learn.orbexa.io/en/book-3/ch6-security.md): UCP security model — API Keys, OAuth 2.0, mTLS, HTTP Message Signatures (RFC 9421), JWK signing keys, and Content-Digest (RFC 9530)
- [UCP merchant integration step-by-step guide](https://learn.orbexa.io/en/book-3/ch7-merchant-integration.md): Getting started with UCP from scratch — deploying /.well-known/ucp Profile, declaring capabilities, configuring signing keys, and phased implementation
- [UCP platform integration and multi-merchant hosting](https://learn.orbexa.io/en/book-3/ch8-platform-integration.md): E-commerce platform UCP integration — capability negotiation, namespace management, multi-merchant hosting, and implementation paths.
- [UCP endpoint testing and compliance validation](https://learn.orbexa.io/en/book-3/ch9-testing.md): UCP endpoint testing methods — Profile compliance validation, checkout flow testing, signature verification, security checks, and performance benchmarks
- [UCP Universal Commerce Protocol](https://learn.orbexa.io/en/book-3/index.md): Technical guide to UCP, the open commerce protocol by Google, Shopify, and others — product discovery, checkout, and order management.
- [ACP protocol architecture and core concepts](https://learn.orbexa.io/en/book-4/ch1-core-concepts.md): ACP protocol architecture explained — four-party model, two independent systems, Checkout state machine, and Delegate Payment flow.
- [ACP product data object field specification](https://learn.orbexa.io/en/book-4/ch2-product-data.md): ACP Product object complete field specification — detailed reference for Product, Variant, Price, Media, Availability, and Category fields.
- [ACP file upload via SFTP integration guide](https://learn.orbexa.io/en/book-4/ch3-file-upload.md): ACP file upload integration guide — SFTP push specifications, supported file formats, sharding strategy, and Feed Header configuration.
- [ACP product feed REST API reference](https://learn.orbexa.io/en/book-4/ch4-api.md): ACP Product Feed REST API complete reference — Feeds, Products, and Promotions endpoints with request examples and response schemas.
- [ACP promotions and discount configuration](https://learn.orbexa.io/en/book-4/ch5-promotions.md): ACP Promotion object specification — how to configure discount types, active periods, and product targeting rules for AI agent commerce.
- [ACP product data quality best practices](https://learn.orbexa.io/en/book-4/ch6-data-quality.md): ACP product data quality standards — best practices for ID stability, URL conventions, prohibited content rules, and feed optimization.
- [ACP product data testing and validation](https://learn.orbexa.io/en/book-4/ch7-testing.md): ACP product data validation workflow — small-batch testing, format verification, common error troubleshooting, and integration checks.
- [ACP integration frequently asked questions](https://learn.orbexa.io/en/book-4/ch8-faq.md): ACP integration FAQ — answers to common questions about the application process, technical requirements, payment security, and data management.
- [ACP Agentic Commerce Protocol](https://learn.orbexa.io/en/book-4/index.md): Complete guide to ACP, the open standard by Stripe for AI agentic commerce — Product Feed integration, Checkout API, and Delegate Payment flow.
- [MCP protocol architecture and core concepts](https://learn.orbexa.io/en/book-5/ch1-core-concepts.md): Model Context Protocol architecture explained — Host/Client/Server roles, protocol lifecycle, capability negotiation, and all primitives
- [MCP Server real-world commerce case studies](https://learn.orbexa.io/en/book-5/ch10-case-studies.md): MCP Server real-world case studies — e-commerce customer service, supply chain queries, multi-store management, and OTR trust integration
- [MCP data layer and JSON-RPC 2.0 messages](https://learn.orbexa.io/en/book-5/ch2-data-layer.md): MCP data layer explained — JSON-RPC 2.0 message format, capability negotiation, Server/Client primitives, error handling, and content types
- [MCP transport layer: stdio and Streamable HTTP](https://learn.orbexa.io/en/book-5/ch3-transport.md): MCP transport layer explained — stdio local transport, Streamable HTTP remote transport, deprecated HTTP+SSE, and OAuth 2.1 authentication
- [Building an MCP Server in TypeScript or Python](https://learn.orbexa.io/en/book-5/ch4-build-server.md): Build an MCP Server from scratch — complete TypeScript and Python development guide, including outputSchema, structuredContent, Streamable HTTP, and debugging
- [Commerce MCP Server design patterns](https://learn.orbexa.io/en/book-5/ch5-commerce-server.md): MCP Server design patterns for e-commerce — product search, inventory queries, order management, return processing, and OTR trust queries
- [MCP resources and prompt templates](https://learn.orbexa.io/en/book-5/ch6-resources-prompts.md): Deep dive into MCP Resources and Prompts — URI templates, Annotations, resource subscriptions, parameterized prompts, and usage patterns.
- [MCP security model and OAuth 2.1 integration](https://learn.orbexa.io/en/book-5/ch7-security.md): MCP security model — OAuth 2.1 integration, PKCE, RFC specification references, permission management, transport security, and data privacy
- [MCP Server testing and debugging techniques](https://learn.orbexa.io/en/book-5/ch8-testing.md): Complete MCP Server testing guide — MCP Inspector, unit tests, integration tests, protocol compliance verification, and common debugging techniques
- [MCP Server deployment and scaling strategies](https://learn.orbexa.io/en/book-5/ch9-deployment.md): MCP Server deployment strategies — local npm package publishing, remote Streamable HTTP deployment, Docker containerization, session management, and scaling
- [MCP — Model Context Protocol](https://learn.orbexa.io/en/book-5/index.md): The standard protocol for connecting AI applications to external tools and data — complete architecture analysis, development guide, and commerce applications
- [AI-SEO vs traditional SEO: key differences](https://learn.orbexa.io/en/book-6/ch1-ai-seo-vs-traditional.md): Search engine crawlers and AI agent crawlers work in fundamentally different ways — understand the key differences and what they mean for SEO.
- [Business identity and domain credibility](https://learn.orbexa.io/en/book-6/ch10-business-identity.md): LEI registration, business verification, and domain credibility — practical methods for improving your OTR verification and governance scores.
- [AI trust score as an AI-SEO performance metric](https://learn.orbexa.io/en/book-6/ch11-trust-score-as-metric.md): How to measure AI-SEO effectiveness with trust scores — transitioning from traditional SEO metrics to a new measurement framework for AI.
- [AI-SEO tools and monitoring dashboards](https://learn.orbexa.io/en/book-6/ch12-tools-dashboard.md): The AI-SEO tool landscape — from free utilities to professional platforms, covering diagnostics, monitoring, and optimization workflows.
- [Monthly AI-SEO optimization checklist](https://learn.orbexa.io/en/book-6/ch13-monthly-checklist.md): Essential monthly AI-SEO maintenance tasks — a systematic checklist covering technical audits, content updates, and trust signal monitoring.
- [AI-SEO optimization case studies](https://learn.orbexa.io/en/book-6/ch14-case-studies.md): Real-world AI-SEO optimization case studies — optimization paths for different site types, before-and-after performance data, and lessons.
- [Technical infrastructure for AI trust signals](https://learn.orbexa.io/en/book-6/ch2-technical-infrastructure.md): Before AI agents evaluate your products, they inspect your technical foundation — complete configuration guide for SSL, DNSSEC, DMARC, and HSTS
- [Schema.org structured data for AI agents](https://learn.orbexa.io/en/book-6/ch3-schema-org.md): A complete guide to Schema.org structured data markup — making AI agents accurately understand your products, company, and web content.
- [JSON-LD vs Microdata: format comparison](https://learn.orbexa.io/en/book-6/ch4-jsonld-vs-microdata.md): Technical comparison of JSON-LD and Microdata structured data formats — selection guide and step-by-step Microdata-to-JSON-LD migration.
- [robots.txt optimization for AI crawlers](https://learn.orbexa.io/en/book-6/ch5-robots-txt.md): How to control AI crawler access — complete robots.txt configuration guide covering traditional search engines and AI agent crawlers.
- [llms.txt writing guide for AI discoverability](https://learn.orbexa.io/en/book-6/ch6-llms-txt.md): How to write your company's briefing for AI agents — llms.txt specification, writing templates, best practices, and real-world examples.
- [agent.json service declaration guide](https://learn.orbexa.io/en/book-6/ch7-agent-json.md): How to tell AI agents what interaction capabilities you support — agent.json specification, field reference, and deployment guide.
- [Sitemap optimization for AI crawlers](https://learn.orbexa.io/en/book-6/ch8-sitemap.md): Helping AI crawlers efficiently discover all your pages — Sitemap structure, sharding strategies, and e-commerce-specific optimizations
- [Policy page quality and AI trust assessment](https://learn.orbexa.io/en/book-6/ch9-policy-quality.md): How privacy and return policies affect AI trust assessments — writing standards and quality evaluation dimensions for policy pages
- [SEO for AI — Make AI Agents Discover You](https://learn.orbexa.io/en/book-6/index.md): Beyond traditional SEO — a complete, hands-on AI-SEO guide covering structured data, AI discoverability, and trust signal optimization
- [ORBEXA platform architecture overview](https://learn.orbexa.io/en/book-7/ch1-architecture.md): How ORBEXA automatically deploys AI agentic commerce infrastructure for every merchant — platform architecture, data flow, and component overview.
- [ORBEXA troubleshooting and error resolution](https://learn.orbexa.io/en/book-7/ch10-troubleshooting.md): Common issues and solutions — API errors, authentication, webhooks, sync failures, OTR scans, domain verification, and data import.
- [ORBEXA Shopify integration guide](https://learn.orbexa.io/en/book-7/ch2-shopify.md): ORBEXA Shopify integration guide — OAuth authorization flow, automatic product sync, Webhook event handling, and field data mapping.
- [ORBEXA WooCommerce integration guide](https://learn.orbexa.io/en/book-7/ch3-woocommerce.md): ORBEXA WooCommerce integration — plugin installation, API connection, three-way product/order/inventory sync, and Webhook configuration.
- [ORBEXA WordPress plugin integration guide](https://learn.orbexa.io/en/book-7/ch4-wordpress.md): ORBEXA WordPress plugin integration — one-click connection, automatic merchant account creation, API key provisioning, and setup guide.
- [ORBEXA API and database integration guide](https://learn.orbexa.io/en/book-7/ch5-api.md): ORBEXA API and database integration guide — CSV import, ETL pipeline, visual scraping, and waterfall data ingestion for custom platforms.
- [ORBEXA MCP Server tools and resources](https://learn.orbexa.io/en/book-7/ch6-mcp-server.md): ORBEXA MCP Server with 5 tools and 3 resources — how AI agents directly query product catalogs, inventory levels, and trust scores in real time.
- [ORBEXA AI data cleaning and quality pipeline](https://learn.orbexa.io/en/book-7/ch7-data-quality.md): ORBEXA AI Refinery Pipeline — automatic field mapping, description optimization, visual attribute extraction, and flywheel learning.
- [ORBEXA API reference and rate limiting](https://learn.orbexa.io/en/book-7/ch8-api-reference.md): Complete ORBEXA API endpoint catalog — authentication methods, rate limiting policies, request examples, and error handling reference.
- [ORBEXA merchant dashboard overview](https://learn.orbexa.io/en/book-7/ch9-dashboard.md): Overview of ORBEXA dashboard features — KPI monitoring, integration management, data quality, sync logs, team members, and settings.
- [ORBEXA Integrated Solution](https://learn.orbexa.io/en/book-7/index.md): ORBEXA handles UCP/ACP/MCP protocol compliance automatically — product data cleaning, protocol endpoint deployment, and AI discoverability setup.
- [Glossary](https://learn.orbexa.io/en/glossary/index.md): Comprehensive glossary of agentic commerce terminology — covering UCP, ACP, MCP, OTR protocols and related technical standards in detail.
- [ORBEXA Learn — AI Agent Commerce Knowledge Base](https://learn.orbexa.io/en/index.md): The definitive knowledge base for AI agent commerce. Learn how to make your products discoverable, trusted, and purchasable by AI agents.
- [Full-stack developer guide to AI commerce APIs](https://learn.orbexa.io/en/paths/developer.md): Developer learning path — go from OTR API integration to full UCP/ACP/MCP protocol implementation in about 2 hours of hands-on work.
- [Merchant quick start for AI agent commerce](https://learn.orbexa.io/en/paths/merchant.md): Merchant quick start path — 30 minutes of reading plus 1-2 hours of hands-on work to make your products discoverable by AI agents.
- [AI-SEO practitioner guide to trust signals](https://learn.orbexa.io/en/paths/seo.md): AI-SEO learning path — master structured data, llms.txt, trust signals, and the new SEO skills required for the AI era in about 1 hour.
- [5-Minute Quick Start](https://learn.orbexa.io/en/quick-start/index.md): Check your AI trust score, choose a learning path, and start making your e-commerce products visible to AI agents in under five minutes.
- [AI Prompt Templates](https://learn.orbexa.io/en/templates/ai-prompts.md): Professional AI prompt templates — use your own ChatGPT or Claude to complete structured data, llms.txt, and commerce integration work.
- [Configuration Templates](https://learn.orbexa.io/en/templates/config-templates.md): Ready-to-use configuration templates for AI agent commerce — copy-paste llms.txt, agent.json, Schema.org, robots.txt, and sitemap examples.
- [Templates & Prompts](https://learn.orbexa.io/en/templates/index.md): Ready-to-use configuration templates and AI prompts — complete all agentic commerce integration tasks using your own AI assistant.

## OpenAPI Specs

- [openapi](https://learn.orbexa.io/api-reference/openapi.json)