build-seller-agent

What problem does it solve?

Building a compliant, testable seller agent for the Ad Context Protocol requires implementing many coordinated tools, validating strict request/response schemas, handling synchronous and asynchronous flows, and supporting deterministic testing; this Skill consolidates guidance, response builders, and common pitfalls so engineers can deliver a correct seller implementation quickly.

Core Features & Use Cases

• Capabilities registration: register get_adcp_capabilities as the first tool and advertise supported protocols.
• Product and pricing management: implement get_products with publisher_properties, format_ids, delivery_type, and pricing_options.
• Media buy lifecycle: validate create_media_buy requests, return appropriate mediaBuy responses or adcpError for business validation, and surface get_media_buys and delivery reporting.
• Creative and catalog workflows: support list_creative_formats, sync_creatives, and catalog-driven creative management for retail media.
• Approval and testing: implement guaranteed vs non-guaranteed approval flows, optional registerTestController for deterministic compliance testing and storyboards.
• Use Case: create a sandbox seller that serves premium homepage inventory with CPM pricing, accepts guaranteed IOs with human approval flows, and passes storyboard validation.

Quick Start

Create a TypeScript seller agent that registers get_adcp_capabilities first, implements sync_accounts, get_products, create_media_buy and get_media_buys with sandboxed responses, validates shapes, and exposes a test controller for compliance testing.